# mcp

Streams live stock, crypto, and forex market feeds to your AI assistant. Useful for checking technical indicators, corporate earnings, and recent trends in chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 84
- Author: twelvedata
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/twelvedata/mcp
- Updated: 2026-10-01
- HTML: https://affpapa.org/en/nevibecode/mcp/twelvedata-mcp

## What it does

The server links financial market data from Twelve Data with your assistant. It exposes real-time rates for equities, foreign exchange pairs, and digital assets. The tool also pulls price history, corporate earnings, dividend data, market headlines, and over 60 technical indicators.

Setup comes in two variants. The hosted endpoint at `https://mcp.twelvedata.com/mcp` works without local packages. It authenticates through a browser prompt via OAuth, linking your personal key automatically. The self-hosted route requires Python 3.10 or newer and a local `.env` file holding `TWELVE_DATA_API_KEY`. It communicates over standard I/O or an HTTP server on port 8000. Docker is supported too.

By default, the local HTTP process binds to `0.0.0.0` without access control, which risks exposing your credential across your network. Setting `MCP_HOST=127.0.0.1` keeps the traffic strictly local.

## Requirements
- Remote server: `https://mcp.twelvedata.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.twelvedata.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add twelvedata-mcp --url https://mcp.twelvedata.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "twelvedata-mcp": {
            "url": "https://mcp.twelvedata.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "twelvedata-mcp": {
            "type": "http",
            "url": "https://mcp.twelvedata.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http twelvedata-mcp https://mcp.twelvedata.com/mcp
```

## When to use it
- Fetch live market quotes for equities, forex pairs, and crypto
- Calculate technical indicators such as RSI directly in your prompt
- Check corporate earnings releases and dividend schedules
- Track current market headlines and top asset movers

## Example prompts
- Use Twelve Data to get the latest quote and volume for AAPL.
- Show me TSLA RSI using Twelve Data.
- Check recent earnings and news for NVDA.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12109
- [mcp · butterbase-ai](https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3031
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2760
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1348
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 691

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
