NestDaddy

Openfinance Br Mcp

io.github.brunovicco/openfinance-br-mcp ยท v0.2.0

Secure Open Finance Brasil MCP server with typed tools and a credential-free mock mode

Connect Runs on your machine

Terminal
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
claude_desktop_config.json
{
  "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>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "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>"
      }
    }
  }
}
.vscode/mcp.json
{
  "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

NameDescription
ENVIRONMENT
Optional
'mock' (default, no credentials needed - runs entirely in-memory), 'sandbox', or 'production'
CLIENT_ID
Optional
Client ID registered with the participating institution. Required unless ENVIRONMENT=mock
PRIVATE_KEY_PATH
Optional
Path to the RSA private key used for private_key_jwt and JAR signing outside mock mode
PRIVATE_KEY_KID
Optional
Key ID matching the registered client JWKS entry outside mock mode
MTLS_CERT_PATH
Optional
Path to the client mTLS certificate used outside mock mode
MTLS_KEY_PATH
Optional
Path to the client mTLS private key used outside mock mode
REDIS_URL
Optional, secret
Optional Redis connection URL for persistent consent and token state
ANTHROPIC_API_KEY
Optional, secret
Required only when calling list_transactions with categorize=true (DSPy transaction categorization)

Details

Package[email protected] (PYPI, stdio)
First published17 Jul 2026
Last updated17 Jul 2026
Registry nameio.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.