Tesouro Direto MCP Server

@AtilioA

Repository Homepage

Basic information

About Tesouro Direto MCP Server

🗣️ Query Brazilian treasury bond data with natural language

#mcp#tesouro-direto#treasury-bonds#mcp-server

Tesouro Direto MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "tesouro-direto-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@AtilioA/tesouro-direto-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

Tesouro Direto MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Tesouro Direto MCP Server?

A Model Context Protocol (MCP) server that integrates with the Tesouro Direto API, enabling natural language access to Brazilian treasury bond data through MCP-compatible clients.

How to use Tesouro Direto MCP Server?

Install automatically via Smithery (npx -y @smithery/cli install @AtilioA/tesouro-direto-mcp --client claude) or via npm (npx -y tesouro-direto-mcp). Configure in your MCP client’s JSON file (e.g., ~/.cursor/mcp.json or claude_desktop_config.json) using the command npx -y tesouro-direto-mcp and optionally set USE_MCP_CACHE to "true". You can also build from source with pnpm install && pnpm run build.

Key features of Tesouro Direto MCP Server

Three MCP tools: market_data, bond_data, and search_bonds
Smart 10-minute in-memory cache based on API update timestamps
Search and filter bonds by type, maturity, or other criteria
Retrieve detailed information about a specific bond
Get general treasury bond market status (opening/closing times)

Use cases of Tesouro Direto MCP Server

Show all available Tesouro Direto bonds using natural language
Get detailed information on a specific bond (e.g., IPCA+ 2029)
Search for bonds by type (SELIC, IPCA, PREFIXADO) and maturity date
Check current treasury bond market status (opening/closing times)
Analyze top bonds with highest yields across different bond types

Frequently asked questions

Which MCP-compatible clients can use Tesouro Direto MCP Server?

It works with Claude Desktop (via Smithery), Cursor, and any MCP-compatible client such as MCP Inspector.

How does caching work?

A 10-minute in-memory cache reduces API calls while ensuring data freshness. It is enabled by default and controlled by the `USE_MCP_CACHE` environment variable.

What environment variable controls caching?

`USE_MCP_CACHE` – set it to `"true"` (or omit, as it defaults to `true`) to enable the cache.

How to build from source?

Clone the repository, run `pnpm install` to install dependencies, then `pnpm run build` to compile. The built server can be run with `node dist/index.js`.

What is the license?

Tesouro Direto MCP Server is licensed under the GNU Affero General Public License v3.0.

Comments

More Other MCP servers

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea