MCP.so
Sign In

Tesouro Direto MCP Server

@AtilioA

Basic information

Category

Other

License

AGPL-3.0

Transports

stdio

Author

AtilioA

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

1

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.

2

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.

3

What environment variable controls caching?

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

4

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`.

5

What is the license?

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

Comments

More Other MCP servers