{"_id":"@codespar/mcp-belvo","_rev":"5-e4219ea80c9db3e898bb9eb760f7f4e8","name":"@codespar/mcp-belvo","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-belvo","version":"0.1.0","keywords":["belvo","open-finance","mexico","argentina","colombia","banking","mcp"],"license":"MIT","_id":"@codespar/mcp-belvo@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-belvo":"dist/index.js"},"dist":{"shasum":"5f2d8c1e0e57f0bd9d5e438e15456e0659589839","tarball":"https://registry.npmjs.org/@codespar/mcp-belvo/-/mcp-belvo-0.1.0.tgz","fileCount":4,"integrity":"sha512-aJX+WBleDuuvZard64XV4XIeDkhtkmJ5NAy1K1Trae74kEshPz2Qp8vehKkGRgR0jYqVyCay7OAvZcCnDhQOlQ==","signatures":[{"sig":"MEUCIHW6KvgLthOvEyJ41rO2144BGe7kFgvVeV43yzc87J4BAiEA3NnNzFLRmyONlvPFlCBoQiw60Ir2N0siEHZ8gZ/Yw54=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20856},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"b6cfd13e835eafffc9f9fec863ef0476792a06d9","mcpName":"io.github.codespar/mcp-belvo","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Belvo — Open Finance aggregator for LATAM","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-belvo_0.1.0_1776009997389_0.7160407960567319","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@codespar/mcp-belvo","version":"0.2.0","keywords":["belvo","open-finance","mexico","argentina","colombia","banking","mcp"],"license":"MIT","_id":"@codespar/mcp-belvo@0.2.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-belvo":"dist/index.js"},"dist":{"shasum":"6ff4e2bb8b0928904dd84d52174c298eb7038c59","tarball":"https://registry.npmjs.org/@codespar/mcp-belvo/-/mcp-belvo-0.2.0.tgz","fileCount":4,"integrity":"sha512-yZ/sB4IJFFRtiKhmLVunfYwSoB6cijs54gFsd5CRxwOrFp6IGn0kKpz9fxu+GF5XWzwPOFSQtjXlWqLrjfD1AQ==","signatures":[{"sig":"MEUCIQC2XdNCBAgtji4E6QkIn6zvWFXcuqc8iP9KKsf4X71LywIgGMDpnFm1wXfKV1TwvOvMB2IFW3m6EtdmSsdf50rirBA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":37605},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"518f2f58e9384339c77b20df2a52366d15958a38","mcpName":"io.github.codespar/mcp-belvo","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Belvo — Open Finance aggregator for LATAM","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-belvo_0.2.0_1777072483020_0.5713965307473516","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@codespar/mcp-belvo","version":"0.2.1","keywords":["belvo","open-finance","mexico","argentina","colombia","banking","mcp"],"license":"MIT","_id":"@codespar/mcp-belvo@0.2.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-belvo":"dist/index.js"},"dist":{"shasum":"c7521335f71573ddbbe7c556194a38b3d4ebea82","tarball":"https://registry.npmjs.org/@codespar/mcp-belvo/-/mcp-belvo-0.2.1.tgz","fileCount":4,"integrity":"sha512-iMAwS+itTXupBi/M4Uzo1kOIU1uK5Ax3aQI8ppV9LHZO5Qnl33bJBST+AS6WcsXpJb09bU5d71oqTv8ePTWzyA==","signatures":[{"sig":"MEUCIEpLHZ2pFHTXQ427BNKTIF18ZvmTO34gxwGQRYrTNBX0AiEAjl4aKLqPrjorNLg3jRD6LVFt8FYfoUHLkXOnQutAUXA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38709},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-belvo","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Belvo — Open Finance aggregator for LATAM","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-belvo_0.2.1_1777123128148_0.04952844554921909","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@codespar/mcp-belvo","version":"0.2.2","description":"MCP server for Belvo — Open Finance aggregator for LATAM","type":"module","main":"dist/index.js","bin":{"mcp-belvo":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.8.0"},"license":"MIT","keywords":["belvo","open-finance","mexico","argentina","colombia","banking","mcp"],"mcpName":"io.github.codespar/mcp-belvo","_id":"@codespar/mcp-belvo@0.2.2","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-/lMMkxcYHMchXPNFIvWfmil4k9Zfs/+1DJctY41HFQGxNbLkMJ9votT2nCZEN/Kay5gPmF9KFAS1IR4Em5g1Vw==","shasum":"0196a5f595cecfa5ecb757ee3886b823a39bdafa","tarball":"https://registry.npmjs.org/@codespar/mcp-belvo/-/mcp-belvo-0.2.2.tgz","fileCount":4,"unpackedSize":39690,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCRPriO4K0+x3U8q9hV2RgmK+fpX9tgL5yQy1XdCS7qDwIhAO6oHmeSITFLrniYmUCrijDZ5XfRiKWgL5Mv8owidjQT"}]},"_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-belvo_0.2.2_1782153721925_0.9263748337673128"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-12T16:06:37.222Z","modified":"2026-06-22T18:42:02.257Z","0.1.0":"2026-04-12T16:06:37.506Z","0.2.0":"2026-04-24T23:14:43.146Z","0.2.1":"2026-04-25T13:18:48.347Z","0.2.2":"2026-06-22T18:42:02.095Z"},"license":"MIT","keywords":["belvo","open-finance","mexico","argentina","colombia","banking","mcp"],"description":"MCP server for Belvo — Open Finance aggregator for LATAM","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# MCP Belvo\n\nMCP server for **Belvo** — Open Finance aggregator for LATAM (Mexico, Argentina, Colombia).\n\n## Quick Start\n\n```bash\n# Set your credentials\nexport BELVO_SECRET_ID=\"your-secret-id\"\nexport BELVO_SECRET_PASSWORD=\"your-secret-password\"\nexport BELVO_SANDBOX=true  # Use sandbox environment\n\n# Run via stdio\nnpx tsx packages/mexico/belvo/src/index.ts\n\n# Run via HTTP\nnpx tsx packages/mexico/belvo/src/index.ts --http\n```\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `BELVO_SECRET_ID` | Yes | Secret ID from Belvo dashboard |\n| `BELVO_SECRET_PASSWORD` | Yes | Secret password from Belvo dashboard |\n| `BELVO_SANDBOX` | No | Set to `\"true\"` to use sandbox (default: production) |\n| `MCP_HTTP` | No | Set to `\"true\"` to enable HTTP transport |\n| `MCP_PORT` | No | HTTP port (default: 3000) |\n\n## Tools (24)\n\n| Tool | Purpose |\n|---|---|\n| `list_institutions` | List available financial institutions |\n| `create_link` | Create a link to a financial institution |\n| `list_links` | List existing links |\n| `get_accounts` | Get accounts for a link |\n| `get_balances` | Get balances for a link |\n| `get_transactions` | Get transactions for a link |\n| `get_owners` | Get owner information for a link |\n| `get_incomes` | Get income data for a link |\n| `get_tax_returns` | Get tax returns for a link (fiscal institutions) |\n| `get_investments` | Get investment portfolios for a link |\n| `get_link` | Retrieve details of a specific link by ID |\n| `delete_link` | Delete a link (and all its associated data) by ID |\n| `patch_link` | Update a link's credentials or resume after MFA (PATCH /api/links/) |\n| `list_accounts` | List stored accounts (GET /api/accounts/) with optional filters |\n| `get_account_detail` | Retrieve a stored account by account ID |\n| `list_transactions` | List stored transactions (GET /api/transactions/) with optional filters |\n| `get_transaction_detail` | Retrieve a stored transaction by transaction ID |\n| `list_balances` | List stored balances (GET /api/balances/) with optional filters |\n| `list_owners` | List stored owners (GET /api/owners/) |\n| `list_incomes` | List stored incomes (GET /api/incomes/) |\n| `get_employment_records` | Get employment records for a link (employment institutions) |\n| `get_invoices` | Get invoices for a link (BR/MX fiscal institutions) |\n| `get_receivables_transactions` | Get receivables transactions for a link (payment rails / acquirer data) |\n| `create_widget_token` | Create a short-lived access token for the Belvo Connect Widget |\n\n## Auth\n\nUses **Basic authentication** (secret_id:secret_password). Obtain your credentials from the [Belvo Dashboard](https://dashboard.belvo.com/).\n\n## API Reference\n\n- [Belvo API Docs](https://developers.belvo.com/)\n\n---\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## Authentication\n\nSet these environment variables before launching the server:\n\n- `BELVO_SECRET_ID` *(required, secret)* — Secret ID for Belvo\n- `BELVO_SECRET_PASSWORD` *(required, secret)* — Secret password for Belvo\n- `BELVO_SANDBOX` — Set to true to use sandbox environment\n\nIssue credentials at the provider's developer portal: <https://developers.belvo.com>.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}