MCP server for BTG Pactual — Pix, Boleto, Account, Investments (CDB/LCI/LCA/funds), OAuth2 + mTLS
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add btg --env BTG_CLIENT_ID='<BTG_CLIENT_ID>' --env BTG_CLIENT_SECRET='<BTG_CLIENT_SECRET>' --env BTG_CERT_PATH='<BTG_CERT_PATH>' --env BTG_KEY_PATH='<BTG_KEY_PATH>' -- npx -y @codespar/mcp-btg~/.codex/config.toml
[mcp_servers.btg]
command = "npx"
args = ["-y", "@codespar/mcp-btg"]
env = { BTG_CLIENT_ID = "<BTG_CLIENT_ID>", BTG_CLIENT_SECRET = "<BTG_CLIENT_SECRET>", BTG_CERT_PATH = "<BTG_CERT_PATH>", BTG_KEY_PATH = "<BTG_KEY_PATH>" }
# codex mcp add btg --env BTG_CLIENT_ID='<BTG_CLIENT_ID>' --env BTG_CLIENT_SECRET='<BTG_CLIENT_SECRET>' --env BTG_CERT_PATH='<BTG_CERT_PATH>' --env BTG_KEY_PATH='<BTG_KEY_PATH>' -- npx -y @codespar/mcp-btg~/.cursor/mcp.json
{
"mcpServers": {
"btg": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-btg"
],
"env": {
"BTG_CLIENT_ID": "<BTG_CLIENT_ID>",
"BTG_CLIENT_SECRET": "<BTG_CLIENT_SECRET>",
"BTG_CERT_PATH": "<BTG_CERT_PATH>",
"BTG_KEY_PATH": "<BTG_KEY_PATH>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"btg": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-btg"
],
"env": {
"BTG_CLIENT_ID": "<BTG_CLIENT_ID>",
"BTG_CLIENT_SECRET": "<BTG_CLIENT_SECRET>",
"BTG_CERT_PATH": "<BTG_CERT_PATH>",
"BTG_KEY_PATH": "<BTG_KEY_PATH>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"btg": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-btg"
],
"env": {
"BTG_CLIENT_ID": "<BTG_CLIENT_ID>",
"BTG_CLIENT_SECRET": "<BTG_CLIENT_SECRET>",
"BTG_CERT_PATH": "<BTG_CERT_PATH>",
"BTG_KEY_PATH": "<BTG_KEY_PATH>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"btg": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-btg"
],
"env": {
"BTG_CLIENT_ID": "<BTG_CLIENT_ID>",
"BTG_CLIENT_SECRET": "<BTG_CLIENT_SECRET>",
"BTG_CERT_PATH": "<BTG_CERT_PATH>",
"BTG_KEY_PATH": "<BTG_KEY_PATH>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"btg": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-btg"
],
"env": {
"BTG_CLIENT_ID": "<BTG_CLIENT_ID>",
"BTG_CLIENT_SECRET": "<BTG_CLIENT_SECRET>",
"BTG_CERT_PATH": "<BTG_CERT_PATH>",
"BTG_KEY_PATH": "<BTG_KEY_PATH>"
}
}
}
}Environment variables
BTG_CLIENT_IDBTG_CLIENT_SECRETBTG_CERT_PATHBTG_KEY_PATH
Replace the placeholders with your own credentials and keep them out of version control.