Twelve Data MCP Server

Twelve Data MCP Server

Conecte o Claude, ChatGPT e outros assistentes de IA à API financeira Twelve Data — preços em tempo real e históricos, mais de 60 indicadores técnicos, fundamentos, lucros, dividendos, ETFs, notícias de empresas, maiores movimentações do mercado e muito mais.

Você precisa de uma conta Twelve Data. Cadastre-se em twelvedata.com.

Há duas formas de usar. A maioria das pessoas deve usar o servidor em nuvem (Opção 1) — não há nada para instalar.

---

Opção 1 — Use nosso servidor em nuvem (recomendado)

Conecte seu assistente de IA ao nosso servidor hospedado:

https://mcp.twelvedata.com/mcp

Pronto. Sem instalação, sem chave de API para copiar e colar. Ao conectar, uma janela do navegador se abre e você faz login com sua conta Twelve Data — sua chave de API pessoal é vinculada automaticamente e permanece associada à sua conta.

Como adicionar

Claude (Desktop / Web) e ChatGPT suportam conectores personalizados / servidores MCP:

1. Abra as configurações de Conectores (ou Integrações / Servidores MCP) do seu assistente.
2. Adicione um novo conector com a URL https://mcp.twelvedata.com/mcp.
3. Quando solicitado, clique em Conectar / Fazer login — uma página de login da Twelve Data será aberta no seu navegador.
4. Autorize e pronto. Pergunte coisas como "Qual é o RSI da AAPL?" ou "Mostre os últimos lucros da TSLA."

Os nomes exatos dos menus variam entre aplicativos e versões, mas o fluxo é sempre o mesmo: adicione a URL e faça login pelo pop-up do navegador.

---

Opção 2 — Execute localmente com sua chave de API

Prefere executar o servidor na sua própria máquina (ex.: para Claude Desktop via stdio)? Você só precisa da sua chave de API Twelve Data — sem configuração OAuth.

1. Obtenha sua chave de API

Faça login em twelvedata.com → seu painel → Chaves de API. Copie sua chave.

2. Instale

Requer Python 3.10+ (3.12 recomendado; no macOS brew install [email protected] ou make python-install).

make install

3. Adicione sua chave de API

Crie um arquivo .env na raiz do projeto com sua chave:

TWELVE_DATA_API_KEY=your_api_key_here

4. Conecte ao Claude Desktop

Adicione ao ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "twelvedata": {
      "command": "/path/to/twelve-data-mcp/.venv/bin/python",
      "args": ["/path/to/twelve-data-mcp/src/server.py"]
    }
  }
}

Use o caminho .venv/bin/python (não o Python do sistema — o macOS vem com 3.9, e este servidor precisa da 3.10+). Reinicie o Claude Desktop após editar a configuração.

Isso é tudo — o servidor lê sua chave de API do .env e cada requisição a utiliza. Nenhuma etapa de login necessária.

---

O que você pode perguntar

• Preços — ações, ETFs, forex, criptomoedas, commodities (tempo real e histórico)
• Indicadores técnicos — RSI, MACD, SMA, BBANDS, ATR e mais de 60 outros
• Fundamentos — demonstrações financeiras, lucros, dividendos, desdobramentos, perfis de empresas, valor de mercado, estatísticas principais, calendário de IPOs
• Fundos — perfis de ETFs e fundos mútuos, desempenho, participações, risco
• Notícias — notícias de empresas e comunicados à imprensa
• Inteligência de mercado — maiores movimentações, taxas de câmbio, avaliações de analistas, preços-alvo
• Regulatório — registros na SEC/EDGAR, transações de insiders, participações institucionais

Formatos de símbolos: ações AAPL, criptomoedas BTC/USD, forex EUR/USD.

---

Parceiros

Está executando sua própria instância pública ou configurando um login OAuth dedicado? Esse é um acordo de parceria — entre em contato conosco em twelvedata.com e forneceremos o guia de configuração e as credenciais OAuth.