stefanoamorelli/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
Example conversations
> 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
bash
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.
bash
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
bash
cp .env.example .env
Then edit .env and add your API key:
NASDAQDATALINKAPIKEY=yourapikeyhere
And the PYTHONPATH:
PYTHONPATH=/path/to/your/local/cloned/repo/nasdaq-data-link-mcp
### 5. Install the MCP Server
bash
uv run mcp install nasdaqdatalinkmcpos/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:
bash
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:
### searchdatasets
Search for datasets by keyword.
Examples:
python
# Find GDP datasets
searchdatasets(query="GDP")
# Search for oil prices
searchdatasets(query="oil prices")
# Find retail trading data
searchdatasets(query="retail trading")
# Search for fund data
searchdatasets(query="mutual funds")