Skip to content
Back to search

data-mcp

The knowledge harness for AI‑native finance — MCP server for LLMQuant Data.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/llmquant--data-mcp/badge.svg)](/listings/llmquant--data-mcp)

HTML

<a href="/listings/llmquant--data-mcp"><img src="/api/listings/llmquant--data-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

The fastest way: drop this prompt into Claude Code, Cursor, Codex CLI, Gemini CLI, or any MCP-enabled agent. The agent will read this README and run the right setup for its runtime.

Install the LLMQuant data-mcp server in this environment by following https://github.com/LLMQuant/data-mcp

> [!TIP] > Make sure `LLMQUANT_API_KEY` is exported in the shell where the agent runs. Get a key at [llmquantdata.com](https://llmquantdata.com).

Prefer to set it up by hand? See [Client Setup](#client-setup) below.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 250 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <a href="https://llmquantdata.com">
  3. <picture>
  4. <source media="(prefers-color-scheme: dark)" srcset="./assets/logo-dark.svg" />
  5. <img alt="LLMQuant Data" src="./assets/logo.svg" width="120" />
  6. </picture>
  7. </a>
  8. </p>
  9. <h3 align="center">@llmquant/data-mcp</h3>
  10. <p align="center">
  11. The knowledge harness for AI‑native finance.<br/>
  12. <a href="https://llmquantdata.com">Website</a> · <a href="https://docs.llmquantdata.com">Docs</a> · <a href="./README.zh-CN.md">中文</a>
  13. </p>
  14. <p align="center">
  15. <a href="https://www.npmjs.com/package/@llmquant/data-mcp"><img src="https://img.shields.io/npm/v/@llmquant/data-mcp" alt="npm version" /></a>
  16. <a href="https://www.npmjs.com/package/@llmquant/data-mcp"><img src="https://img.shields.io/npm/dm/@llmquant/data-mcp" alt="npm downloads" /></a>
  17. <a href="./LICENSE"><img src="https://img.shields.io/npm/l/@llmquant/data-mcp" alt="license" /></a>
  18. <a href="https://nodejs.org"><img src="https://img.shields.io/node/v/@llmquant/data-mcp" alt="node version" /></a>
  19. </p>
  20. ---
  21. > [!IMPORTANT]
  22. > **New: [Company News](https://docs.llmquantdata.com/en/api/news/browse) and [Polymarket prediction markets](https://docs.llmquantdata.com/en/api/prediction-markets/events) are live.** Browse company updates, discover market events, and track implied probabilities from one MCP server.
  23. Context engineering meets financial data — structured for agent context, not human browsing.
  24. ## Table of Contents
  25. - [What It Does](#what-it-does)
  26. - [Available Tools](#available-tools)
  27. - [Try It Out](#try-it-out)
  28. - [Quick Install (Prompt)](#quick-install-prompt)
  29. - [Client Setup](#client-setup)
  30. - [Remote / Hosted MCP](#remote--hosted-mcp)
  31. - [Environment Variables](#environment-variables)
  32. - [Roadmap](#roadmap)
  33. - [See Also](#see-also)
  34. - [Contributing](#contributing)
  35. - [License](#license)
  36. ## What It Does
  37. This is an MCP server for [LLMQuant Data](https://llmquantdata.com). It connects any AI agent to financial data — wiki articles, research papers, crypto & equity prices, prediction markets, macro indicators, SEC filings, and more — through the [Model Context Protocol](https://modelcontextprotocol.io).
  38. Configure once — every agent in your stack gets the data.
  39. <p align="center">
  40. <img src="./assets/agent-harness.png" alt="Available in every agent harness" width="720" />
  41. </p>
  42. > [!TIP]
  43. > **[LLMQuant Skills](https://github.com/LLMQuant/skills) is live.** It combines these tools into ready‑made financial workflows for equity research, macro analysis, and more. Install the catalog or enable first-party Skills in the Agent Playground.
  44. ## Available Tools
  45. > [!NOTE]
  46. > The credit model is in **beta** — amounts below may change. Sign up at [llmquantdata.com](https://llmquantdata.com) for free credits, no credit card required.
  47. | Tool | Description | Credit |
  48. |------|-------------|--------|
  49. | `wiki_search` | Semantic search over 50,000+ quant wiki entries | 1 |
  50. | `wiki_read` | Read a wiki article by ID | 0 |
  51. | `paper_search` | Semantic search over 1,200+ research papers | 1 |
  52. | `paper_read` | Read paper sections (intro, methods, conclusion, …) | 0 |
  53. | `crypto_historical_klines` | Crypto OHLCV candlestick data | 1 |
  54. | `crypto_snapshot` | Current crypto price + 24h stats | 0 |
  55. | `polymarket_event_browse` | List or exact-filter finance-scoped Prediction Markets events by keyword, status, tag, asset, volume, and liquidity filters | 1 |
  56. | `polymarket_event_search` | Semantic search over finance-scoped Prediction Markets events | 2 |
  57. | `polymarket_event_read` | Read one Prediction Markets event card with child market previews | 0 |
  58. | `polymarket_market_read` | Read one Prediction Markets market card with outcomes and outcome token ids | 0 |
  59. | `polymarket_price_history` | Hourly or daily implied-probability history for one outcome token | 0 |
  60. | `equity_historical_prices` | US equity daily OHLCV + dividend/split data | 0 |
  61. | `equity_intraday_prices` | US equity 1h regular-session OHLCV bars | 1 |
  62. | `macro_indicator_search` | Browse 50+ curated macro indicators | 0 |
  63. | `macro_indicator_history` | Historical observations for a macro indicator | 1 |
  64. | `macro_indicator_snapshot` | Latest value for a macro indicator | 0 |
  65. | `sec_filing_browse` | Browse SEC 10-K / 10-Q / 8-K filing metadata (each row carries `sectionKeys` = available section codes) | 0 |
  66. | `sec_filing_read` | Read section text from a SEC filing; pass `items` to fetch a batch in one call, omit for all (8-K requires `accession_number` — browse first) | 1 |
  67. | `sec_13f_list_manager_holdings` | List an institutional manager's 13F holdings (covered manager set × at least the last 4 quarters) | 1 |
  68. | `sec_13f_list_ticker_holders` | List institutional holders of a ticker (covered manager set × at least the last 4 quarters) | 1 |
  69. | `sec_13f_list_top_managers` | List the top N smart money managers ranked by 13F reportable value (latest quarter, up to 1000) | 0 |
  70. | `etf_lookup` | ETF fund identity + SEC mapping + top holdings summary (currently supported ETFs) | 0 |
  71. | `etf_holdings` | ETF latest available SEC N-PORT regulatory holdings (currently supported ETFs) | 1* |
  72. | `news_browse` | Browse recent company news by ticker, event, topic, or date | 2 |
  73. | `personal_holdings` | Read the holdings you saved in your LLMQuant Dashboard → Profile (your own account only) | 0 |
  74. | `personal_profile` | Read the financial profile you saved in your LLMQuant Dashboard → Profile (your own account only) | 0 |
  75. <sub>* An unsupported ETF ticker returns `200` with an explicit coverage notice and `0` credits — you are only charged the 1 credit when holdings are actually returned.</sub>
  76. Prediction Markets tools follow an event-first flow: use `polymarket_event_search` first for natural-language discovery, use `polymarket_event_browse` only for list/exact-filter requests, then read a selected event, read a market, and request price history for an outcome token.
  77. > More data products (company fundamentals, earnings transcripts, etc.) are on the [roadmap](#roadmap).
  78. Four ways to access each data product:
  79. <p align="center">
  80. <img src="./assets/data-access.png" alt="Four data access patterns — source data, semantic search, PageIndex tree, knowledge graph" width="720" />
  81. </p>
  82. ## Try It Out
  83. Launch the [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector) to explore tools interactively in your browser:
  84. ```bash
  85. export LLMQUANT_API_KEY=your_api_key
  86. npx @modelcontextprotocol/inspector npx -y @llmquant/data-mcp
  87. ```
  88. > [!NOTE]
  89. > To persist the key, add `export LLMQUANT_API_KEY=your_api_key` to your `~/.zshrc` or `~/.bashrc`.
  90. <p align="center">
  91. <img src="./assets/mcp-inspector.png" alt="MCP Inspector — interactively test tools in your browser" width="720" />
  92. </p>
  93. > [!TIP]
  94. > You'll need an API key — sign up free at [llmquantdata.com](https://llmquantdata.com).
  95. ## Quick Install (Prompt)
  96. The fastest way: drop this prompt into Claude Code, Cursor, Codex CLI, Gemini CLI, or any MCP-enabled agent. The agent will read this README and run the right setup for its runtime.
  97. ```text
  98. Install the LLMQuant data-mcp server in this environment by following https://github.com/LLMQuant/data-mcp
  99. ```
  100. > [!TIP]
  101. > Make sure `LLMQUANT_API_KEY` is exported in the shell where the agent runs. Get a key at [llmquantdata.com](https://llmquantdata.com).
  102. Prefer to set it up by hand? See [Client Setup](#client-setup) below.
  103. ## Client Setup
  104. ### Claude Code
  105. ```bash
  106. claude mcp add llmquant-data \
  107. -e LLMQUANT_API_KEY=your_api_key \
  108. -- npx -y @llmquant/data-mcp
  109. ```
  110. ### Cursor
  111. Add to `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global):
  112. ```json
  113. {
  114. "mcpServers": {
  115. "llmquant-data": {
  116. "command": "npx",
  117. "args": ["-y", "@llmquant/data-mcp"],
  118. "env": {
  119. "LLMQUANT_API_KEY": "your_api_key"
  120. }
  121. }
  122. }
  123. }
  124. ```
  125. ### Codex CLI
  126. ```bash
  127. codex mcp add llmquant-data \
  128. --env LLMQUANT_API_KEY=your_api_key \
  129. -- npx -y @llmquant/data-mcp
  130. ```
  131. ### Gemini CLI
  132. ```bash
  133. gemini mcp add -s user \
  134. -e LLMQUANT_API_KEY=your_api_key \
  135. llmquant-data \
  136. npx -y @llmquant/data-mcp
  137. ```
  138. ### Other MCP Clients
  139. Any client supporting stdio transport can use this JSON config:
  140. ```json
  141. {
  142. "mcpServers": {
  143. "llmquant-data": {
  144. "command": "npx",
  145. "args": ["-y", "@llmquant/data-mcp"],
  146. "env": {
  147. "LLMQUANT_API_KEY": "your_api_key"
  148. }
  149. }
  150. }
  151. }
  152. ```
  153. > [!NOTE]
  154. > We're working on integration guides for more clients. If your agent framework isn't listed, [open an issue](https://github.com/LLMQuant/data-mcp/issues) and we'll add it.
  155. ## Remote / Hosted MCP
  156. `@llmquant/data-mcp` keeps local `stdio` as the default setup path. Signed-in LLMQuant users can also generate a hosted Remote MCP connector URL from the dashboard. Hosted connectors are useful when your MCP client supports remote connectors and you do not want to run a local Node.js process.
  157. ### Claude custom connectors
  158. In the LLMQuant dashboard, open **Connect** and generate a Remote MCP URL.
  159. ```text
  160. https://mcp.llmquantdata.com/u/lqd_mcp_.../mcp
  161. ```
  162. Paste the full URL into Claude's custom connector flow. The hosted URL is separate from your local `LLMQUANT_API_KEY` and can be revoked from the dashboard.
  163. > [!IMPORTANT]
  164. > Treat the hosted connector URL like a password. Anyone with the URL can use the connector until you revoke it.
  165. ## Environment Variables
  166. | Variable | Required | Default | Description |
  167. |----------|----------|---------|-------------|
  168. | `LLMQUANT_API_KEY` | Yes for stdio | — | User API key for local stdio mode |
  169. | `LLMQUANT_BASE_URL` | No | `https://api.llmquantdata.com` | API base URL |
  170. | `LLMQUANT_API_TIMEOUT_MS` | No | `15000` | Request timeout in ms (max 120000) |
  171. ## Roadmap
  172. - [x] Streamable HTTP transport (remote MCP without local Node.js)
  173. - [ ] OAuth connector flow for Claude Connectors Directory
  174. - [ ] More data products — company fundamentals, earnings transcripts
  175. - [x] Agent skills companion catalog ([LLMQuant/skills](https://github.com/LLMQuant/skills))
  176. - [ ] Integration guides for more agent frameworks
  177. Have a feature request? [Open an issue](https://github.com/LLMQuant/data-mcp/issues) or email us at **contact@llmquant.com**.
  178. ## See Also
  179. - **[Awesome Trading Agents](https://github.com/LLMQuant/awesome-trading-agents)** — community-curated agent recipes that turn `data-mcp` tools into end-to-end research workflows (equity research, macro briefings, smart-money digests).
  180. - **[Documentation](https://docs.llmquantdata.com)** — full API reference, MCP setup guides, and credit policy.
  181. ## Contributing
  182. This repository is a **read-only mirror**. We do not accept pull requests.
  183. Found a bug or have a feature request? Please [open an issue](https://github.com/LLMQuant/data-mcp/issues) — we actively triage and respond.
  184. ## License
  185. [MIT](./LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.