{"_id":"@codespar/mcp-nequi","_rev":"5-bd6c8e93ff33b8810d99f9e3aacb8ae5","name":"@codespar/mcp-nequi","dist-tags":{"latest":"0.2.0-alpha.3","alpha":"0.2.0-alpha.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-nequi","version":"0.1.0","keywords":["nequi","wallet","colombia","bancolombia","payments","mcp"],"license":"MIT","_id":"@codespar/mcp-nequi@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-nequi":"dist/index.js"},"dist":{"shasum":"6b6063674f1ff352e54c7643aee6f95d62bfea2f","tarball":"https://registry.npmjs.org/@codespar/mcp-nequi/-/mcp-nequi-0.1.0.tgz","fileCount":4,"integrity":"sha512-Av+NM8mDO1F/mCEDmJznnDpkUjUWaK6p7bAT1uzlFes6N4i+BnhcH56Ks04tht5FjD3WUYYOQFKNJhPP8kYXgw==","signatures":[{"sig":"MEYCIQCZ63BVyR8fnVBlKKYD1oAWJg2mxuXPNwBGRzk8n0J5vQIhAO7++6ZNEDd/G9fUq7CrjtbtIEr8kXU0SqvahfKovLJE","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18936},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"459fc3c9039fafd260f0a7c105571a27b9be61cf","mcpName":"io.github.codespar/mcp-nequi","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Nequi — Colombian digital wallet (by Bancolombia)","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-nequi_0.1.0_1776012109197_0.45316628235376943","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.1":{"name":"@codespar/mcp-nequi","version":"0.2.0-alpha.1","keywords":["nequi","wallet","colombia","bancolombia","payments","mcp"],"license":"MIT","_id":"@codespar/mcp-nequi@0.2.0-alpha.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-nequi":"dist/index.js"},"dist":{"shasum":"5bfa3c1011b45531e2e606fae682f00cff72cb60","tarball":"https://registry.npmjs.org/@codespar/mcp-nequi/-/mcp-nequi-0.2.0-alpha.1.tgz","fileCount":4,"integrity":"sha512-N+acrVx5vDUIix/KW+r3Gh9eP3jVWlBpkOleZf3LgYMwIIK61QzWnh4vM2N3oWW1i6hl58fjdaCfWZRj7t58qw==","signatures":[{"sig":"MEQCIFcwoE3hLx7FkzAgiVz28JSkZHfucfJtlGgi09zc6l2AAiBUbDnE3Sx9OuYyas9uhhQgimiT/PtSdF0BsvghJTnjCA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":36823},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"a0e321bd6cd8470b3e3ba7c7511bafb4a04eea93","mcpName":"io.github.codespar/mcp-nequi","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Nequi — Colombian digital wallet (by Bancolombia)","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-nequi_0.2.0-alpha.1_1777119082357_0.6833237530980614","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.2":{"name":"@codespar/mcp-nequi","version":"0.2.0-alpha.2","keywords":["nequi","wallet","colombia","bancolombia","payments","mcp"],"license":"MIT","_id":"@codespar/mcp-nequi@0.2.0-alpha.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-nequi":"dist/index.js"},"dist":{"shasum":"aff48e05b496b838d13e86372444dc2bebed3663","tarball":"https://registry.npmjs.org/@codespar/mcp-nequi/-/mcp-nequi-0.2.0-alpha.2.tgz","fileCount":4,"integrity":"sha512-iUKnU1SqOvI6BMxAqYWl34nLNtto06tjMygD2UyPTVXxDwpW3wMgKazNp8oJMmE3fH53hrZBE7Oofhe2kg/6eQ==","signatures":[{"sig":"MEUCIAG/sxLcohfvoLab3mkwgaVvk1V9Z9YTjPOnBRVXc5lGAiEApM6OQmUPbpwlVp5rFEyO1qg4Bj+e89w/8f3X0vJs3eo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":37935},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"75325fbee6663a5773f39639843efe8c71d6dbda","mcpName":"io.github.codespar/mcp-nequi","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Nequi — Colombian digital wallet (by Bancolombia)","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-nequi_0.2.0-alpha.2_1777122959172_0.8671636210651497","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.3":{"name":"@codespar/mcp-nequi","version":"0.2.0-alpha.3","description":"MCP server for Nequi — Colombian digital wallet (by Bancolombia)","type":"module","main":"dist/index.js","bin":{"mcp-nequi":"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":["nequi","wallet","colombia","bancolombia","payments","mcp"],"mcpName":"io.github.codespar/mcp-nequi","_id":"@codespar/mcp-nequi@0.2.0-alpha.3","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-8gJg7ynaQZjISp/coZBwzDx+raLsbBvoW6frSPxqoy+9qL2hvxP8Q9teyjDN8gKiaToTDOLuyCaEE7n2GT/UQw==","shasum":"33354844884658b0dc5d0a06fa2bbb62e668aadf","tarball":"https://registry.npmjs.org/@codespar/mcp-nequi/-/mcp-nequi-0.2.0-alpha.3.tgz","fileCount":4,"unpackedSize":38894,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDITC1P8RxhOeFuNZwspj0jbQRKHl5z0uQGC0Tso2nxOgIhALmmecaApOZ8StKTJmCdDiCyN2Wr8Q7SvXarkkLuLsVH"}]},"_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-nequi_0.2.0-alpha.3_1782153419667_0.41412823347831074"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-12T16:41:49.120Z","modified":"2026-06-22T18:36:59.952Z","0.1.0":"2026-04-12T16:41:49.327Z","0.2.0-alpha.1":"2026-04-25T12:11:22.511Z","0.2.0-alpha.2":"2026-04-25T13:15:59.299Z","0.2.0-alpha.3":"2026-06-22T18:36:59.805Z"},"license":"MIT","keywords":["nequi","wallet","colombia","bancolombia","payments","mcp"],"description":"MCP server for Nequi — Colombian digital wallet (by Bancolombia)","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# MCP Nequi\n\n\n> **Alpha release** — published under the `alpha` npm dist-tag. Endpoint paths follow public docs and BACEN/provider conventions but have not been fully live-validated. Pin exact versions during `0.x.x-alpha`. Install with `npm install <pkg>@alpha`.\n\nMCP server for **Nequi** — Colombia's leading digital wallet with 50M+ users, powered by Bancolombia. Supports push payments, QR payments, and subscriptions.\n\n## Quick Start\n\n```bash\n# Set your credentials\nexport NEQUI_API_KEY=\"your-api-key\"\nexport NEQUI_CLIENT_ID=\"your-client-id\"\nexport NEQUI_CLIENT_SECRET=\"your-client-secret\"\n\n# Run via stdio\nnpx tsx packages/colombia/nequi/src/index.ts\n\n# Run via HTTP\nnpx tsx packages/colombia/nequi/src/index.ts --http\n```\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `NEQUI_API_KEY` | Yes | API key from Nequi developer portal |\n| `NEQUI_CLIENT_ID` | Yes | OAuth2 client ID |\n| `NEQUI_CLIENT_SECRET` | Yes | OAuth2 client secret |\n| `NEQUI_ENV` | No | `\"sandbox\"` or `\"production\"` (default: sandbox) |\n| `MCP_HTTP` | No | Set to `\"true\"` to enable HTTP transport |\n| `MCP_PORT` | No | HTTP port (default: 3000) |\n\n## Tools (16)\n\n| Tool | Purpose |\n|---|---|\n| `create_push_payment` | Send a push payment notification to a Nequi user |\n| `get_payment_status` | Check the status of a payment |\n| `create_qr_payment` | Generate a QR code for payment |\n| `reverse_payment` | Reverse a completed payment |\n| `get_subscription` | Get subscription details for a phone number |\n| `unsubscribe` | Cancel a subscription |\n| `create_static_qr` | Generate a static (reusable) Nequi QR code for a merchant |\n| `reverse_transaction` | Reverse any Nequi transaction by transaction ID (refund flow) |\n| `validate_phone` | Check whether a phone number is enrolled in Nequi |\n| `notify_unregistered_payment` | Notify a non-Nequi recipient with instructions to claim a payment |\n| `list_transactions` | List transactions for a merchant within a date range |\n| `get_balance` | Get the merchant's own Nequi account balance |\n| `schedule_payment` | Schedule a Nequi push payment for a future date |\n| `authorize_recurring_charge` | Authorize a recurring charge agreement against a Nequi user |\n| `get_merchant_info` | Retrieve registered merchant business profile |\n| `get_settlement` | Query settlement (liquidation) for a given date |\n\n## Auth\n\nUses **OAuth2 client credentials** flow. The server obtains an access token using client ID and secret, and includes the API key in every request header.\n\n## API Reference\n\n- [Nequi API Docs](https://docs.conecta.nequi.com.co/)\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- `NEQUI_API_KEY` *(required, secret)* — API key for Nequi\n- `NEQUI_CLIENT_ID` *(required)* — OAuth2 client ID\n- `NEQUI_CLIENT_SECRET` *(required, secret)* — OAuth2 client secret\n\nIssue credentials at the provider's developer portal: <https://api.nequi.com.co>.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}