globaldatafeeds-mcp

An MCP server that exposes GlobalDataFeeds (GFDL) Indian market data — NSE, BSE, MCX, NFO, currency and indices — to any AI assistant (Claude, Cursor, VS Code Copilot, etc.).

You bring your own key. This server ships with no API key. Each user supplies their own GlobalDataFeeds access key through their client's config. Get a key from https://globaldatafeeds.in.

Tools

Quotes: get_last_quote, get_last_quote_short, get_last_quote_array, get_snapshot · History: get_history, get_history_after_market, get_exchange_snapshot · Discovery: get_exchanges, search_instruments, get_instruments, get_instrument_types, get_products, get_expiry_dates, get_option_types, get_strike_prices · Derivatives: get_option_chain, get_option_greeks · Analytics: get_top_gainers_losers, get_volume_shockers · Account: get_server_info, get_limitation, get_market_messages, get_exchange_messages, get_holidays.

Configuration

The server reads these environment variables:

Connect it to your AI client

Each client passes your own key via an env block — the key never lives in the package.

Claude Desktop

Settings → Developer → Edit Config:

{
  "mcpServers": {
    "globaldatafeeds": {
      "command": "uvx",
      "args": ["globaldatafeeds-mcp"],
      "env": {
        "GDF_API_KEY": "YOUR_OWN_KEY",
        "GDF_BASE_URL": "https://your-gfdl-endpoint:port"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json — same shape as above ("mcpServers" with the env block).

VS Code (Copilot)

.vscode/mcp.json — prompts for the key so it's never written to the file:

{
  "inputs": [
    { "type": "promptString", "id": "gdf-key", "description": "GFDL API Key", "password": true }
  ],
  "servers": {
    "globaldatafeeds": {
      "type": "stdio",
      "command": "uvx",
      "args": ["globaldatafeeds-mcp"],
      "env": { "GDF_API_KEY": "${input:gdf-key}" }
    }
  }
}

Restart the client after editing its config.

Local development

uv sync
cp .env.example .env          # put your key in .env
uv run mcp dev server.py      # opens the MCP Inspector

License

MIT