https://github.com/stefanoamorelli/nasdaq-data-link-mcp
A Nasdaq Data Link MCP (Model Context Protocol) Server
https://github.com/stefanoamorelli/nasdaq-data-link-mcp
ai data data-analysis finance financial-analysis financial-data genai llm mcp nasdaq research
Last synced: about 1 month ago
JSON representation
A Nasdaq Data Link MCP (Model Context Protocol) Server
- Host: GitHub
- URL: https://github.com/stefanoamorelli/nasdaq-data-link-mcp
- Owner: stefanoamorelli
- License: mit
- Created: 2025-03-30T18:54:51.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-10-04T16:20:28.000Z (8 months ago)
- Last Synced: 2026-04-18T01:43:11.372Z (about 2 months ago)
- Topics: ai, data, data-analysis, finance, financial-analysis, financial-data, genai, llm, mcp, nasdaq, research
- Language: Python
- Homepage: https://amorelli.tech/open-source/nasdaq-data-link-mcp
- Size: 205 KB
- Stars: 57
- Watchers: 5
- Forks: 11
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Citation: CITATION.cff
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-mcp-servers - Nasdaq Data Link - MCP server for accessing economic and financial datasets from Nasdaq Data Link. (Community Servers)
- awesome-ai-for-economists - Nasdaq Data Link MCP - Access Nasdaq/Quandl financial and economic datasets. (MCP Servers for Economic Data)
- metorial-index - Nasdaq Data Link MCP - Access and explore extensive financial and economic datasets from Nasdaq Data Link using natural language queries. Provides real-time financial insights and data analysis capabilities through AI model integration. (APIs and HTTP Requests)
- awesome-mcp-servers - **Nasdaq Data Link (by stefanoamorelli)** - An MCP server to access, explore, and interact with Nasdaq Data Link's extensive and valuable financial and economic datasets. `http` `git` `github` (📦 Other)
README
# 📈 Nasdaq Data Link MCP 🤖
[](LICENSE)
[](https://pypi.org/project/nasdaq-data-link-mcp-os/)
[](https://pepy.tech/projects/nasdaq-data-link-mcp-os)
A community developed and maintained [Model Context Protocol (MCP)](https://github.com/modelcontextprotocol) server that provides access for large language models to the [Nasdaq Data Link](https://data.nasdaq.com/). Built for use with MCP-compatible [clients](https://modelcontextprotocol.io/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](https://github.com/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
| [](https://www.loom.com/share/b0299f6f6f1844669b5d2f73a86a3dcb) | [](https://www.loom.com/share/a07e518bb6eb4de4b5a06a5a1a112a24) |
|:--:|:--:|
| [Nasdaq Data Link MCP - Retail Trading Activity](https://www.loom.com/share/b0299f6f6f1844669b5d2f73a86a3dcb) | [Nasdaq Data Link MCP - World Bank Data](https://www.loom.com/share/a07e518bb6eb4de4b5a06a5a1a112a24) |
| [](https://www.loom.com/share/46c7df4cb4c4405aa9e0a49ce6cd75be) | |
| [Nasdaq Data Link MCP - Groq + DeepSeek R1 RTAT 10](https://www.loom.com/share/46c7df4cb4c4405aa9e0a49ce6cd75be) | |
Once installed and connected to an `MCP`-compatible client (e.g., [Claude Desktop](https://claude.ai/download), or [Groq Desktop (beta)](https://github.com/groq/groq-desktop-beta), this server provides 5 essential tools that work with **any** Nasdaq Data Link database.
**Featured databases:**
- [World Bank](https://data.nasdaq.com/databases/WB) - Global development indicators
- [Equities 360](https://data.nasdaq.com/databases/E360) - Company fundamentals and financials
- [Nasdaq RTAT](https://data.nasdaq.com/databases/RTAT) - Retail trading activity
- [Nasdaq Fund Network (NFN)](https://data.nasdaq.com/databases/MFR) - 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/](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:
```
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
```bash
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:
```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:
### `search_datasets`
Search for datasets by keyword.
**Examples:**
```python
# 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:**
```python
# 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:**
```python
# 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:**
```python
list_databases()
```
### `export_dataset`
Export dataset in different formats (CSV, JSON, XML).
**Examples:**
```python
# 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:
```bash
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
```mermaid
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]
subgraph "Nasdaq Fund Network (NFN)"
O1[Fund Master MFRFM]
O2[Fund Information MFRFI]
O3[Share Class Master MFRSM]
O4[Share Class Info MFRSI]
O5[Price History MFRPH/MFRPH10]
O6[Performance MFRPS/MFRPRB/MFRPA]
O7[Fees & Expenses MFRPM]
O8[Monthly Flows MFRMF]
end
B -.-> O1
B -.-> O2
B -.-> O3
B -.-> O4
B -.-> O5
B -.-> O6
B -.-> O7
B -.-> O8
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
- [Model Context Protocol Python SDK](https://github.com/modelcontextprotocol/python-sdk)
- [Nasdaq Data Link Python SDK](https://github.com/Nasdaq/data-link-python)
---
## 📖 Citation
> [!TIP]
> If you use this project in your research or work, please cite it using the [CITATION.cff](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](LICENSE) © 2025 [Stefano Amorelli](https://github.com/stefanoamorelli)