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, simular resgate e listar o catálogo 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 entradatesouro-em-foco ao objeto, preservando os demais servidores.

Outros clientes

Qualquer cliente MCP que aceite servidor remoto via Streamable HTTP funciona — basta passar a URLhttps://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.

• simulate_redemption

  Simula resgate antecipado: lote histórico (price XOR rate) + venda hipotética (rate). Retorna precificação bruta e netReturns (IOF, IR regressivo, custódia B3) como aplicação das regras — não é aconselhamento.

• price_history_lookup

  Consulta pontual em lote — taxa e preço unitário (PU) oficiais publicados pelo Tesouro Transparente em datas específicas (desde 2002). Cobre famílias do histórico, incluindo Selic e IGPM+.

• price_history_series

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

• price_history_ranking

  Compara títulos do catálogo em uma chamada: para cada papel, onde a taxa mais recente fica na própria história (lastPercentile). Descrição estatística — não é recomendação. Só as seis famílias do catálogo.

• live_quotes_lookup

  Cotações vivas (compra/venda atuais) do site do Tesouro Direto, atualizadas a cada hora na janela BRT de pregão (dias úteis) — 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, simulate_redemption,price_history_*e live_quotes_lookup — nunca precisa converter ao encadear uma tool na outra.