Secure Open Finance Brasil MCP server with typed tools and a credential-free mock mode
Connect Runs on your machine
claude mcp add openfinance-br-mcp -e ENVIRONMENT=<ENVIRONMENT> -e CLIENT_ID=<CLIENT_ID> -e PRIVATE_KEY_PATH=<PRIVATE_KEY_PATH> -e PRIVATE_KEY_KID=<PRIVATE_KEY_KID> -e MTLS_CERT_PATH=<MTLS_CERT_PATH> -e MTLS_KEY_PATH=<MTLS_KEY_PATH> -e REDIS_URL=<REDIS_URL> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx openfinance-br-mcp==0.2.0
{
"mcpServers": {
"openfinance-br-mcp": {
"command": "uvx",
"args": [
"openfinance-br-mcp==0.2.0"
],
"env": {
"ENVIRONMENT": "<ENVIRONMENT>",
"CLIENT_ID": "<CLIENT_ID>",
"PRIVATE_KEY_PATH": "<PRIVATE_KEY_PATH>",
"PRIVATE_KEY_KID": "<PRIVATE_KEY_KID>",
"MTLS_CERT_PATH": "<MTLS_CERT_PATH>",
"MTLS_KEY_PATH": "<MTLS_KEY_PATH>",
"REDIS_URL": "<REDIS_URL>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}
{
"mcpServers": {
"openfinance-br-mcp": {
"command": "uvx",
"args": [
"openfinance-br-mcp==0.2.0"
],
"env": {
"ENVIRONMENT": "<ENVIRONMENT>",
"CLIENT_ID": "<CLIENT_ID>",
"PRIVATE_KEY_PATH": "<PRIVATE_KEY_PATH>",
"PRIVATE_KEY_KID": "<PRIVATE_KEY_KID>",
"MTLS_CERT_PATH": "<MTLS_CERT_PATH>",
"MTLS_KEY_PATH": "<MTLS_KEY_PATH>",
"REDIS_URL": "<REDIS_URL>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}
{
"servers": {
"openfinance-br-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"openfinance-br-mcp==0.2.0"
],
"env": {
"ENVIRONMENT": "<ENVIRONMENT>",
"CLIENT_ID": "<CLIENT_ID>",
"PRIVATE_KEY_PATH": "<PRIVATE_KEY_PATH>",
"PRIVATE_KEY_KID": "<PRIVATE_KEY_KID>",
"MTLS_CERT_PATH": "<MTLS_CERT_PATH>",
"MTLS_KEY_PATH": "<MTLS_KEY_PATH>",
"REDIS_URL": "<REDIS_URL>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
ENVIRONMENTOptional | 'mock' (default, no credentials needed - runs entirely in-memory), 'sandbox', or 'production' |
CLIENT_IDOptional | Client ID registered with the participating institution. Required unless ENVIRONMENT=mock |
PRIVATE_KEY_PATHOptional | Path to the RSA private key used for private_key_jwt and JAR signing outside mock mode |
PRIVATE_KEY_KIDOptional | Key ID matching the registered client JWKS entry outside mock mode |
MTLS_CERT_PATHOptional | Path to the client mTLS certificate used outside mock mode |
MTLS_KEY_PATHOptional | Path to the client mTLS private key used outside mock mode |
REDIS_URLOptional, secret | Optional Redis connection URL for persistent consent and token state |
ANTHROPIC_API_KEYOptional, secret | Required only when calling list_transactions with categorize=true (DSPy transaction categorization) |
Details
| Package | [email protected] (PYPI, stdio) |
| First published | 17 Jul 2026 |
| Last updated | 17 Jul 2026 |
| Registry name | io.github.brunovicco/openfinance-br-mcp |
More finance and crypto servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
