bond_data
Retrieves detailed data for a specific bond from Tesouro Direto
LABSCO SUMMARY
Treasury-bond questions get answered from the day's actual figures instead of a half-remembered rate.
The sequence the tool list implies is the useful one: filter by type and maturity window, then take the code that comes back into bond_data for the detail. market_data is the sanity check around both, since opening and closing times decide whether the numbers you are reading are current. Nothing here writes, so this is a source to quote from rather than a place anything can be changed.
What it is
A read-only feed of Tesouro Direto market and bond data, in 3 tools.
What you get
- search_bonds narrows the list by type — ANY, SELIC, IPCA or PREFIXADO — and by a maturity window set with maturityAfter and maturityBefore.
- bond_data returns the detailed record for one bond, addressed by its code.
- market_data returns general market data including opening and closing times and the current status.
Requirements
One environment variable, USE_MCP_CACHE, and no account or key. The AGPL-3.0 license carries into whatever you distribute on top of it.
Setup effort
One command — npx -y tesouro-direto-mcp
USE CASES
01
Choosing a bond that matures when the money is needed
Filter by bond type and the maturity window that matches the goal, then take the code that comes back into the detailed record.
02
Checking whether the market is open before quoting a price
Read the market status and its opening and closing times before treating any figure as current.
3 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
market_data
Retrieves general market data from Tesouro Direto, including opening/closing times and status
search_bonds
Search for bonds by type (ANY,SELIC, IPCA, PREFIXADO) or maturity date range
BEFORE YOU INSTALL
What to know first
Tools you get
3 tools when we connected.
Requires
- npx on PATH
- USE_MCP_CACHE in your environment
CONTEXT COST
Light Standing cost
Rated by the size of the 3 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"tesouro-direto": {
"command": "npx",
"args": [
"-y",
"tesouro-direto-mcp"
],
"env": {
"USE_MCP_CACHE": "true"
}
}
}
}npx
TERMINAL
npx -y tesouro-direto-mcp
