Twelve Data

Servidor MCP Twelve Data

Conecte 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, movimentadores de mercado e muito mais.

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

Há duas maneiras de usá-lo. 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

É isso. Sem instalação, sem chave de API para copiar e colar. Ao conectar, uma janela do navegador 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 / Entrar — uma página de login da Twelve Data abre no seu navegador.
4. Autorize, e pronto. Pergunte coisas como "Qual é o RSI da AAPL?" ou "Mostre-me os últimos lucros da TSLA."

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

O host MCP não emite tokens. A URL do conector é https://mcp.twelvedata.com/mcp. O cliente deve seguir os metadados de recurso protegido dessa URL até o servidor de autorização indicado nela. Não aponte um conector para a raiz do host (ela responde 404), nem para /register ou /.well-known/oauth-authorization-server deste host.

Perplexity (conector remoto personalizado)

Usuários do Perplexity Pro, Max e Enterprise podem adicionar o servidor hospedado como um conector remoto personalizado. Isso é uma configuração por conta, não uma listagem no diretório público curado do Perplexity.

1. No Perplexity, abra Configurações da conta → Conectores → + Conector personalizado e selecione Remoto. No Enterprise, um administrador pode precisar permitir conectores personalizados primeiro.
2. Defina Nome como Twelve Data e URL do servidor MCP como https://mcp.twelvedata.com/mcp.
3. Escolha OAuth para autenticação e HTTP Streamable para transporte. Deixe o Client ID e o Client Secret em branco para que o Perplexity possa usar o registro dinâmico de clientes no servidor de autorização indicado nos metadados de recurso protegido do servidor.
4. Aceite o aviso de conector personalizado do Perplexity e clique em Adicionar. Em seguida, clique no cartão do conector Twelve Data para iniciar a autenticação, entre na sua conta Twelve Data e autorize o acesso.
5. Depois que o conector estiver habilitado, experimente estes prompts:
   • "Use Twelve Data para encontrar o símbolo da AAPL."
   • "Use Twelve Data para obter a cotação mais recente da AAPL, incluindo preço e volume."
   • "Use Twelve Data para mostrar os últimos cinco preços de fechamento diários da AAPL."
   • "Use Twelve Data para mostrar o RSI da AAPL."

Cada pessoa entra com sua própria conta Twelve Data. Se um administrador do Enterprise compartilhar o conector, exija autenticação individual para cada membro. Não cole uma chave de API Twelve Data no campo de autenticação por chave de API do conector.

Se a janela OAuth for bloqueada, o login falhar ou as ferramentas pararem após um período de inatividade, abra o conector Twelve Data, desative-o, ative-o novamente e entre. Reconecte dessa forma em vez de mudar o conector para autenticação por chave de API. Confirme que a URL é exatamente https://mcp.twelvedata.com/mcp sem barra final e que o plano Twelve Data inclui os dados solicitados. Consulte o guia de conector remoto personalizado do Perplexity para ver as telas de configurações atuais.

Codex (CLI, desktop e IDE)

Adicione o servidor MCP hospedado ao Codex sem instalar este repositório ou copiar uma chave de API:

codex mcp add twelvedata --url https://mcp.twelvedata.com/mcp
codex mcp list

O comando add inicia o OAuth: conclua o login na Twelve Data no seu navegador. Se precisar autorizar novamente mais tarde, execute codex mcp login twelvedata. No Codex, use /mcp para verificar a conexão e depois pergunte: "Use Twelve Data para obter a cotação mais recente da AAPL." e "Use Twelve Data para mostrar o RSI da AAPL." Para desconectar, execute codex mcp remove twelvedata.

O repositório público de plugins é https://github.com/MazeBraker/twelvedata-skills.. Ele instala as habilidades e o mesmo MCP hospedado:

codex plugin marketplace add https://github.com/MazeBraker/twelvedata-skills
codex plugin add twelvedata@twelvedata-skills

---

Opção 2 — Execute você mesmo com uma chave de API

Prefere executar o servidor na sua própria máquina? Você só precisa da sua chave de API Twelve Data — sem configuração OAuth. Obtenha-a em twelvedata.com → seu painel → Chaves de API.

1. Instalação

Requer Python 3.10+ (3.12 recomendado; no macOS brew install python@3.12 ou make python-install).

make install

2. Adicione sua chave de API

Crie um arquivo .env na raiz do projeto com sua chave, legível apenas por você:

echo 'TWELVE_DATA_API_KEY=your_api_key_here' > .env
chmod 600 .env

O servidor lê a chave de .env e cada requisição a utiliza. Nenhuma etapa de login é necessária.

3. Conecte via stdio

Claude Desktop — adicione a ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "twelvedata": {
      "command": "/path/to/mcp/.venv/bin/python",
      "args": ["/path/to/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 de 3.10+). Reinicie o Claude Desktop após editar a configuração.

Claude Code:

claude mcp add twelvedata -- /path/to/mcp/.venv/bin/python /path/to/mcp/src/server.py

4. Conecte via HTTP

make run           # serves http://localhost:8000/mcp

claude mcp add --transport http twelvedata http://localhost:8000/mcp

5. Execute no Docker

docker build -t twelvedata-mcp .
docker run --rm --env-file .env -p 127.0.0.1:8000:8000 twelvedata-mcp

--env-file mantém a chave fora do histórico do shell. Conecte-se a http://localhost:8000/mcp como no passo 4. O login OAuth não é suportado no Docker.

6. Segurança

• make run e Docker servem /mcp sem autenticação, em 0.0.0.0 por padrão.
• Cada chamada é atendida sob sua credencial.
• Qualquer pessoa que alcance a porta pode chamar auth_status e oauth_configure. Isso inclui uma página da web que você abrir, por meio de rebinding de DNS, porque o bind padrão não verifica nem o cabeçalho Host nem o Origin.
• MCP_HOST=127.0.0.1 make run mantém o servidor local e ativa a verificação de Host e Origin do SDK MCP.
• Com MCP_HOST=127.0.0.1, o ngrok funciona apenas quando iniciado com --host-header=rewrite.

7. Solução de problemas

Chame auth_status do seu cliente primeiro. Ele mostra se uma chave de API está configurada, o token armazenado, o host detectado e o URI de redirecionamento — geralmente é suficiente para ver o que está faltando.

---

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, capitalização de mercado, estatísticas-chave, 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 — movimentadores, taxas de câmbio, classificações de analistas, metas de preço
• Regulatório — arquivamentos SEC/EDGAR, transações de insiders, participações institucionais

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

---

Parceiros

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