Metadata-Version: 2.5
Name: dalalos-mcp
Version: 0.1.0
Summary: Connect Claude, ChatGPT, Cursor or any MCP client to DalalOS, the hosted MCP server for Indian NSE/BSE stock research.
Project-URL: Homepage, https://dalalos.in
Project-URL: Documentation, https://dalalos.in/connect
Project-URL: Repository, https://github.com/BeyondNoww/DalalOS-Indian-Stock-Research
Project-URL: Tool reference, https://dalalos.in/tools
Author-email: DalalOS <atharva@dalalos.in>
License-Expression: MIT
License-File: LICENSE
Keywords: bse,chatgpt,claude,cursor,indian-stock-market,mcp,model-context-protocol,nse,remote-mcp,stock-research
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business :: Financial :: Investment
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# dalalos-mcp

[DalalOS](https://dalalos.in) is a hosted Model Context Protocol (MCP) server that gives AI assistants sourced, filing-grounded Indian (NSE/BSE) stock-market data. Every response carries its source and freshness date. DalalOS returns sourced facts and mechanical measures, never buy/sell calls or target prices, and is not investment advice.

This package is a small helper. **The server runs at `https://mcp.dalalos.in/mcp`** (streamable HTTP, OAuth sign-in in the browser, free tier, no card). Nothing here runs a local server or stores credentials.

```bash
pip install dalalos-mcp
dalalos-mcp config claude-code   # print the connection snippet for a client
dalalos-mcp check                # confirm the hosted endpoint answers
dalalos-mcp tools                # list the tool names it advertises
```

Clients for `config`: `claude`, `claude-code`, `codex`, `chatgpt`, `cursor`, `generic`.

## Connect

### Claude

Settings -> Connectors -> Add custom connector -> paste `https://mcp.dalalos.in/mcp` -> Connect, then sign in.

### Claude Code

```bash
claude mcp add --transport http dalalos https://mcp.dalalos.in/mcp
```

### ChatGPT

Install the published DalalOS plugin (India): https://chatgpt.com/plugins/plugin_asdk_app_6aded6de90f081918717da5227322e16 . Fallback: Plugins -> Create Plugin -> Server URL `https://mcp.dalalos.in/mcp` -> OAuth -> sign in.

### Cursor and other MCP clients

```json
{
  "mcpServers": {
    "dalalos": {
      "url": "https://mcp.dalalos.in/mcp"
    }
  }
}
```

Each client has its own schema for remote servers; see https://dalalos.in/connect. Only if a client cannot complete OAuth, send a DalalOS API key as an `Authorization: Bearer` header. Never commit or share a key.

## Try it

> Use DalalOS to fetch the latest available quote and company profile for Reliance Industries. Tell me which DalalOS tools you called, the source of the data, and its freshness date. Do not use web search.

## Tools

DalalOS exposes **59 current MCP tools**. Compatibility aliases and a `ping` helper are also visible on the server; the maintained reference is https://dalalos.in/tools and the machine-readable list is [`capabilities.json`](capabilities.json).

| Group | Count | Tools |
| --- | ---: | --- |
| Search and discovery | 9 | `search_stocks`, `screen_stocks`, `screen_by_query`, `list_preset_screens`, `run_preset_screen`, `get_sector_overview`, `list_indices`, `list_index_constituents`, `get_market_heatmap` |
| Quotes and prices | 6 | `get_stock_quote`, `get_batch_quotes`, `get_price_history`, `get_returns`, `get_delivery_trends`, `get_technical_indicators` |
| Financials and ratios | 7 | `get_financials`, `get_financial_trends`, `get_company_profile`, `get_company_report`, `get_company_operating_metrics`, `get_valuation_history`, `get_brsr` |
| Peer comparison | 2 | `get_peer_comparison`, `get_relevant_peers` |
| Ownership and risk | 3 | `get_shareholding`, `get_pledge_trend`, `get_company_exposures` |
| Corporate actions, events and filings | 12 | `get_stock_events`, `get_filing_extract`, `get_filing_extracts`, `get_event_context`, `search_company_disclosures`, `list_announcement_buckets`, `get_announcement_bucket`, `get_corporate_actions`, `get_dividends`, `get_upcoming_results`, `get_market_calendar`, `get_ipos` |
| Market context | 16 | `get_top_movers`, `get_market_breadth`, `get_india_vix`, `get_index_valuation`, `list_index_valuations`, `get_market_fii_dii_flow`, `get_sector_fpi_investment`, `get_sector_fii_flow` (historical), `get_stock_fii_flow` (historical), `get_bulk_block_deals`, `get_derivatives_positioning`, `get_fo_participant_activity`, `get_fno_ban_list`, `get_macro_indicators`, `get_fx_reference_rates`, `get_company_macro_exposures` |
| Watchlist | 3 | `get_watchlist`, `add_to_watchlist`, `remove_from_watchlist` |
| System | 1 | `get_data_freshness` |

Full reference: https://dalalos.in/tools

## Boundaries

- End-of-day data, not a live feed. Not a broker; no order placement.
- No investment advice, buy/sell calls or target prices.
- Not affiliated with NSE, BSE, SEBI, Anthropic, OpenAI or Cursor.

## Links

- Website: https://dalalos.in
- Connection guide: https://dalalos.in/connect
- Data sources and freshness: https://dalalos.in/docs/data-sources-and-freshness
- Public repository (documentation and capability contract): https://github.com/BeyondNoww/DalalOS-Indian-Stock-Research
- Contact: atharva@dalalos.in
