{"id":26945554,"url":"https://github.com/stefanoamorelli/nasdaq-data-link-mcp","last_synced_at":"2026-04-29T18:31:18.417Z","repository":{"id":285602359,"uuid":"957599131","full_name":"stefanoamorelli/nasdaq-data-link-mcp","owner":"stefanoamorelli","description":"A Nasdaq Data Link MCP (Model Context Protocol) Server","archived":false,"fork":false,"pushed_at":"2025-10-04T16:20:28.000Z","size":210,"stargazers_count":57,"open_issues_count":2,"forks_count":11,"subscribers_count":5,"default_branch":"main","last_synced_at":"2026-04-18T01:43:11.372Z","etag":null,"topics":["ai","data","data-analysis","finance","financial-analysis","financial-data","genai","llm","mcp","nasdaq","research"],"latest_commit_sha":null,"homepage":"https://amorelli.tech/open-source/nasdaq-data-link-mcp","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stefanoamorelli.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-30T18:54:51.000Z","updated_at":"2026-03-13T11:01:38.000Z","dependencies_parsed_at":null,"dependency_job_id":"8cb5f096-a49d-4f1e-84c6-3b6c2bbd5e8c","html_url":"https://github.com/stefanoamorelli/nasdaq-data-link-mcp","commit_stats":null,"previous_names":["stefanoamorelli/nasdaq-data-link-mcp"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/stefanoamorelli/nasdaq-data-link-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefanoamorelli%2Fnasdaq-data-link-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefanoamorelli%2Fnasdaq-data-link-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefanoamorelli%2Fnasdaq-data-link-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefanoamorelli%2Fnasdaq-data-link-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stefanoamorelli","download_url":"https://codeload.github.com/stefanoamorelli/nasdaq-data-link-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefanoamorelli%2Fnasdaq-data-link-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32439091,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T18:12:22.909Z","status":"ssl_error","status_checked_at":"2026-04-29T18:11:33.322Z","response_time":110,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","data","data-analysis","finance","financial-analysis","financial-data","genai","llm","mcp","nasdaq","research"],"created_at":"2025-04-02T19:15:17.560Z","updated_at":"2026-04-29T18:31:18.409Z","avatar_url":"https://github.com/stefanoamorelli.png","language":"Python","funding_links":[],"categories":["📚 Projects (1974 total)","Community Servers","MCP Servers for Economic Data","APIs and HTTP Requests","📦 Other"],"sub_categories":["MCP Servers"],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 📈 Nasdaq Data Link MCP 🤖\n\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![PyPI version](https://img.shields.io/badge/PyPI-v0.2.0-blue.svg)](https://pypi.org/project/nasdaq-data-link-mcp-os/)\n![Python 3.13+](https://img.shields.io/badge/Python-3.13%2B-blue.svg)\n![Build Status](https://img.shields.io/badge/build-passing-green.svg)\n![Platform](https://img.shields.io/badge/platform-cross--platform-lightgrey.svg)\n![](https://badge.mcpx.dev?type=server 'MCP Server')\n![AI Powered](https://img.shields.io/badge/AI-powered-6f42c1?logo=anthropic\u0026logoColor=white)\n[![PyPI Downloads](https://static.pepy.tech/badge/nasdaq-data-link-mcp-os)](https://pepy.tech/projects/nasdaq-data-link-mcp-os)\n\n\u003c/div\u003e\n\nA 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).\n\nThis 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).\n\n🐍 `Nasdaq Data Link MCP` uses the official [Nasdaq/data-link-python](https://github.com/Nasdaq/data-link-python) SDK.\n\n\u003e [!IMPORTANT]\n\u003e This is an open-source project *not affiliated with or endorsed by Nasdaq, Inc.* Nasdaq® is a registered trademark of Nasdaq, Inc.\n\n## 🌐 Usage\n\n| [![Retail Trading Activity](https://cdn.loom.com/sessions/thumbnails/b0299f6f6f1844669b5d2f73a86a3dcb-63f0e754bafcbe42-full-play.gif)](https://www.loom.com/share/b0299f6f6f1844669b5d2f73a86a3dcb) | [![World Bank Data](https://cdn.loom.com/sessions/thumbnails/a07e518bb6eb4de4b5a06a5a1a112a24-ff58182656db7dca-full-play.gif)](https://www.loom.com/share/a07e518bb6eb4de4b5a06a5a1a112a24) |\n|:--:|:--:|\n| [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) |\n| [![Retail Trading Activity](https://cdn.loom.com/sessions/thumbnails/46c7df4cb4c4405aa9e0a49ce6cd75be-9a5eeaf2133bc160-full-play.gif)](https://www.loom.com/share/46c7df4cb4c4405aa9e0a49ce6cd75be) | |\n| [Nasdaq Data Link MCP - Groq + DeepSeek R1 RTAT 10](https://www.loom.com/share/46c7df4cb4c4405aa9e0a49ce6cd75be) | |\n\nOnce 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.\n\n**Featured databases:**\n- [World Bank](https://data.nasdaq.com/databases/WB) - Global development indicators\n- [Equities 360](https://data.nasdaq.com/databases/E360) - Company fundamentals and financials\n- [Nasdaq RTAT](https://data.nasdaq.com/databases/RTAT) - Retail trading activity\n- [Nasdaq Fund Network (NFN)](https://data.nasdaq.com/databases/MFR) - Mutual funds and ETFs\n- ...and 100+ more databases via dataset codes\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eExample conversations\u003c/strong\u003e\u003c/summary\u003e\n\n\u003e **You:** What was the GDP of Italy in 2022?\n\u003e **Claude:** *searches datasets, gets WORLDBANK/GDP data*\n\n\u003e **You:** Show me Apple stock data for Q1 2024\n\u003e **Claude:** *gets WIKI/AAPL dataset with date filters*\n\n\u003e **You:** What datasets are available for CO₂ emissions?\n\u003e **Claude:** *searches datasets for \"CO2 emissions\"*\n\n\u003e **You:** Export Tesla data as JSON\n\u003e **Claude:** *exports dataset in JSON format*\n\u003c/details\u003e\n\n---\n\n## 📦 Installation\n\n### 1. Clone the Repository\n\n```bash\ngit clone https://github.com/stefanoamorelli/nasdaq-data-link-mcp.git\ncd nasdaq-data-link-mcp\n```\n\n### 2. Install Requirements\n\nYou'll need Python 3.13+ and the `mcp` CLI.\n\n```bash\nuv init mcp\nuv add \"mcp[cli]\"\n```\n\n\u003e MCP SDK: https://github.com/modelcontextprotocol/python-sdk\n\u003e Nasdaq Data Link SDK: https://github.com/Nasdaq/data-link-python\n\n### 3. Get Your API Key\n\nSign up on [https://data.nasdaq.com/](https://data.nasdaq.com/) and copy your API key.\n\n### 4. Configure the Environment\n\n```bash\ncp .env.example .env\n```\n\nThen edit `.env` and add your API key:\n\n```\nNASDAQ_DATA_LINK_API_KEY=your_api_key_here\n```\n\nAnd the `PYTHONPATH`:\n```\nPYTHONPATH=/path/to/your/local/cloned/repo/nasdaq-data-link-mcp\n```\n\n### 5. Install the MCP Server\n\n```bash\nuv 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\n```\n\nThis registers the server with your MCP client (e.g., Claude Desktop).\n\n---\n\n## 🧪 Testing\n\nRun the test suite:\n\n```bash\npython -m pytest tests/ -v\n```\n\nThe test suite includes:\n- Basic functionality tests\n- Module import verification\n- Parameter validation\n- Error handling\n- Integration tests\n\nTests are designed to work without requiring an API key for basic functionality verification.\n\n---\n\n## 🛠️ Tools\n\nThe server exposes 5 essential tools that work with any Nasdaq Data Link database:\n\n### `search_datasets`\nSearch for datasets by keyword.\n\n**Examples:**\n```python\n# Find GDP datasets\nsearch_datasets(query=\"GDP\")\n\n# Search for oil prices\nsearch_datasets(query=\"oil prices\")\n\n# Find retail trading data\nsearch_datasets(query=\"retail trading\")\n\n# Search for fund data\nsearch_datasets(query=\"mutual funds\")\n```\n\n### `get_dataset`\nGet data from a specific dataset with optional date filters.\n\n**Examples:**\n```python\n# Get Apple stock data for Q1 2024\nget_dataset(dataset_code=\"WIKI/AAPL\", start_date=\"2024-01-01\", end_date=\"2024-03-31\")\n\n# Get World Bank GDP data\nget_dataset(dataset_code=\"WORLDBANK/GDP_MKTP_CD\")\n\n# Get retail trading activity\nget_dataset(dataset_code=\"NDAQ/RTAT\", start_date=\"2024-03-01\")\n\n# Get company fundamentals\nget_dataset(dataset_code=\"QOR/STATS_MSFT\")\n\n# Get fund price history\nget_dataset(dataset_code=\"NFN/MFRPH_ABCDX\", start_date=\"2024-01-01\", end_date=\"2024-12-31\")\n```\n\n### `get_dataset_metadata`\nGet metadata about a dataset without downloading data.\n\n**Examples:**\n```python\n# Check GDP dataset structure\nget_dataset_metadata(dataset_code=\"WORLDBANK/GDP_MKTP_CD\")\n\n# View available columns for Apple stock\nget_dataset_metadata(dataset_code=\"WIKI/AAPL\")\n\n# Inspect fund data structure\nget_dataset_metadata(dataset_code=\"NFN/MFRFM\")\n```\n\n### `list_databases`\nList available databases on Nasdaq Data Link.\n\n**Example:**\n```python\nlist_databases()\n```\n\n### `export_dataset`\nExport dataset in different formats (CSV, JSON, XML).\n\n**Examples:**\n```python\n# Export Apple data as JSON\nexport_dataset(dataset_code=\"WIKI/AAPL\", output_format=\"json\", start_date=\"2024-01-01\")\n\n# Export to CSV with date range\nexport_dataset(dataset_code=\"WORLDBANK/GDP_MKTP_CD\", output_format=\"csv\", start_date=\"2020-01-01\", end_date=\"2023-12-31\")\n\n# Export as XML\nexport_dataset(dataset_code=\"NDAQ/RTAT\", output_format=\"xml\")\n```\n\n---\n\n## 🧪 MCP Dev \u0026 Debugging\n\nTo test the server locally with a UI:\n\n```bash\nmcp dev nasdaq_data_link_mcp_os/server.py --env-file .env\n```\n\nThis opens the `MCP` Dev interface where you can call tools manually, inspect results, and troubleshoot.\n\n---\n\n## 📊 Architecture Diagram\n\n```mermaid\ngraph TD\n  subgraph \"Local Machine\"\n    A[MCP Server: Nasdaq Data Link MCP] --\u003e C[MCP Client, ie. Claude Desktop]\n  end\n\n  C --\u003e|user prompt| D[LLM ie. Claude 3.7 Sonnet]\n  D --\u003e|calls tool| A\n  A --\u003e|fetches data| B[Nasdaq Data Link API]\n  B -.-\u003e E[Retail Trading Activity Tracker]\n  B -.-\u003e F[World Bank Metadata]\n  B -.-\u003e N[Trade Summary NDAQ/TS]\n\n  subgraph \"Nasdaq Fund Network (NFN)\"\n    O1[Fund Master MFRFM]\n    O2[Fund Information MFRFI]\n    O3[Share Class Master MFRSM]\n    O4[Share Class Info MFRSI]\n    O5[Price History MFRPH/MFRPH10]\n    O6[Performance MFRPS/MFRPRB/MFRPA]\n    O7[Fees \u0026 Expenses MFRPM]\n    O8[Monthly Flows MFRMF]\n  end\n\n  B -.-\u003e O1\n  B -.-\u003e O2\n  B -.-\u003e O3\n  B -.-\u003e O4\n  B -.-\u003e O5\n  B -.-\u003e O6\n  B -.-\u003e O7\n  B -.-\u003e O8\n\n  subgraph \" \"\n    G[Statistics NDAQ/STAT]\n    H[Fundamentals NDAQ/FS]\n    I[Fundamental Details NDAQ/FD]\n    J[Balance Sheet NDAQ/BS]\n    K[Cash Flow NDAQ/CF]\n    L[Corporate Actions NDAQ/CA]\n    M[Reference Data NDAQ/RD]\n  end\n\nB -.-\u003e|Equities 360| G\n```\n---\n\n## 📚 References\n\n- [Model Context Protocol Python SDK](https://github.com/modelcontextprotocol/python-sdk)\n- [Nasdaq Data Link Python SDK](https://github.com/Nasdaq/data-link-python)\n\n---\n\n## 📖 Citation\n\n\u003e [!TIP]\n\u003e If you use this project in your research or work, please cite it using the [CITATION.cff](CITATION.cff) file, or the APA format:\n\n`Amorelli, S. (2025). Nasdaq Data Link MCP (Model Context Protocol) Server [Computer software]. GitHub. https://github.com/stefanoamorelli/nasdaq-data-link-mcp`\n\n---\n\n## 📄 License\n\n[MIT License](LICENSE) © 2025 [Stefano Amorelli](https://github.com/stefanoamorelli)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstefanoamorelli%2Fnasdaq-data-link-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstefanoamorelli%2Fnasdaq-data-link-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstefanoamorelli%2Fnasdaq-data-link-mcp/lists"}