Openfinance BR MCP Server

by brunoviccoio.github.brunovicco/openfinance-br-mcpv0.2.0

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

1Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained3mo ago

Install Openfinance BR MCP server

claude mcp add openfinance-br -e REDIS_URL='<redis-url>' -e ANTHROPIC_API_KEY='<anthropic-api-key>' -- uvx openfinance-br-mcp

{
  "mcpServers": {
    "openfinance-br": {
      "command": "uvx",
      "args": [
        "openfinance-br-mcp"
      ],
      "env": {
        "REDIS_URL": "<redis-url>",
        "ANTHROPIC_API_KEY": "<anthropic-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "openfinance-br": {
      "command": "uvx",
      "args": [
        "openfinance-br-mcp"
      ],
      "env": {
        "REDIS_URL": "<redis-url>",
        "ANTHROPIC_API_KEY": "<anthropic-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "openfinance-br": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "openfinance-br-mcp"
      ],
      "env": {
        "REDIS_URL": "<redis-url>",
        "ANTHROPIC_API_KEY": "<anthropic-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "openfinance-br": {
      "command": "uvx",
      "args": [
        "openfinance-br-mcp"
      ],
      "env": {
        "REDIS_URL": "<redis-url>",
        "ANTHROPIC_API_KEY": "<anthropic-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

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

Freshness

Maintained — last maintenance signal 3mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-07-17 · 3mo ago · GitHub
Latest release
2026-07-17 · 3mo ago · GitHub · v0.2.0
Package published
no data · npm/PyPI
Registry entry updated
2026-07-17 · 3mo ago · official registry · v0.2.0

FAQ

›How do I install the Openfinance BR MCP server in Claude Code?

Run: claude mcp add openfinance-br -e REDIS_URL='<redis-url>' -e ANTHROPIC_API_KEY='<anthropic-api-key>' -- uvx openfinance-br-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Openfinance BR require an API key?

Yes. It expects REDIS_URL, ANTHROPIC_API_KEY, of which 2 are secrets.

›Can I use Openfinance BR as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Openfinance BR in the official MCP registry?

Yes, as io.github.brunovicco/openfinance-br-mcp.