{
  "markdown": "# Twelve Data MCP Server\n\nConnect Claude, ChatGPT, and other AI assistants to the [Twelve Data](https://twelvedata.com) financial API — real-time and historical prices, 60+ technical indicators, fundamentals, earnings, dividends, ETFs, company news, market movers, and more.\n\nYou need a Twelve Data account. Sign up at [twelvedata.com](https://twelvedata.com).\n\nThere are two ways to use it. **Most people should use the cloud server (Option 1)** — there is nothing to install.\n\n---\n\n## Option 1 — Use our cloud server (recommended)\n\nConnect your AI assistant to our hosted server:\n\n```\nhttps://mcp.twelvedata.com/mcp\n```\n\nThat's it. No installation, no API key to copy and paste. When you connect, a browser window opens and you log in with your Twelve Data account — your personal API key is linked automatically and stays tied to your account.\n\n### How to add it\n\n**Claude (Desktop / Web) and ChatGPT** support custom connectors / MCP servers:\n\n1. Open your assistant's **Connectors** (or **Integrations** / **MCP servers**) settings.\n2. Add a new connector with the URL `https://mcp.twelvedata.com/mcp`.\n3. When prompted, click **Connect / Log in** — a Twelve Data login page opens in your browser.\n4. Authorize, and you're done. Ask things like *\"What's the RSI for AAPL?\"* or *\"Show me TSLA's latest earnings.\"*\n\n> The exact menu names differ between apps and versions, but the flow is always the same: add the URL, then log in via the browser popup.\n\n---\n\n## Option 2 — Run it locally with your API key\n\nPrefer to run the server on your own machine (e.g. for Claude Desktop over stdio)? You only need your **Twelve Data API key** — no OAuth setup.\n\n### 1. Get your API key\n\nLog in at [twelvedata.com](https://twelvedata.com) → your dashboard → **API Keys**. Copy your key.\n\n### 2. Install\n\nRequires **Python 3.10+** (3.12 recommended; on macOS `brew install python@3.12` or `make python-install`).\n\n```bash\nmake install\n```\n\n### 3. Add your API key\n\nCreate a `.env` file in the project root with your key:\n\n```bash\nTWELVE_DATA_API_KEY=your_api_key_here\n```\n\n### 4. Connect to Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"twelvedata\": {\n      \"command\": \"/path/to/twelve-data-mcp/.venv/bin/python\",\n      \"args\": [\"/path/to/twelve-data-mcp/src/server.py\"]\n    }\n  }\n}\n```\n\nUse the `.venv/bin/python` path (not the system Python — macOS ships 3.9, and this server needs 3.10+). Restart Claude Desktop after editing the config.\n\nThat's all — the server reads your API key from `.env` and every request uses it. No login step needed.\n\n---\n\n## What you can ask\n\n- **Prices** — stocks, ETFs, forex, crypto, commodities (real-time & historical)\n- **Technical indicators** — RSI, MACD, SMA, BBANDS, ATR, and 60+ more\n- **Fundamentals** — financial statements, earnings, dividends, splits, company profiles, market cap, key stats, IPO calendar\n- **Funds** — ETF & mutual fund profiles, performance, holdings, risk\n- **News** — company news & press releases\n- **Market intelligence** — movers, exchange rates, analyst ratings, price targets\n- **Regulatory** — SEC/EDGAR filings, insider transactions, institutional holdings\n\nSymbol formats: stocks `AAPL`, crypto `BTC/USD`, forex `EUR/USD`.\n\n---\n\n## Partners\n\nRunning your own public instance or setting up a dedicated OAuth login? That's a\npartner arrangement — reach out to us at [twelvedata.com](https://twelvedata.com)\nand we'll provide the setup guide and OAuth credentials.\n",
  "bytes": 3506,
  "sha": "58efba0ee0c09d9812399c7508bca09808dd244a1226df2b463f3d25633a21bf",
  "repo_slug": "twelvedata/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_twelvedata_mcp_96078ebc/readme"
}