Nasdaq Data Link MCP

What is Nasdaq Data Link MCP about?

Nasdaq Data Link MCP exposes a collection of MCP tools that let AI assistants fetch real‑time and historical financial data—from retail trading activity and equity fundamentals to World Bank indicators and mutual‑fund details—through simple JSON‑based tool calls.

How to use Nasdaq Data Link MCP?

1. Clone and install the repository.
2. Create a .env file from the example and insert your Nasdaq Data Link API key (NASDAQ_DATA_LINK_API_KEY).
3. Register the server with an MCP‑compatible client (e.g., Claude Desktop, Groq Desktop) using the command:

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

4. From the client, invoke any of the exposed tools (e.g., get_stock_stats, get_rtat, get_indicator_value) by passing the required parameters in the tool JSON payload.

Key features of Nasdaq Data Link MCP

• Broad data coverage: Retail Trading Activity Tracker, Trade Summary, Equities 360 fundamentals, World Bank indicators, Nasdaq Fund Network.
• Fine‑grained tools: Individual endpoints for stock stats, balance sheets, cash flows, corporate actions, fund performance, fees, price history, and more.
• Field discovery: Helper tools (list_*_fields) return available columns for each dataset, enabling dynamic queries.
• Country code lookup: country_code tool simplifies ISO‑3 conversions for World Bank queries.
• Search capabilities: Keyword‑based search across World Bank indicators.
• Cross‑platform: Works on any OS with Python 3.13+ and the MCP client.

Use cases of Nasdaq Data Link MCP

• Financial research assistants: Retrieve the latest earnings, valuation ratios, or cash‑flow metrics for a given ticker during a conversational session.
• Economic data queries: Pull GDP, inflation, or CO₂ emission indicators for any country on demand.
• Fund analysis bots: Get fee structures, performance statistics, and NAV history for mutual funds.
• Retail market monitoring: Query RTAT data to see which stocks are most traded by retail investors on a specific day.
• Automated reporting: Combine multiple tool calls to build daily or weekly financial dashboards without manual API handling.

FAQ from the Nasdaq Data Link MCP

Q: Do I need a paid Nasdaq Data Link subscription? A: An API key is required; free tier access is available for many datasets, but premium data may need a paid subscription.

Q: Can I use this server without an MCP client? A: The server is designed to be called via MCP tool specifications; direct HTTP calls are not provided out‑of‑the‑box.

Q: Which Python version is required? A: Python 3.13 or newer.

Q: Are there rate limits? A: Rate limits are enforced by the Nasdaq Data Link API, not by the MCP server itself.

Q: How do I discover what fields I can request? A: Use the list_*_fields tools (e.g., list_stock_stat_fields) to retrieve field names and descriptions.

📈 Nasdaq Data Link MCP 🤖

A community developed and maintained Model Context Protocol (MCP) server that provides access for large language models to the 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).

🐍 Nasdaq Data Link MCP uses the official Nasdaq/data-link-python SDK.

[!IMPORTANT] This is an open-source project not affiliated with or endorsed by Nasdaq, Inc. Nasdaq® is a registered trademark of Nasdaq, Inc.

🌐 Usage

Nasdaq Data Link MCP - Retail Trading Activity	Nasdaq Data Link MCP - World Bank Data
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 provides 5 essential tools that work with any Nasdaq Data Link database.

Featured databases:

• World Bank - Global development indicators
• Equities 360 - Company fundamentals and financials
• Nasdaq RTAT - Retail trading activity
• Nasdaq Fund Network (NFN) - Mutual funds and ETFs
• ...and 100+ more databases via dataset codes

You: What was the GDP of Italy in 2022? Claude: searches datasets, gets WORLDBANK/GDP data

You: Show me Apple stock data for Q1 2024 Claude: gets WIKI/AAPL dataset with date filters

You: What datasets are available for CO₂ emissions? Claude: searches datasets for "CO2 emissions"

You: Export Tesla data as JSON Claude: exports dataset in JSON format

📦 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.13+ and the mcp CLI.

uv init mcp
uv add "mcp[cli]"

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

uv run 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).

🧪 Testing

Run the test suite:

python -m pytest tests/ -v

The test suite includes:

• Basic functionality tests
• Module import verification
• Parameter validation
• Error handling
• Integration tests

Tests are designed to work without requiring an API key for basic functionality verification.

🛠️ Tools

The server exposes 5 essential tools that work with any Nasdaq Data Link database:

search_datasets

Search for datasets by keyword.

Examples:

# Find GDP datasets
search_datasets(query="GDP")

# Search for oil prices
search_datasets(query="oil prices")

# Find retail trading data
search_datasets(query="retail trading")

# Search for fund data
search_datasets(query="mutual funds")

get_dataset

Get data from a specific dataset with optional date filters.

Examples:

# Get Apple stock data for Q1 2024
get_dataset(dataset_code="WIKI/AAPL", start_date="2024-01-01", end_date="2024-03-31")

# Get World Bank GDP data
get_dataset(dataset_code="WORLDBANK/GDP_MKTP_CD")

# Get retail trading activity
get_dataset(dataset_code="NDAQ/RTAT", start_date="2024-03-01")

# Get company fundamentals
get_dataset(dataset_code="QOR/STATS_MSFT")

# Get fund price history
get_dataset(dataset_code="NFN/MFRPH_ABCDX", start_date="2024-01-01", end_date="2024-12-31")

get_dataset_metadata

Get metadata about a dataset without downloading data.

Examples:

# Check GDP dataset structure
get_dataset_metadata(dataset_code="WORLDBANK/GDP_MKTP_CD")

# View available columns for Apple stock
get_dataset_metadata(dataset_code="WIKI/AAPL")

# Inspect fund data structure
get_dataset_metadata(dataset_code="NFN/MFRFM")

list_databases

List available databases on Nasdaq Data Link.

Example:

list_databases()

export_dataset

Export dataset in different formats (CSV, JSON, XML).

Examples:

# Export Apple data as JSON
export_dataset(dataset_code="WIKI/AAPL", output_format="json", start_date="2024-01-01")

# Export to CSV with date range
export_dataset(dataset_code="WORLDBANK/GDP_MKTP_CD", output_format="csv", start_date="2020-01-01", end_date="2023-12-31")

# Export as XML
export_dataset(dataset_code="NDAQ/RTAT", output_format="xml")

🧪 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

📚 References

• Model Context Protocol Python SDK
• Nasdaq Data Link Python SDK

📖 Citation

[!TIP] If you use this project in your research or work, please cite it using the CITATION.cff file, or the APA format:

Amorelli, S. (2025). Nasdaq Data Link MCP (Model Context Protocol) Server [Computer software]. GitHub. https://github.com/stefanoamorelli/nasdaq-data-link-mcp

📄 License

MIT License © 2025 Stefano Amorelli