Skip to content
MCP server

Openfinance Br MCP

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.2.0
Listing updated
6 days ago

About Openfinance Br MCP

Openfinance Br MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add openfinance-br-mcp --env REDIS_URL='<REDIS_URL>' --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' -- uvx openfinance-br-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • ENVIRONMENT'mock' (default, no credentials needed - runs entirely in-memory), 'sandbox', or 'production'
  • CLIENT_IDClient ID registered with the participating institution. Required unless ENVIRONMENT=mock
  • PRIVATE_KEY_PATHPath to the RSA private key used for private_key_jwt and JAR signing outside mock mode
  • PRIVATE_KEY_KIDKey ID matching the registered client JWKS entry outside mock mode
  • MTLS_CERT_PATHPath to the client mTLS certificate used outside mock mode
  • MTLS_KEY_PATHPath to the client mTLS private key used outside mock mode
  • REDIS_URLOptional Redis connection URL for persistent consent and token state
  • ANTHROPIC_API_KEYRequired only when calling list_transactions with categorize=true (DSPy transaction categorization)

Pricing

Open source

Openfinance Br MCP FAQ

Is Openfinance Br MCP free?

Yes. Openfinance Br MCP is open source, so you can use and self-host it for free.

How do I add Openfinance Br MCP to Claude Code?

Run this command in your terminal: claude mcp add openfinance-br-mcp --env REDIS_URL='<REDIS_URL>' --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' -- uvx openfinance-br-mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers