About Renda Fixa
Renda Fixa is an API and MCP server for comparing Brazilian fixed-income securities. It covers products from banks and brokerages, with net-of-tax returns and projected real returns calculated from Boletim Focus data.
Key features
- 01Search multiple fixed-income products
- 02Rank by net return, real gain, maturity, or minimum investment
- 03Filter by issuer, tax status, and FGC coverage
- 04Export results as JSON or CSV
- 05Daily data updates
Use cases
- 01Compare tax-exempt bonds with FGC coverage
- 02Find bonds by maturity or minimum investment
- 03Load bond listings into a spreadsheet
MCP support
The remote MCP server at https://rendafixa.api.br/mcp exposes search_bonds and list_issuers. MCP clients can filter and rank bonds; without a key, results are limited to a preview.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://rendafixa.api.br/mcpclaude mcp add --transport http br-api-rendafixa-renda-fixa https://rendafixa.api.br/mcp{"mcpServers":{"br-api-rendafixa-renda-fixa":{"type":"http","url":"https://rendafixa.api.br/mcp"}}}Open in Cursor{"servers":{"br-api-rendafixa-renda-fixa":{"type":"http","url":"https://rendafixa.api.br/mcp"}}}Open in VS Code{"mcpServers":{"br-api-rendafixa-renda-fixa":{"type":"http","url":"https://rendafixa.api.br/mcp"}}}{"mcpServers":{"br-api-rendafixa-renda-fixa":{"serverUrl":"https://rendafixa.api.br/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://rendafixa.api.br/mcpAuth requiredTools
2| Parameter | Type | Required | Description |
|---|---|---|---|
| fgc | boolean | No | true: only bonds covered by the FGC guarantee (up to R$ 250,000 per CPF per institution). |
| bank | array | No | Issuer/broker codes, as listed by list_issuers (e.g. 341 Itaú, 77 Inter, 208 BTG). |
| index | array | No | Indexers: cdi* (% of CDI), cdi+ (CDI + spread), ipca*, ipca+ (IPCA + spread), selic*, selic+, pre (fixed rate). |
| limit | integer | No | How many bonds to return (max 50). |
| product | array | No | Product types: cdb, lci, lca, cri, cra, deb (debênture), tpf/td (Tesouro Direto), lf (letra financeira), misc. |
| sort_by | enum | No | net_return / real_return: highest first. maturity: soonest first. min_investment: lowest first.net_return | real_return | maturity | min_investment |
| tax_free | boolean | No | true: only IR-exempt bonds (LCI, LCA, CRI, CRA, incentivized debêntures). false: only taxed ones. |
| max_years | number | No | Only bonds maturing within this many years from today. |
| max_min_investment | number | No | Only bonds whose minimum investment is at most this amount in BRL. |
Details
From the project READMERenda Fixa API
Títulos de renda fixa do Brasil em uma chamada — CDB, LCI, LCA, CRI, CRA, debêntures e Tesouro Direto de vários bancos e corretoras, com retorno líquido após IR e ganho real acima do IPCA já calculados a partir das projeções do Boletim Focus (Banco Central). Atualizado diariamente.
- REST/JSON —
GET https://rendafixa.api.br/api/ - CSV para planilhas — Google Sheets e Excel, sem programar
- Servidor MCP — use no Claude, ChatGPT, Cursor e outros assistentes de IA
- OpenAPI 3.1 —
openapi.json
📖 Documentação: https://rendafixa.api.br/docs/api · 💳 Planos: https://rendafixa.api.br/pricing
Experimente agora (sem chave)
Sem chave, a API responde com uma prévia de 5 títulos:
curl "https://rendafixa.api.br/api/"
{
"response": { "status": "preview", "description": "No API key provided. Showing up to 5 bonds as a preview." },
"bonds": [
{
"name": "CDB 360 DIAS",
"bank": 77,
"bank_name": "Banco Inter",
"product": "cdb",
"index": "cdi*",
"rate": 1.05,
"fgc_protection": true,
"tax_free": false,
"min_investment": 100,
"maturity_date": "2027-05-08",
"rating": "AA+",
"net_annualized_return": 0.1165,
"real_annualized_return": 0.0676
}
]
}
Com uma chave de uma conta com assinatura ativa, a resposta traz todos os títulos. Gere a sua em rendafixa.api.br/user/api-keys.
curl -H "Authorization: Bearer rf_SUA_CHAVE" \
"https://rendafixa.api.br/api/?product=lci,lca&tax_free=1&fgc=1"
Filtros
| Parâmetro | Valores | |
|---|---|---|
product | cdb, lci, lca, cri, cra, deb, tpf, td, lf, misc | lista separada por vírgula |
index | cdi*, cdi+, ipca*, ipca+, selic*, selic+, pre | codifique + como %2B |
bank | códigos numéricos | ex.: 341 Itaú, 77 Inter, 208 BTG |
tax_free | 0 / 1 | só tributados / só isentos de IR |
fgc | 0 / 1 | sem / com cobertura do FGC |
format | json / csv |
Taxas e retornos são decimais: 0.1165 = 11,65% a.a. Detalhes de cada campo e de como os retornos são calculados estão na documentação.
Exemplos
Os títulos isentos de IR que mais rendem, sem nenhuma dependência:
- Python:
examples/python/melhores_isentos.py - JavaScript (Node 18+):
examples/javascript/melhores-isentos.mjs
RENDAFIXA_KEY=rf_SUA_CHAVE python examples/python/melhores_isentos.py
Planilhas
Google Sheets (planilha em português):
=IMPORTDATA("https://rendafixa.api.br/api/?format=csv&locale=pt-BR&key=rf_SUA_CHAVE")
Em uma planilha em inglês, tire o &locale=pt-BR. Os filtros funcionam na mesma URL: &product=lci,lca&tax_free=1.
Excel: Dados → Da Web → cole a URL acima.
Assistentes de IA (MCP)
A API também é um servidor MCP remoto: https://rendafixa.api.br/mcp. Depois de adicionado, é só perguntar — "qual LCI com FGC rende mais em até 2 anos?".
Claude Code
claude mcp add --transport http rendafixa https://rendafixa.api.br/mcp \
--header "Authorization: Bearer rf_SUA_CHAVE"
Cursor (.cursor/mcp.json) e outros clientes com configuração em JSON
{
"mcpServers": {
"rendafixa": {
"url": "https://rendafixa.api.br/mcp",
"headers": { "Authorization": "Bearer rf_SUA_CHAVE" }
}
}
}
Claude.ai e ChatGPT (conectores personalizados, que aceitam só uma URL): https://rendafixa.api.br/mcp?key=rf_SUA_CHAVE
Ferramentas: search_bonds (filtra e ordena por retorno líquido, ganho real, vencimento ou aplicação mínima) e list_issuers (bancos e códigos). Sem chave, a prévia.
Licença
Os exemplos deste repositório são MIT. O uso da API está sujeito aos planos e termos do Renda Fixa.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.