Tesouro Direto, dentro da sua IA.

O que é MCP?

Model Context Protocol é um padrão aberto para que assistentes de IA descubram e chamem ferramentas externas. Aqui, o assistente passa a conseguir precificar títulos, listar catálogo e consultar dias úteis sem precisar implementar nada disso.

Claude Desktop

Pela interface

No Claude Desktop, abra Personalizar (Customize) → Conectores (Connectors) → adicione um novo conector com o nome que preferir e a URL: https://mcp.tesouroemfoco.com/mcp.

Pelo arquivo

Edite o arquivo de configuração diretamente no disco:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "tesouro-em-foco": {
      "url": "https://mcp.tesouroemfoco.com/mcp"
    }
  }
}

Reinicie o Claude Desktop. As tools aparecem no menu de ferramentas.

Claude Code

No terminal (na pasta do projeto ou em qualquer diretório, conforme a CLI), registre o servidor remoto por HTTP:

claude mcp add --transport http tesouro-em-foco https://mcp.tesouroemfoco.com/mcp

O nome tesouro-em-foco é só um identificador local — pode trocar por outro rótulo se preferir.

Cursor

Edite ~/.cursor/mcp.json (ou pelo Settings → MCP):

{
  "mcpServers": {
    "tesouro-em-foco": {
      "url": "https://mcp.tesouroemfoco.com/mcp"
    }
  }
}

Gemini CLI

Edite ~/.gemini/settings.json e inclua (ou mescle dentro do objeto existente) o bloco mcpServers — não substitua o arquivo inteiro se já houver outras chaves.

{
  "mcpServers": {
    "tesouro-em-foco": {
      "url": "https://mcp.tesouroemfoco.com/mcp"
    }
  }
}

Se mcpServers já existir, acrescente apenas a entrada tesouro-em-foco ao objeto, preservando os demais servidores.

Outros clientes

Qualquer cliente MCP que aceite servidor remoto via Streamable HTTP funciona — basta passar a URL https://mcp.tesouroemfoco.com/mcp. O servidor fala JSON-RPC sobre HTTP POST.

Tools disponíveis

• simulate_bond

  Simula compra/venda hipotética de qualquer título do Tesouro Direto. Retorna preço, cotação, duration, cronograma (opcional) e memória de cálculo.

• price_history_lookup

  Consulta pontual em lote — taxa e PU oficiais publicados pelo Tesouro Transparente em datas específicas (desde 2002). Cobre 8 famílias, incluindo Selic e IGPM+.

• price_history_series

  Série temporal ou estatísticas agregadas (min/max/média) de um título em uma janela de datas. Suporta sub-amostragem diária, semanal ou mensal.

• live_quotes_lookup

  Cotações vivas (compra/venda atuais) do site do Tesouro Direto, atualizadas a cada 30 min — dataset diferente do histórico STN. Use para 'qual a taxa agora?'.

• catalog_list

  Lista todos os títulos ativos por família — vencimentos, datas de lançamento e (Renda+/Educa+) datas de conversão.

Convenção de formato

Todo campo de taxa em qualquer tool (annualRate de entrada e rate de saída) é uma fração decimal como string — '0.0737' significa 7,37% a.a., '0.0005' significa 0,05% a.a. Mesma convenção em simulate_bond, price_history_* e live_quotes_lookup — nunca precisa converter ao encadear uma tool na outra.