A favicon of Nasdaq Data Link MCP

Nasdaq Data Link MCP

A Nasdaq Data Link MCP (Model Context Protocol) Server

Installation

Installing for Claude Desktop

Option 1: One-Command Installation

npx mcpbar install stefanoamorelli/nasdaq-data-link-mcp -c claude

This command will automatically install and configure the Nasdaq Data Link MCP MCP server for your selected client.

Option 2: Manual Configuration

View JSON configuration
{
  "mcpServers": {
    "Nasdaq Data Link MCP": {
      "command": "uvx",
      "args": [
        "nasdaq-data-link-mcp-os"
      ],
      "env": {
        "NASDAQ_DATA_LINK_API_KEY": "${input:nasdaq_data_link_api_key}"
      }
    }
  }
}

Copy and paste this configuration into your MCP client's configuration file to manually set up this server.

Common MCP clients
  • claude - Claude Desktop
  • cursor - Cursor Code Editor
  • cline - Cline (VS Code)
  • windsurf - Windsurf Editor
  • witsy - Witsy AI Assistant

๐Ÿ“ˆ Nasdaq Data Link MCP ๐Ÿค–

License: MIT PyPI version Python 3.10+ Build Status Platform AI Powered

A community developed and maintained Model Context Protocol (MCP) server that provides access to Nasdaq Data Link. Built for use with MCP-compatible clients.

This project aims at making easy to access and explore Nasdaq Data Linkโ€™s extensive and valuable financial and economic datasets through natural language interfaces and large language models (LLMs).

๐Ÿ This project uses the official nasdaq/data-link-python SDK

Disclaimer: This is an open-source project not affiliated with or endorsed by Nasdaq, Inc. Nasdaqยฎ is a registered trademark of Nasdaq, Inc.

๐ŸŒ Usage

Retail Trading ActivityWorld Bank Data
Nasdaq Data Link MCP - Retail Trading ActivityNasdaq Data Link MCP - World Bank Data
Retail Trading Activity
Nasdaq Data Link MCP - Groq + DeepSeek R1 RTAT 10

Once installed and connected to an MCP-compatible client (e.g., Claude Desktop, or Groq Desktop (beta), this server exposes several tools that your AI assistant can use to fetch data.

This project currently supports the following databases:

Example conversations

You: What were the most traded stocks by retailers yesterday?
Claude: calls get_rtat(<yetserday>) and returns relevant matches

You: What was the GDP of Italy in 2022?
Claude: Let me look that up... calls get_indicator_value tool
Claude: The GDP of Italy in 2022 was approximately ... trillion USD.

You: List all indicators related to COโ‚‚ emissions.
Claude: calls search_worldbank_indicators("CO2") and returns relevant matches

You: What's the latest trading data for Apple?
Claude: calls get_trade_summary_data() and presents the trading data

You: Show me yesterday's trading volume for the top tech stocks. Claude: calls get_trade_summary_data() and analyzes volume data

You: What's the market cap and P/E ratio of Microsoft?
Claude: calls get_stock_stats(symbol="MSFT") and presents the key statistics

You: Show me Microsoft's profitability ratios for the most recent annual report.
Claude: calls get_fundamental_data(symbol="MSFT", dimension="MRY") and presents profitability metrics

You: What's Microsoft's cash flow and R&D spending for the last quarter?
Claude: calls get_detailed_financials(symbol="MSFT", dimension="MRQ") and presents cash flow and R&D data

You: What's Microsoft's asset breakdown and debt-to-equity ratio from the latest balance sheet?
Claude: calls get_balance_sheet_data(symbol="MSFT", dimension="MRQ") and presents relevant balance sheet items

You: How has Microsoft's free cash flow and capital expenditure changed over the past year?
Claude: calls get_cash_flow_data(symbol="MSFT", dimension="MRY") and analyzes free cash flow trends

You: Has Tesla had any stock splits in the last two years?
Claude: calls get_corporate_action_data(symbol="TSLA", action="split") and presents the split history

You: What industry and sector is AMD in, and where is the company located?
Claude: calls get_company_reference_data(symbol="AMD") and presents industry, sector, and location information

You: Can you find information about mutual funds that are open-ended?
Claude: calls get_fund_master_report(investment_company_type="N-1A") and returns the fund information


๐Ÿ“ฆ Installation

1. Clone the Repository

git clone https://github.com/stefanoamorelli/nasdaq-data-link-mcp.git
cd nasdaq-data-link-mcp

2. Install Requirements

You'll need Python 3.10+ and the mcp CLI.

pip install mcp nasdaq-data-link pycountry

MCP SDK: https://github.com/modelcontextprotocol/python-sdk
Nasdaq Data Link SDK: https://github.com/Nasdaq/data-link-python

3. Get Your API Key

Sign up on https://data.nasdaq.com/ and copy your API key.

4. Configure the Environment

cp .env.example .env

Then edit .env and add your API key:

NASDAQ_DATA_LINK_API_KEY=your_api_key_here

And the PYTHONPATH:

PYTHONPATH=/path/to/your/local/cloned/repo/nasdaq-data-link-mcp

5. Install the MCP Server

mcp install nasdaq_data_link_mcp_os/server.py --env-file .env --name "Nasdaq Data Link MCP Server" --with nasdaq-data-link --with pycountry

This registers the server with your MCP client (e.g., Claude Desktop).


๐Ÿ› ๏ธ Tools

After installation, the following tools are exposed to MCP clients:


๐Ÿ“ˆ Retail Trading Activity Tracker

get_rtat10

Retrieves Retail Trading Activity Tracker 10 (RTAT10) data for specific dates and optional tickers.

{
  "action": "tool",
  "name": "get_rtat10",
  "params": {
    "dates": "2025-03-31,2025-03-28,2025-03-27",
    "tickers": "TSLA,TQQQ,SQQQ"
  }
}

Returns RTAT10 data from Nasdaq Data Link for the given dates and tickers.


get_rtat

Retrieves Retail Trading Activity (RTAT) data for specific dates and optional tickers.

{
  "action": "tool",
  "name": "get_rtat",
  "params": {
    "dates": "2025-03-31,2025-03-28,2025-03-27",
    "tickers": "TSLA,TQQQ,SQQQ"
  }
}

Returns RTAT data from Nasdaq Data Link for the given dates and tickers.


๐Ÿ“Š Trade Summary Tool

get_trade_summary_data

Retrieves Trade Summary data from Nasdaq Data Link NDAQ/TS datatable.

{
  "action": "tool",
  "name": "get_trade_summary_data"
}

Returns consolidated trade data including open, high, low, close, and volume information.


๐Ÿ“Š World Bank Tools

get_indicator_value

Fetch the value for a specific indicator and country.

{
  "action": "tool",
  "name": "get_indicator_value",
  "params": {
    "country": "Italy",
    "indicator": "NY.GDP.MKTP.CD"
  }
}

Returns the latest value for that indicator.


country_code

Returns the ISO 3-letter country code (e.g., "ITA" for Italy).

{
  "action": "tool",
  "name": "country_code",
  "params": {
    "countryName": "Italy"
  }
}

list_worldbank_indicators

Returns a list of all 1500+ indicators available.

{
  "action": "tool",
  "name": "list_worldbank_indicators"
}

search_worldbank_indicators

Searches for indicators by keyword.

{
  "action": "tool",
  "name": "search_worldbank_indicators",
  "params": {
    "keyword": "population"
  }
}

๐Ÿ“ˆ Equities 360 Tools

get_stock_stats

Retrieves comprehensive statistics for a company from the Nasdaq Equities 360 database.

{
  "action": "tool",
  "name": "get_stock_stats",
  "params": {
    "symbol": "MSFT"
  }
}

Or using FIGI:

{
  "action": "tool",
  "name": "get_stock_stats",
  "params": {
    "figi": "BBG000BPH459"
  }
}

Returns company statistics including market cap, PE ratio, 52-week highs/lows, dividend information, and more.


list_stock_stat_fields

Lists all available fields in the stock statistics database with descriptions.

{
  "action": "tool",
  "name": "list_stock_stat_fields"
}

Returns information about all available fields that can be queried through the get_stock_stats tool.


get_fundamental_data

Retrieves fundamental financial data from the Nasdaq Equities 360 Fundamental Summary database.

{
  "action": "tool",
  "name": "get_fundamental_data",
  "params": {
    "symbol": "MSFT",
    "dimension": "MRY"
  }
}

Or using multiple parameters:

{
  "action": "tool",
  "name": "get_fundamental_data",
  "params": {
    "figi": "BBG000BPH459",
    "calendardate": "2022-12-31",
    "dimension": "MRQ"
  }
}

Returns fundamental data including profitability ratios (ROA, ROE, ROS), valuation metrics (P/E, P/S), income statement items (revenue, gross profit), and financial health indicators (current ratio, debt-to-equity).


list_fundamental_fields

Lists all available fields in the fundamental summary database with descriptions.

{
  "action": "tool",
  "name": "list_fundamental_fields"
}

Returns information about all available fields that can be queried through the get_fundamental_data tool.


get_detailed_financials

Retrieves detailed financial data from the Nasdaq Equities 360 Fundamental Details database.

{
  "action": "tool",
  "name": "get_detailed_financials",
  "params": {
    "symbol": "MSFT",
    "dimension": "MRQ"
  }
}

Or using multiple parameters:

{
  "action": "tool",
  "name": "get_detailed_financials",
  "params": {
    "figi": "BBG000BPH459",
    "calendardate": "2022-12-31",
    "dimension": "MRY"
  }
}

Returns comprehensive financial statement data including balance sheet items (assets, liabilities, equity), income statement components (revenue, expenses, profit), cash flow details (operating, investing, financing), and detailed financial ratios.


list_detailed_financial_fields

Lists all available fields in the fundamental details database with descriptions.

{
  "action": "tool",
  "name": "list_detailed_financial_fields"
}

Returns information about all available fields that can be queried through the get_detailed_financials tool.


get_balance_sheet_data

Retrieves balance sheet data from the Nasdaq Equities 360 Balance Sheet database.

{
  "action": "tool",
  "name": "get_balance_sheet_data",
  "params": {
    "symbol": "MSFT",
    "dimension": "MRQ"
  }
}

Or using multiple parameters:

{
  "action": "tool",
  "name": "get_balance_sheet_data",
  "params": {
    "figi": "BBG000BPH459",
    "calendardate": "2022-12-31",
    "dimension": "MRY"
  }
}

Returns comprehensive balance sheet data including assets (current, non-current, intangible), liabilities (current, non-current, debt), stockholders' equity, and key balance sheet metrics.


list_balance_sheet_fields

Lists all available fields in the balance sheet database with descriptions.

{
  "action": "tool",
  "name": "list_balance_sheet_fields"
}

Returns information about all available fields that can be queried through the get_balance_sheet_data tool.


get_cash_flow_data

Retrieves cash flow statement data from the Nasdaq Equities 360 Cash Flow database.

{
  "action": "tool",
  "name": "get_cash_flow_data",
  "params": {
    "symbol": "MSFT",
    "dimension": "MRQ"
  }
}

Or using multiple parameters:

{
  "action": "tool",
  "name": "get_cash_flow_data",
  "params": {
    "figi": "BBG000BPH459",
    "calendardate": "2022-12-31",
    "dimension": "MRY"
  }
}

Returns cash flow statement data including operating activities (ncfo), investing activities (ncfi), financing activities (ncff), free cash flow (fcf), capital expenditures (capex), and more.


list_cash_flow_fields

Lists all available fields in the cash flow statement database with descriptions.

{
  "action": "tool",
  "name": "list_cash_flow_fields"
}

Returns information about all available fields that can be queried through the get_cash_flow_data tool.


get_corporate_action_data

Retrieves corporate actions data from the Nasdaq Equities 360 Corporate Actions database.

{
  "action": "tool",
  "name": "get_corporate_action_data",
  "params": {
    "symbol": "TSLA",
    "action": "split"
  }
}

Or using other parameters:

{
  "action": "tool",
  "name": "get_corporate_action_data",
  "params": {
    "date": "2023-03-24"
  }
}

Returns information about corporate events such as stock splits, mergers, acquisitions, and other significant company actions that can affect stock price and ownership.


list_corporate_action_fields

Lists all available fields in the corporate actions database with descriptions.

{
  "action": "tool",
  "name": "list_corporate_action_fields"
}

Returns information about all available fields that can be queried through the get_corporate_action_data tool.


get_company_reference_data

Retrieves company reference data from the Nasdaq Equities 360 Reference Data database.

{
  "action": "tool",
  "name": "get_company_reference_data",
  "params": {
    "symbol": "AMD"
  }
}

Or using FIGI:

{
  "action": "tool",
  "name": "get_company_reference_data",
  "params": {
    "figi": "BBG000BBQCY0"
  }
}

Returns static information about companies including exchange, industry, sector classification, website URLs, SEC filing links, and location information.


list_reference_data_fields

Lists all available fields in the company reference database with descriptions.

{
  "action": "tool",
  "name": "list_reference_data_fields"
}

Returns information about all available fields that can be queried through the get_company_reference_data tool.


๐Ÿ“Š Nasdaq Fund Network (NFN) Tool

get_fund_master_report

Retrieves Fund Master Report (NFN/MFRFM) data from Nasdaq Fund Network.

{
  "action": "tool",
  "name": "get_fund_master_report",
  "params": {
    "fund_id": "12345"
  }
}

Returns fund data from Nasdaq Fund Network for the given fund ID.

You can also filter by investment company type:

{
  "action": "tool",
  "name": "get_fund_master_report",
  "params": {
    "investment_company_type": "N-1A"
  }
}

Returns data about mutual funds and other investment products, including fund identifiers, formation dates, and regulatory information.


๐Ÿงช MCP Dev & Debugging

To test the server locally with a UI:

mcp dev nasdaq_data_link_mcp_os/server.py --env-file .env

This opens the MCP Dev interface where you can call tools manually, inspect results, and troubleshoot.


๐Ÿ“Š Architecture Diagram

graph TD
  subgraph "Local Machine"
    A[MCP Server: Nasdaq Data Link MCP] --> C[MCP Client, ie. Claude Desktop]
  end

  C -->|user prompt| D[LLM ie. Claude 3.7 Sonnet]
  D -->|calls tool| A
  A -->|fetches data| B[Nasdaq Data Link API]
  B -.-> E[Retail Trading Activity Tracker]
  B -.-> F[World Bank Metadata]
  B -.-> N[Trade Summary NDAQ/TS]
  B -.-> O[Nasdaq Fund Network NFN/MFRFM]
  
  subgraph " "
    G[Statistics NDAQ/STAT]
    H[Fundamentals NDAQ/FS]
    I[Fundamental Details NDAQ/FD]
    J[Balance Sheet NDAQ/BS]
    K[Cash Flow NDAQ/CF]
    L[Corporate Actions NDAQ/CA]
    M[Reference Data NDAQ/RD]
  end

B -.->|Equities 360| G

๐Ÿ“š References


๐Ÿ“„ License

MIT License ยฉ 2025 Stefano Amorelli

Share:
Details:
  • Stars


    11
  • Forks


    2
  • Last commit


    1 day ago
  • Repository age


    1 month
  • License


    MIT
View Repository

Auto-fetched from GitHub .

MCP servers similar to Nasdaq Data Link MCP:

ย 

ย 
ย 
  • Stars


  • Forks


  • Last commit


ย 

ย 
ย 
  • Stars


  • Forks


  • Last commit


ย 

ย 
ย 
  • Stars


  • Forks


  • Last commit


Nasdaq Data Link MCP: MCP Server โ€“ MCP.Bar