{"_id":"@codespar/mcp-unblockpay","_rev":"7-c3bd207ae6ade67c68ccb4e8a64082fe","name":"@codespar/mcp-unblockpay","dist-tags":{"latest":"0.3.1"},"versions":{"0.1.0":{"name":"@codespar/mcp-unblockpay","version":"0.1.0","keywords":["mcp","unblockpay","crypto","stablecoin","onramp","offramp"],"license":"MIT","_id":"@codespar/mcp-unblockpay@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-unblockpay":"dist/index.js"},"dist":{"shasum":"e5deaae6b3df275656043d6b80a87f2dcacb1e94","tarball":"https://registry.npmjs.org/@codespar/mcp-unblockpay/-/mcp-unblockpay-0.1.0.tgz","fileCount":5,"integrity":"sha512-xsWUsx4FgMJoErDgx2E40GKgPSBv9rkWp2k5uCGDgP++pBWmDfso73Ir5RocsuFP9jwAr0MajoMzkG6YA0mHpQ==","signatures":[{"sig":"MEUCIQDaYFwDUrIDED8v0NooeLNz9rrTPuDYSfcKfrgDpVJ1fAIgAg1rffkiJCZVBiqNQ/b1Elp0gw4v4LQhmkMXIVkZ/yk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24982},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"2f4996f5df31d6f8bf3a3e606ecc416783ceaf2b","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"10.9.4","description":"MCP server for UnblockPay — fiat-to-stablecoin onramp/offramp, wallets, transfers","directories":{},"_nodeVersion":"22.22.1","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-unblockpay_0.1.0_1775044077652_0.21152121855108752","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@codespar/mcp-unblockpay","version":"0.1.2","keywords":["mcp","unblockpay","crypto","stablecoin","onramp","offramp"],"license":"MIT","_id":"@codespar/mcp-unblockpay@0.1.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-unblockpay":"dist/index.js"},"dist":{"shasum":"de4edfba241f22b19e490202c62bc2591f8c7134","tarball":"https://registry.npmjs.org/@codespar/mcp-unblockpay/-/mcp-unblockpay-0.1.2.tgz","fileCount":7,"integrity":"sha512-FF14KmXEOn1cko71QhLzfoaV/aYiP7JD8eJ0XG+88aLLKjf646q6thYwjgPLaEsuy1fIwDHhz5VA6foDkdY/BA==","signatures":[{"sig":"MEQCIA+x5bIy5mj9uJ/KSJAhJxLpGmt7SKBzYErlMWymPhK4AiAWmYHI0IKuyhEgvy0kadjQn8P5xdSfd5GnfP+JoX7pjQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":32233},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"8fd47fad095cdf96618460a39345eddfe2a4af21","mcpName":"io.github.codespar/mcp-unblockpay","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for UnblockPay — fiat-to-stablecoin onramp/offramp, wallets, transfers","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-unblockpay_0.1.2_1775953687752_0.16085974890672472","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@codespar/mcp-unblockpay","version":"0.2.0","keywords":["mcp","unblockpay","crypto","stablecoin","onramp","offramp"],"license":"MIT","_id":"@codespar/mcp-unblockpay@0.2.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-unblockpay":"dist/index.js"},"dist":{"shasum":"479d823ac31f19e68ae38bacd74af344bc9c5535","tarball":"https://registry.npmjs.org/@codespar/mcp-unblockpay/-/mcp-unblockpay-0.2.0.tgz","fileCount":7,"integrity":"sha512-ooRwtDmscN8rE4hetqGiVM0vl6aw3Cn+EfbGa/jultZMHRvVGYNJavjpuBGITP4V5o61VQYUo/qSGS+XE43m1Q==","signatures":[{"sig":"MEUCIQDijFPdTqj1fC7OOmS+b5oamK3qPiH/moA3DXOuRQ7L4QIgF5TG0kYEjOzACT74LDSNu7DGO5ml/LX+rAsIEecX1RA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":50479},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"16948c85b03c82fa9da581a7a3e62981ce6e211e","mcpName":"io.github.codespar/mcp-unblockpay","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for UnblockPay — fiat-to-stablecoin onramp/offramp, wallets, transfers","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-unblockpay_0.2.0_1777117976914_0.14287505958054503","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@codespar/mcp-unblockpay","version":"0.2.1","keywords":["mcp","unblockpay","crypto","stablecoin","onramp","offramp"],"license":"MIT","_id":"@codespar/mcp-unblockpay@0.2.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-unblockpay":"dist/index.js"},"dist":{"shasum":"4036ebe0dc411c442c6b1dbd9a519e269fcb691e","tarball":"https://registry.npmjs.org/@codespar/mcp-unblockpay/-/mcp-unblockpay-0.2.1.tgz","fileCount":7,"integrity":"sha512-fyTLID/ob3Vh51HQS/D57d5Eqy51dKtIhjpMVpMYnhxsww/COMoGtHcbzszgIMShEnh1W5mt5ph0TkzBCT9M3A==","signatures":[{"sig":"MEQCIGnhHRxhtgIZv8jrxJZNwbnH7GUbkXFUDTfITMJ7wEDLAiACpbmLBPYY/fMLNmbJLSZ4vxW2XXWPdJOySkPZSsTrCg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":51267},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-unblockpay","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for UnblockPay — fiat-to-stablecoin onramp/offramp, wallets, transfers","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-unblockpay_0.2.1_1777123031836_0.08981468605332177","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@codespar/mcp-unblockpay","version":"0.3.0","keywords":["mcp","unblockpay","crypto","stablecoin","onramp","offramp"],"license":"MIT","_id":"@codespar/mcp-unblockpay@0.3.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"bin":{"mcp-unblockpay":"dist/index.js"},"dist":{"shasum":"1f1cd3c5b2feff8b46cd554fb009600a4c835b97","tarball":"https://registry.npmjs.org/@codespar/mcp-unblockpay/-/mcp-unblockpay-0.3.0.tgz","fileCount":7,"integrity":"sha512-XzAuC2JDVZQYSFvh2vEsbZ++v3fg1pyt1u5SvO67MGR4cvOTW8AsjUyr5BrICw6UzrORWiKnjsA25mnjO9w5HA==","signatures":[{"sig":"MEYCIQDT7gDS3LFUowL+FUU5o8RNK8ZpMKgtF2qlN24/gfmRIwIhAJbr85vqQA/H8wcJWyYNJved38bchjOb4ooFn0cM0yP1","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48560},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"a121ea567035fa095d42b603f244273e3a34cc90","mcpName":"io.github.codespar/mcp-unblockpay","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"10.9.8","description":"MCP server for UnblockPay — fiat <> stablecoin cross-border via Customer → Wallet → Quote → Payin/Payout","directories":{},"_nodeVersion":"22.22.3","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-unblockpay_0.3.0_1781995369311_0.7789879686082475","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@codespar/mcp-unblockpay","version":"0.3.1","description":"MCP server for UnblockPay — fiat <> stablecoin cross-border via Customer → Wallet → Quote → Payin/Payout","type":"module","main":"./dist/index.js","bin":{"mcp-unblockpay":"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":["mcp","unblockpay","crypto","stablecoin","onramp","offramp"],"mcpName":"io.github.codespar/mcp-unblockpay","_id":"@codespar/mcp-unblockpay@0.3.1","gitHead":"8e115a5cb8aed75e812af698b03aa996ccd8d7c1","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-AAvNuM4gyVFhv/CMovYlK5mR6AfiCpmTL4rcOEjtOsSjV4yUBBttF9Ysa8d6Gg4y3nWL3Rd73cJ2/HiVzK8NyA==","shasum":"cbed03fb798cc306ab301d4c92795dc822cb6bc3","tarball":"https://registry.npmjs.org/@codespar/mcp-unblockpay/-/mcp-unblockpay-0.3.1.tgz","fileCount":7,"unpackedSize":49523,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCHMpl3evflgJS9Z4GJKMLWGvzUMZtTXkzdHSKXNRWRdQIgOF34UlFGu2GRSQa7ds6ItPnnjybx5yWeteXxxW5YGbo="}]},"_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-unblockpay_0.3.1_1782158118293_0.05486393139031365"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-01T11:47:57.528Z","modified":"2026-06-22T19:55:18.574Z","0.1.0":"2026-04-01T11:47:57.786Z","0.1.2":"2026-04-12T00:28:07.891Z","0.2.0":"2026-04-25T11:52:57.076Z","0.2.1":"2026-04-25T13:17:11.991Z","0.3.0":"2026-06-20T22:42:49.444Z","0.3.1":"2026-06-22T19:55:18.421Z"},"license":"MIT","keywords":["mcp","unblockpay","crypto","stablecoin","onramp","offramp"],"description":"MCP server for UnblockPay — fiat <> stablecoin cross-border via Customer → Wallet → Quote → Payin/Payout","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-unblockpay\n\n> MCP server for **UnblockPay** — fiat ↔ stablecoin cross-border via Customer → Wallet → Quote → Payin/Payout\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-unblockpay)](https://www.npmjs.com/package/@codespar/mcp-unblockpay)\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    \"unblockpay\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-unblockpay\"],\n      \"env\": {\n        \"UNBLOCKPAY_API_KEY\": \"your-key\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add unblockpay -- npx @codespar/mcp-unblockpay\n```\n\n### Cursor / VS Code\n\nAdd to `.cursor/mcp.json` or `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"unblockpay\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-unblockpay\"],\n      \"env\": {\n        \"UNBLOCKPAY_API_KEY\": \"your-key\"\n      }\n    }\n  }\n}\n```\n\n## Tools (13)\n\n| Tool | Purpose |\n|---|---|\n| `create_customer` | Create an individual or business customer (KYC mother). Business customers require `date_of_incorporation`. |\n| `list_customers` | List customers under the operator's API key (`limit` mandatory by the v1 pagination contract). |\n| `verify_customer` | Trigger the KYC verification check. Idempotent (returns 422 `customer_cannot_be_verified` when already approved). |\n| `get_verification_details` | Poll KYC state — returns `customer_status: pending \\| approved \\| rejected \\| partially_rejected`. |\n| `create_wallet` | Create a stablecoin wallet under an APPROVED customer. |\n| `list_wallets` | List wallets under the operator's API key. |\n| `create_external_account` | Register a fiat receiver account (BRL Pix, USD wire, EUR SEPA, MXN SPEI). Skippable for BRL Pix payouts via the `pix_key + document` shortcut on `create_payout`. |\n| `list_external_accounts` | List external accounts under the operator's API key. |\n| `create_quote` | Lock an FX + fee quote for 5 minutes. Pass `amount` on EITHER `sender` or `receiver`, not both. |\n| `create_payin` | Fiat → stablecoin pay-in referencing a `quote_id`. Returns deposit instructions (`<Pix Copy & Paste EMV>` for BR). |\n| `create_payout` | Stablecoin → fiat payout referencing a `quote_id`. `customer_id` is REQUIRED at the top level. |\n| `get_transaction` | Poll transaction status. Lifecycle: `awaiting_deposit → processing → completed` (or `failed / refunded / cancelled / error`). |\n| `cancel_transaction` | Cancel a transaction. Only valid while status is `awaiting_deposit`. |\n\n## Authentication\n\nUnblockPay uses an API key passed verbatim in the `Authorization` header (no `Bearer` prefix). The server sets that header for you — you just provide the key via `UNBLOCKPAY_API_KEY`.\n\n## Sandbox / Testing\n\nUnblockPay provides a separate sandbox environment for testing. Point the server at it by setting `UNBLOCKPAY_BASE_URL=https://api.sandbox.unblockpay.com/v1` and using a sandbox-issued API key.\n\n### Get your credentials\n\n1. Sign in at [app.unblockpay.com](https://app.unblockpay.com) (or follow the [docs](https://docs.unblockpay.com))\n2. Generate an API key in the dashboard\n3. Set the `UNBLOCKPAY_API_KEY` environment variable\n4. (Sandbox only) Also set `UNBLOCKPAY_BASE_URL=https://api.sandbox.unblockpay.com/v1`\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `UNBLOCKPAY_API_KEY` | Yes | API key from the UnblockPay dashboard |\n| `UNBLOCKPAY_BASE_URL` | No | Defaults to `https://api.unblockpay.com/v1`. Set to `https://api.sandbox.unblockpay.com/v1` for sandbox. |\n\n## Roadmap\n\nThe 13 tools above mirror UnblockPay's current v1 API. New tools are added as UnblockPay expands the surface.\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- [UnblockPay Website](https://unblockpay.com)\n- [UnblockPay API Documentation](https://docs.unblockpay.com)\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"}