Openfinance Br MCP

Name: Openfinance Br MCP
Author: brunovicco

โดย brunoviccoรุ่น 0.2.0i★ –iรันบนเครื่อง

ชื่อใน registryio.github.brunovicco/openfinance-br-mcp

ติดตั้ง

ภาพรวม

คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)

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

สามเสาของ PopNx MCP

สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน

เสียงผู้ใช้iยังไม่มีรีวิวรีวิวเปิดพร้อมระบบบัญชีในขั้นถัดไป
ผลตรวจเบื้องต้นของเราiผ่าน 1 จาก 1 ข้อตรวจจากข้อมูลที่เปิดอยู่ ยังไม่ได้สแกนโค้ด
การใช้งานiยังไม่ได้วัด★ –

ใช้ทำอะไรได้

ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry

การเชื่อมต่อ: รันบนเครื่อง
ช่องทาง (transport): stdio
หมวด: บัญชี การเงิน และภาษี
ต้องใส่ค่าเหล่านี้: REDIS_URL, ANTHROPIC_API_KEY

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ก่อนติดตั้ง

ผลตรวจเบื้องต้น: ผ่าน 1 จาก 1 ข้อ
รันในเครื่องคุณด้วยสิทธิ์ของผู้ใช้คุณ (ไฟล์ อินเทอร์เน็ต แอปต่าง ๆ)
ค่าที่คุณต้องใส่เอง: ENVIRONMENT, CLIENT_ID, PRIVATE_KEY_PATH, PRIVATE_KEY_KID, MTLS_CERT_PATH, MTLS_KEY_PATH, REDIS_URL, ANTHROPIC_API_KEY

ค่าที่ติดป้ายความลับคือกุญแจของบัญชีคุณ อย่าส่งให้ใคร และอย่าวางในแชต

ต้องเตรียมก่อน

PyPIติดตั้ง uv ของ Python (มีคำสั่ง uvx) ในเครื่อง

คุณใช้แอปไหน

ClaudeClaude CodeCursorVS CodeChatGPT

เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”

เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json

{
  "mcpServers": {
    "openfinance-br": {
      "command": "uvx",
      "args": [
        "openfinance-br-mcp"
      ],
      "env": {
        "ENVIRONMENT": "ใส่ค่าของคุณ",
        "CLIENT_ID": "ใส่ค่าของคุณ",
        "PRIVATE_KEY_PATH": "ใส่ค่าของคุณ",
        "PRIVATE_KEY_KID": "ใส่ค่าของคุณ",
        "MTLS_CERT_PATH": "ใส่ค่าของคุณ",
        "MTLS_KEY_PATH": "ใส่ค่าของคุณ",
        "REDIS_URL": "ใส่ค่าของคุณ",
        "ANTHROPIC_API_KEY": "ใส่ค่าของคุณ"
      }
    }
  }
}

พิมพ์คำสั่งนี้ใน Terminal

claude mcp add openfinance-br --env ENVIRONMENT='ใส่ค่าของคุณ' --env CLIENT_ID='ใส่ค่าของคุณ' --env PRIVATE_KEY_PATH='ใส่ค่าของคุณ' --env PRIVATE_KEY_KID='ใส่ค่าของคุณ' --env MTLS_CERT_PATH='ใส่ค่าของคุณ' --env MTLS_KEY_PATH='ใส่ค่าของคุณ' --env REDIS_URL='ใส่ค่าของคุณ' --env ANTHROPIC_API_KEY='ใส่ค่าของคุณ' -- uvx openfinance-br-mcp

เติมค่าที่เว้นว่างไว้ก่อนรัน

เปิดใน Cursor

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json

{
  "mcpServers": {
    "openfinance-br": {
      "command": "uvx",
      "args": [
        "openfinance-br-mcp"
      ],
      "env": {
        "ENVIRONMENT": "ใส่ค่าของคุณ",
        "CLIENT_ID": "ใส่ค่าของคุณ",
        "PRIVATE_KEY_PATH": "ใส่ค่าของคุณ",
        "PRIVATE_KEY_KID": "ใส่ค่าของคุณ",
        "MTLS_CERT_PATH": "ใส่ค่าของคุณ",
        "MTLS_KEY_PATH": "ใส่ค่าของคุณ",
        "REDIS_URL": "ใส่ค่าของคุณ",
        "ANTHROPIC_API_KEY": "ใส่ค่าของคุณ"
      }
    }
  }
}

เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง

เปิดใน VS Code

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .vscode/mcp.json ของโปรเจกต์

{
  "servers": {
    "openfinance-br": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "openfinance-br-mcp"
      ],
      "env": {
        "ENVIRONMENT": "ใส่ค่าของคุณ",
        "CLIENT_ID": "ใส่ค่าของคุณ",
        "PRIVATE_KEY_PATH": "ใส่ค่าของคุณ",
        "PRIVATE_KEY_KID": "ใส่ค่าของคุณ",
        "MTLS_CERT_PATH": "ใส่ค่าของคุณ",
        "MTLS_KEY_PATH": "ใส่ค่าของคุณ",
        "REDIS_URL": "ใส่ค่าของคุณ",
        "ANTHROPIC_API_KEY": "ใส่ค่าของคุณ"
      }
    }
  }
}

ตัวนี้รันในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะ server บนอินเทอร์เน็ต ลองเลือกแอปอื่น

ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี

ค่าที่ต้องใส่เอง

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

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

ทำอะไรได้บ้าง

รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 7 พ.ย. 2569

✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub brunovicco ซึ่งเป็นเจ้าของ repo
… ยังไม่ตรวจ
ยังมีคนดูแล
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
… ยังไม่ตรวจ
มีสัญญาอนุญาต (license)
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
– ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
– ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
… ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต

เทียบกับตัวอื่นในหมวด บัญชี การเงิน และภาษีi

ดาวมากกว่า 0% ของอีก 1735 ตัวในหมวดนี้
ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 25% ของอีก 1735 ตัวในหมวดนี้
ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 1735 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

Openfinance Br MCP ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 1 จาก 1 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

ต้องใส่ค่าเหล่านี้: REDIS_URL, ANTHROPIC_API_KEY

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (0.2.0) เข้า registry 4 เดือนที่ผ่านมา

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Python (uv) ในเครื่องด้วย

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี Finance Toolkit, SolidInvoice, Korea Tax Calculator

ตัวที่ใช้แทนได้

server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว

อ่านการ์ด:★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

Finance Toolkit

โดย JerBouma

500+ transparent financial methods calculated from raw statements, not third-party endpoints.

บนเครื่องหรือคลาวด์★ 5,496MITอัปเดต เมื่อวาน

ติดตั้ง

SolidInvoice

โดย SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

รันบนคลาวด์★ 981MITอัปเดต 8 วันที่ผ่านมา

ติดตั้ง

Korea Tax Calculator

โดย UpstageAI

Korean tax calculation and tax-audit judgment MCP: 96 tools with statutory citations.

รันบนเครื่อง★ 97MITอัปเดต เมื่อวาน

ติดตั้ง

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

English · Português

openfinance-br-mcp

Experimental MCP server for Open Finance Brasil, with a complete mock

environment and evolving FAPI-BR integration. It is not certified or

validated against real institutions; see VALIDATION.md

before using it outside environment=mock.

What it is

An MCP Server that abstracts away the complexity of Open Finance Brasil (FAPI 1.0 Advanced, OAuth2, consent, mTLS) and exposes simple tools to Claude:

Claude → "how much did I spend on food in March?"

Claude uses list_transactions(bank=nubank, categorize=true, date_from=2024-03-01) Claude → "You spent R$ 847.30 on food in March..."

Supported banks

The mock environment simulates Nubank, Sicoob, Caixa, Banco do Brasil, Bradesco, Itaú, Santander, XP, PicPay, and BTG Pactual with in-memory data and no network access. These are simulations, not certified integrations.

Real adapters and the Payments API journey are experimental and unvalidated. Payments use the v5 payments-consents/payments-pix Directory families, dedicated per-consent tokens, verified response JWS, PAR/JAR, consent-payload binding, and persistent idempotency. list_pix_keys is a demonstration extension rather than a standardized Open Finance Brasil endpoint. See VALIDATION.md for the exact scope.

Available MCP tools

The server exposes 18 tools grouped by journey:

Accounts: list_accounts, get_balance, list_transactions
Cards: list_credit_cards, get_credit_card_bills
Investments: list_investments, list_funds, list_variable_incomes, list_treasure_titles
PIX: list_pix_keys, initiate_pix
Data consent: start_consent, complete_consent, check_consent_status, revoke_consent
Payment consent: start_payment_consent, complete_payment_consent, check_payment_consent_status

It also exposes the openfinance://banks/ resource, the analyze_monthly_spending prompt, and optional URL elicitation when starting an authorization flow.

Quick start

Prerequisites

Python 3.12 or 3.13
uv installed

# Run the published release in credential-free mock mode

uvx --from openfinance-br-mcp==0.2.0 openfinance-mcp

From source

git clone https://github.com/brunovicco/openfinance-br-mcp.git

cd openfinance-br-mcp

Optional: needed only for sandbox/production or DSPy categorization

cp .env.example .env

Install dependencies

uv sync

Run the server

uv run openfinance-mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

"mcpServers": { "openfinance-br": { "command": "uvx", "args": ["--from", "openfinance-br-mcp==0.2.0", "openfinance-mcp"] } } }

Development

# Install with dev-dependencies

uv sync

Run the tests

uv run pytest tests/ -v

Lint and formatting

uv run ruff check src/ tests/ uv run black src/ tests/

Type check

uv run mypy src/

Containers and Kubernetes

docker compose up openfinance-mcp

docker compose --profile test up

The k8s/ directory contains a two-replica Streamable HTTP example with Redis-backed state. Replace every credential, signing-key, OAuth issuer, resource-server, and domain placeholder before applying it. The server fails closed when HTTP is exposed outside loopback without MCP client OAuth.

Architecture

Claude (MCP Client)

│ stdio or streamable-http ▼ openfinance-br-mcp (MCP Server) ├── Auth + Consent (FAPI-BR 2.2.0: private_key_jwt, PAR/JAR, PKCE, mTLS) ├── MCP Primitives (18 tools + 1 resource + 1 prompt) │ ├── Pydantic v2 input/output schemas │ ├── Optional URL elicitation for bank authorization │ └── Categorizer (DSPy + Claude for transaction classification) ├── Bank Adapters (10 banks - extensible) └── Directory Client (resolves real bank endpoints from the BCB Directory of Participants) │ HTTPS/mTLS ▼ Open Finance BR (BCB) - Directory of Participants │ ▼ Nubank · Sicoob · Caixa · + 100 participating institutions

Environment variables

Variable	Required	Description
`ENVIRONMENT`	❌	`mock` (default, no credentials needed), `sandbox`, or `production`
`CLIENT_ID`	⚠️ non-mock	Client ID registered with the institution
`PRIVATE_KEY_PATH`	⚠️ non-mock	RSA private key for `private_key_jwt`/JAR signing
`PRIVATE_KEY_KID`	⚠️ non-mock	`kid` matching the registered client JWKS
`MTLS_CERT_PATH`	⚠️ prod	Path to the mTLS certificate
`MTLS_KEY_PATH`	⚠️ prod	mTLS private key
`ANTHROPIC_API_KEY`	⚠️ DSPy	Required for `categorize=true`
`REDIS_URL`	❌	Shares TokenStore/ConsentManager state across replicas
`MCP_TRANSPORT`	❌	`stdio` (default) or `streamable-http`
`MCP_HTTP_ALLOWED_ORIGINS`	⚠️ remote HTTP	Required allowlist for any non-loopback bind
`LANGFUSE_OTLP_ENDPOINT`	❌	Enables tracing to Langfuse (with `LANGFUSE_PUBLIC_KEY`/`LANGFUSE_SECRET_KEY`)
`LOG_LEVEL`	❌	INFO, DEBUG, WARNING (default: INFO)
`LOG_FORMAT`	❌	json or console (default: json)

See .env.example for the full list.

Documentation

Authorization - the two token universes and why they can never cross
Contributing - dev setup, CI checks, and adding an adapter
Security - scope, disclaimer, and vulnerability reporting
Sources - specifications and RFCs followed by the implementation
Validation - what has and has not been validated
Changelog - release history
Releasing - maintainer release procedure

License

MIT

Openfinance Br MCP

ภาพรวม

สามเสาของ PopNx MCP

ใช้ทำอะไรได้

ติดตั้ง

ก่อนติดตั้ง

ค่าที่ต้องใส่เอง

ทำอะไรได้บ้าง

ผลตรวจเบื้องต้นi

ตัวตนผู้ทำตรงกับ repo

ยังมีคนดูแล

มีสัญญาอนุญาต (license)

endpoint ตอบ

ล็อกอินแบบ OAuth

คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

เทียบกับตัวอื่นในหมวด บัญชี การเงิน และภาษีi

คำถามที่พบบ่อย

ตัวที่ใช้แทนได้

Finance Toolkit

SolidInvoice

Korea Tax Calculator

README จากผู้ทำ

openfinance-br-mcp

What it is

Supported banks

Available MCP tools

Quick start

Prerequisites

From source

Optional: needed only for sandbox/production or DSPy categorization

Install dependencies

Run the server

Claude Desktop

Development

Run the tests

Lint and formatting

Type check

Containers and Kubernetes

Architecture

Environment variables

Documentation

License