Tesouro Direto MCP Server

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

FAQ from Tesouro Direto MCP Server

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.