{"_id":"@codespar/mcp-open-finance","_rev":"6-ec2f6f5ba5341ed9a0ae0f59d91a82ed","name":"@codespar/mcp-open-finance","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-open-finance","version":"0.1.0","keywords":["mcp","open-finance","banking","pix","accounts","brazil"],"license":"MIT","_id":"@codespar/mcp-open-finance@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-open-finance":"dist/index.js"},"dist":{"shasum":"002012f84c62d5dcd4d93988522b947665799cd4","tarball":"https://registry.npmjs.org/@codespar/mcp-open-finance/-/mcp-open-finance-0.1.0.tgz","fileCount":4,"integrity":"sha512-uvIJfVM1R57oMuwf28al8JrjLoN72Pnu1vfyei3DE4o0elHD/e41nWulGu8zAOUag5XrCBEHAraomupB7zwqhg==","signatures":[{"sig":"MEUCIHFDM4quzhGADg6sDJaxLYHY4iXw7HPpMf9Cx/YbWniZAiEA0DNK4Pk7aK/x3g4cWafzQhRRxhL1lwCHUinv19aHDOI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24842},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"ac49d04d5aa50ad5dc16233f0bba88213f917641","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Open Finance Brasil — accounts, transactions, consents, investments","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-open-finance_0.1.0_1774923344830_0.47151067023819193","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@codespar/mcp-open-finance","version":"0.1.2","keywords":["mcp","open-finance","banking","pix","accounts","brazil"],"license":"MIT","_id":"@codespar/mcp-open-finance@0.1.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-open-finance":"dist/index.js"},"dist":{"shasum":"68b880d09c04dd30f76f54a09ce972a3566dfd41","tarball":"https://registry.npmjs.org/@codespar/mcp-open-finance/-/mcp-open-finance-0.1.2.tgz","fileCount":7,"integrity":"sha512-NCNhwvq/xnKqjqU/TP6HmsAyT+AjVWn0AJ+FyZn6rytgySWfRnmNdn+QRt8f+CytcwGD0ReYiec65RGadeyFrw==","signatures":[{"sig":"MEUCICmSENrVa3jFXebqnTLAbFIVQFCmj1x4lYkXA7PXuEejAiEA/JCzn+uLSNEyvHfoHZbl/hncMMC4sk4KrHD3CK/tzRg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35993},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"8fd47fad095cdf96618460a39345eddfe2a4af21","mcpName":"io.github.codespar/mcp-open-finance","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Open Finance Brasil — accounts, transactions, consents, investments","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-open-finance_0.1.2_1775953649606_0.7967226538609657","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@codespar/mcp-open-finance","version":"0.2.0","keywords":["mcp","open-finance","banking","pix","accounts","brazil"],"license":"MIT","_id":"@codespar/mcp-open-finance@0.2.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-open-finance":"dist/index.js"},"dist":{"shasum":"654d937db7d3af098a6fa18bff7babd32bd34b33","tarball":"https://registry.npmjs.org/@codespar/mcp-open-finance/-/mcp-open-finance-0.2.0.tgz","fileCount":7,"integrity":"sha512-Av1X8kHzGqbKoHpzfl+zmBAOV5VBq6BBsFcI/TL2XSxvoXIV0KXsgDMH1bviKv2v5v9zEjyLYorlrInDmqCK0g==","signatures":[{"sig":"MEYCIQDXidm4L7XS+Snm7Du6OrOdbelNqZBnFA6eaABr9H8sOgIhALLc3/vEaNlLX6IGZDc11if0rfWJFceLrtd4m13GWsIi","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":60541},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"071bd694f44f5dae6951e70fad7ba297d73f6bc4","mcpName":"io.github.codespar/mcp-open-finance","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Open Finance Brasil — accounts, transactions, consents, credit cards, loans, financings, investments, payment-initiation, customer qualifications","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-open-finance_0.2.0_1777116432151_0.843725980891658","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@codespar/mcp-open-finance","version":"0.2.1","keywords":["mcp","open-finance","banking","pix","accounts","brazil"],"license":"MIT","_id":"@codespar/mcp-open-finance@0.2.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-open-finance":"dist/index.js"},"dist":{"shasum":"79ebe531e0246463e871358a2024e36d96658632","tarball":"https://registry.npmjs.org/@codespar/mcp-open-finance/-/mcp-open-finance-0.2.1.tgz","fileCount":7,"integrity":"sha512-mLHohuonRonNzFVHxQa3F/QYQ/QtRJ96/2Ipn3Oa3Q50TI6KnhD39ittisV8EZ7pF3ZV3CEeoIFkU8tF2WtOZA==","signatures":[{"sig":"MEYCIQCkSyGwRiposVtukdAr9/C+jVB3zn+oxJ5ZwHl2dsHncAIhAL4Im3UeqSC0ZoPW0sMsXbw32JudTTUm+KZcyisB1V4I","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61361},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"b8f7e5b70db9046319ed757225e0eae8f2dc4451","mcpName":"io.github.codespar/mcp-open-finance","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Open Finance Brasil — accounts, transactions, consents, credit cards, loans, financings, investments, payment-initiation, customer qualifications","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-open-finance_0.2.1_1777122933401_0.4410404068193967","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@codespar/mcp-open-finance","version":"0.2.2","description":"MCP server for Open Finance Brasil — accounts, transactions, consents, credit cards, loans, financings, investments, payment-initiation, customer qualifications","type":"module","main":"./dist/index.js","bin":{"mcp-open-finance":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","open-finance","banking","pix","accounts","brazil"],"mcpName":"io.github.codespar/mcp-open-finance","_id":"@codespar/mcp-open-finance@0.2.2","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-eQt60fxNsnMeI6ogERRmZXPcnJtLj0i6c5DizBOAeul3cq6h9Oeh2zJOfFxYE2M6RhDoV2E+kpg1uVBhN7hMBw==","shasum":"f8494153cb8ed9d37ab9d9212ac7a0e17087bf39","tarball":"https://registry.npmjs.org/@codespar/mcp-open-finance/-/mcp-open-finance-0.2.2.tgz","fileCount":7,"unpackedSize":62612,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHurlNoHGUZHvRGPrZ42fBqOeOGuhVlK2ZDwQaXDCFiOAiB3JxssaWsyLojHDlnh83bbKbZdZEpfLDz5MPVShWnErA=="}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-open-finance_0.2.2_1782153392811_0.9525083415619258"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-31T02:15:44.741Z","modified":"2026-06-22T18:36:33.064Z","0.1.0":"2026-03-31T02:15:44.985Z","0.1.2":"2026-04-12T00:27:29.752Z","0.2.0":"2026-04-25T11:27:12.344Z","0.2.1":"2026-04-25T13:15:33.535Z","0.2.2":"2026-06-22T18:36:32.939Z"},"license":"MIT","keywords":["mcp","open-finance","banking","pix","accounts","brazil"],"description":"MCP server for Open Finance Brasil — accounts, transactions, consents, credit cards, loans, financings, investments, payment-initiation, customer qualifications","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-open-finance\n\n> MCP server for **Open Finance Brasil** — open banking standard for accounts, transactions, and consents\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-open-finance)](https://www.npmjs.com/package/@codespar/mcp-open-finance)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to `~/.config/claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"open-finance\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-open-finance\"],\n      \"env\": {\n        \"OPEN_FINANCE_BASE_URL\": \"https://api.institution.com.br\",\n        \"OPEN_FINANCE_CLIENT_ID\": \"your-client-id\",\n        \"OPEN_FINANCE_CLIENT_SECRET\": \"your-client-secret\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add open-finance -- npx @codespar/mcp-open-finance\n```\n\n### Cursor / VS Code\n\nAdd to `.cursor/mcp.json` or `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"open-finance\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-open-finance\"],\n      \"env\": {\n        \"OPEN_FINANCE_BASE_URL\": \"https://api.institution.com.br\",\n        \"OPEN_FINANCE_CLIENT_ID\": \"your-client-id\",\n        \"OPEN_FINANCE_CLIENT_SECRET\": \"your-client-secret\"\n      }\n    }\n  }\n}\n```\n\n## Tools (18)\n\n| Tool | Purpose |\n|---|---|\n| `list_accounts` | List customer bank accounts via Open Finance |\n| `get_account_balance` | Get account balance via Open Finance |\n| `list_transactions` | List account transactions via Open Finance |\n| `get_account_overdraft_limits` | Get account overdraft (limites) via Open Finance |\n| `get_consent` | Get consent details by ID |\n| `create_consent` | Create a new consent request for data access |\n| `revoke_consent` | Revoke an existing consent (data or payment) |\n| `list_credit_cards` | List credit card accounts via Open Finance |\n| `get_credit_card_bills` | Get credit card bills (faturas) via Open Finance |\n| `get_credit_card_transactions` | Get credit card transactions via Open Finance |\n| `list_loans` | List loan contracts (empréstimos) via Open Finance |\n| `get_loan_payments` | Get loan payment schedule via Open Finance |\n| `list_financings` | List financing contracts (financiamentos) via Open Finance |\n| `list_investments` | List investment products via Open Finance |\n| `create_payment_consent` | Create payment-initiation consent (e.g., PIX) via Open Finance |\n| `create_payment` | Initiate a payment using an authorized payment consent |\n| `get_personal_qualifications` | Get personal customer qualifications (income, occupation) via Open Finance |\n| `get_business_qualifications` | Get business customer qualifications via Open Finance |\n\n## Authentication\n\nOpen Finance Brasil uses OAuth2 client credentials. Each financial institution provides its own base URL and credentials.\n\n## Sandbox / Testing\n\nSandbox availability varies by institution. Contact your financial institution for Open Finance sandbox access.\n\n### Get your credentials\n\n1. Go to [Open Finance Brasil](https://openfinancebrasil.org.br)\n2. Register with a participating financial institution\n3. Obtain your OAuth2 client credentials\n4. Set the environment variables\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `OPEN_FINANCE_BASE_URL` | Yes | Institution API base URL |\n| `OPEN_FINANCE_CLIENT_ID` | Yes | OAuth2 client ID |\n| `OPEN_FINANCE_CLIENT_SECRET` | Yes | OAuth2 client secret |\n\n## Roadmap\n\n### v0.2 (planned)\n- `revoke_consent` — Revoke a data sharing consent\n- `list_payments` — List initiated payments\n- `create_payment_consent` — Create a payment initiation consent\n- `initiate_payment` — Initiate a payment via Open Finance\n- `get_payment_status` — Get payment initiation status\n\n### v0.3 (planned)\n- `insurance_products` — List insurance products from institutions\n- `pension_products` — List pension products from institutions\n\nWant to contribute? [Open a PR](https://github.com/codespar/mcp-dev-latam) or [request a tool](https://github.com/codespar/mcp-dev-latam/issues).\n\n## Links\n\n- [Open Finance Brasil](https://openfinancebrasil.org.br)\n- [Open Finance Brasil Developer Portal](https://openfinancebrasil.atlassian.net)\n- [MCP Dev LATAM](https://github.com/codespar/mcp-dev-latam)\n- [Landing Page](https://codespar.dev/mcp)\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}