{"_id":"@codespar/mcp-clip","name":"@codespar/mcp-clip","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@codespar/mcp-clip","version":"0.1.0","description":"MCP server for Clip (PayClip) — Mexico's leading native acquirer: payment links, card charges, refunds","type":"module","main":"./dist/index.js","bin":{"mcp-clip":"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","clip","payclip","payments","acquirer","payment-link","checkout","mexico"],"mcpName":"io.github.codespar/mcp-clip","_id":"@codespar/mcp-clip@0.1.0","gitHead":"0cf000f9cad29acc97dc1e29789d180431c6fe12","types":"./dist/index.d.ts","_nodeVersion":"22.23.1","_npmVersion":"10.9.8","dist":{"integrity":"sha512-kgnEabS2uvc32eZu+ErcXvgw2Irxhtfe/jh3/VWM4SBy4H1+PGYHxc0M+XWeI6QYC0o95yoR3QYH9rqVgl2d0A==","shasum":"2434da61e8896f964ef6f20810d659a065348f71","tarball":"https://registry.npmjs.org/@codespar/mcp-clip/-/mcp-clip-0.1.0.tgz","fileCount":4,"unpackedSize":16308,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFvghJBuLU5kahXz/QSyLlgtUtPE40n3TV88pw/Eq0IlAiEA/gGYktKsVtnmvzLNqeuUKC+NMktbeHLrSMA+Uk318h4="}]},"_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-clip_0.1.0_1783129635853_0.5736419470287779"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-04T01:47:15.729Z","0.1.0":"2026-07-04T01:47:16.002Z","modified":"2026-07-04T01:47:16.233Z"},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"description":"MCP server for Clip (PayClip) — Mexico's leading native acquirer: payment links, card charges, refunds","keywords":["mcp","clip","payclip","payments","acquirer","payment-link","checkout","mexico"],"license":"MIT","readme":"# @codespar/mcp-clip\n\n> MCP server for **Clip (PayClip)** — Mexico's leading native acquirer. Hosted payment links, transparent card-token charges, queries and refunds, in MXN.\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-clip)](https://www.npmjs.com/package/@codespar/mcp-clip)\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    \"clip\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-clip\"],\n      \"env\": {\n        \"CLIP_AUTH_TOKEN\": \"your-basic-token\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add clip -- npx @codespar/mcp-clip\n```\n\n## Environment\n\n| Variable | Required | Description |\n|---|---|---|\n| `CLIP_AUTH_TOKEN` | yes | Basic auth token from the Clip developer dashboard (sent as `Authorization: Basic <token>`) |\n| `CLIP_BASE_URL` | no | API base override (default `https://api.payclip.com`) |\n\nTest mode: Clip distinguishes environments by the token itself — test tokens hit the sandbox processing path; there is no separate URL.\n\n## Tools (6)\n\n| Tool | What it does |\n|---|---|\n| `create_payment_link` | Hosted checkout link (`POST /v2/checkout`) — the no-PCI path |\n| `get_payment_link` | Checkout status by id |\n| `create_payment` | Transparent charge with a client-side card token (`POST /payments`) |\n| `get_payment` | Payment detail |\n| `list_payments` | List payments, paginated |\n| `refund_payment` | Full or partial refund (`POST /payments/{id}/refund`) |\n\nRaw card numbers are never accepted — `create_payment` takes a token from Clip's client-side SDK. When you have no tokenization front-end, use `create_payment_link`.\n\n## Example\n\n> \"Cobra 450 pesos por la consultoría y mándame el link.\"\n\nThe agent calls `create_payment_link` (`amount: 450.00`, `purchase_description: \"Consultoría\"`) and returns the `payment_request_url` for the buyer.\n\n## Authentication\n\nClip issues a single Basic auth token in the developer dashboard; the server sends it as `Authorization: Basic <CLIP_AUTH_TOKEN>` on every call.\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent-driven payments on Clip? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds a policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-975d0e664840ff39a5418a1656c38b45"}