{"_id":"@codespar/mcp-flow-cl","name":"@codespar/mcp-flow-cl","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@codespar/mcp-flow-cl","version":"0.1.0","description":"MCP server for Flow — Chile-native PSP: hosted payment orders (Webpay, ETpay, cash), refunds, HMAC-signed API","type":"module","main":"./dist/index.js","bin":{"mcp-flow-cl":"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","flow","flow-cl","payments","psp","webpay","etpay","chile","clp"],"mcpName":"io.github.codespar/mcp-flow-cl","_id":"@codespar/mcp-flow-cl@0.1.0","gitHead":"0cf000f9cad29acc97dc1e29789d180431c6fe12","types":"./dist/index.d.ts","_nodeVersion":"22.23.1","_npmVersion":"10.9.8","dist":{"integrity":"sha512-TH+Qw6W3KUdPm2JrIG8K6EpExhPh7HvI02Ar49nF3PQiCsSuXbsm5FT+yyKXt/FQ4gfLfAvkdleQZqDT4Y3x8w==","shasum":"a34ccc74a31303e5edd58989c0aff523adc67b96","tarball":"https://registry.npmjs.org/@codespar/mcp-flow-cl/-/mcp-flow-cl-0.1.0.tgz","fileCount":4,"unpackedSize":22535,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEORq77gkH0toiBKtz4rM0lyEgblSmtot41atO0y0P6vAiEA+DjyhzY5xCh3P5bCUbebImSI1mlPTTFBVJtGdjaBsqI="}]},"_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-flow-cl_0.1.0_1783129651990_0.6236143058055883"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-04T01:47:31.858Z","0.1.0":"2026-07-04T01:47:32.130Z","modified":"2026-07-04T01:47:32.347Z"},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"description":"MCP server for Flow — Chile-native PSP: hosted payment orders (Webpay, ETpay, cash), refunds, HMAC-signed API","keywords":["mcp","flow","flow-cl","payments","psp","webpay","etpay","chile","clp"],"license":"MIT","readme":"# @codespar/mcp-flow-cl\n\n> MCP server for **Flow** (flow.cl) — the Chile-native PSP: one hosted payment order covers Webpay (credit/debit), ETpay bank transfer, cash networks and international cards. Refunds included. Every API call is HMAC-SHA256 signed.\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-flow-cl)](https://www.npmjs.com/package/@codespar/mcp-flow-cl)\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    \"flow-cl\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-flow-cl\"],\n      \"env\": {\n        \"FLOW_API_KEY\": \"your-flow-api-key\",\n        \"FLOW_SECRET_KEY\": \"your-flow-secret-key\",\n        \"FLOW_ENV\": \"sandbox\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add flow-cl --env FLOW_API_KEY=... --env FLOW_SECRET_KEY=... -- npx -y @codespar/mcp-flow-cl\n```\n\n### Cursor / VS Code\n\nAdd the same block to `.cursor/mcp.json` or `.vscode/mcp.json`.\n\n## Tools (8)\n\n| Tool | Endpoint | What it does |\n|---|---|---|\n| `create_payment` | `POST /payment/create` | Hosted payment order; returns `url + token` the customer pays at |\n| `create_payment_by_email` | `POST /payment/createEmail` | Flow emails the customer a collection link |\n| `get_payment_status` | `GET /payment/getStatus` | Status by Flow token (1 pending, 2 paid, 3 rejected, 4 canceled) |\n| `get_payment_status_by_commerce_id` | `GET /payment/getStatusByCommerceId` | Status by your `commerceOrder` |\n| `get_payment_status_by_flow_order` | `GET /payment/getStatusByFlowOrder` | Status by Flow order number |\n| `list_payments` | `GET /payment/getPayments` | Payments received on a date (paged) |\n| `create_refund` | `POST /refund/create` | Full or partial refund order |\n| `get_refund_status` | `GET /refund/getStatus` | Refund status by refund token |\n\n## Authentication\n\nFlow signs every request: parameters are sorted alphabetically, concatenated as `name+value`, and signed with HMAC-SHA256 using your `secretKey`. This server does the signing for you — set the two env vars and call tools with plain arguments.\n\n| Variable | Required | Description |\n|---|---|---|\n| `FLOW_API_KEY` | yes | Flow merchant API key |\n| `FLOW_SECRET_KEY` | yes | HMAC signing secret (never sent on the wire) |\n| `FLOW_ENV` | no | `sandbox` (default) or `production` |\n\nSandbox: register at [sandbox.flow.cl](https://sandbox.flow.cl) — the sandbox issues its own key pair.\n\n## Example\n\n> \"Create a Flow payment order for CLP 25,000, subject 'Plan Pro mensual', email cliente@ejemplo.cl, and give me the payment link.\"\n\nThe agent calls `create_payment` and returns `url?token=...` — the customer picks Webpay, ETpay or cash at Flow's hosted page.\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## Managed tier\n\nThis open-source server calls Flow's API directly with your credentials. CodeSpar's managed tier routes one interface across every LATAM provider with automatic failover, governance, audit and a credential vault: [codespar.dev/agents](https://codespar.dev/agents).\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-c3230fe690d3bc41c3b2ec0b1dea20c7"}