Metadata-Version: 2.5
Name: dalalos-mcp
Version: 0.2.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.

**The server runs at `https://mcp.dalalos.in/mcp`** (streamable HTTP, OAuth sign-in in the browser, free tier, no card). If your AI client accepts a server URL, connect it to that URL and sign in; you don't need this package at all. If your client can only launch a local command, `dalalos-mcp proxy` bridges it to the hosted server with an API key.

```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
dalalos-mcp proxy                # local stdio server for command-only clients (needs DALALOS_API_KEY)
```

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

## How sign-in works

- **Clients that take a URL** (Claude, ChatGPT, Claude Code, Codex, Cursor): the first time your client connects, DalalOS answers that sign-in is needed and your client opens the DalalOS sign-in page in your browser (email code or Google). Your DalalOS account is created on first sign-in, and your client keeps the login. You never copy a key.
- **Clients that only launch a command:** create an API key at https://dalalos.in/dashboard/keys and put it in the client's config as `DALALOS_API_KEY` (see "Command-only clients" below). The proxy sends the key only to `mcp.dalalos.in`.

## 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.

### Command-only clients (Claude Desktop config file, Cline and others)

`pip install dalalos-mcp`, create an API key at https://dalalos.in/dashboard/keys, then add:

```json
{
  "mcpServers": {
    "dalalos": {
      "command": "dalalos-mcp",
      "args": ["proxy"],
      "env": { "DALALOS_API_KEY": "<your DalalOS API key>" }
    }
  }
}
```

If the client can't find `dalalos-mcp`, use the full path that `pip show -f dalalos-mcp` lists, or `"command": "python", "args": ["-m", "dalalos_mcp", "proxy"]`. Keep the key out of shared or committed config files.

## 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
