{"_id":"@codespar/mcp-bold-co","name":"@codespar/mcp-bold-co","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@codespar/mcp-bold-co","version":"0.1.0","description":"MCP server for Bold — Colombian acquirer: payment links for cards, PSE, Nequi and Botón Bancolombia","type":"module","main":"./dist/index.js","bin":{"mcp-bold-co":"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","bold","payments","payment-links","pse","nequi","cards","colombia"],"mcpName":"io.github.codespar/mcp-bold-co","_id":"@codespar/mcp-bold-co@0.1.0","gitHead":"0cf000f9cad29acc97dc1e29789d180431c6fe12","types":"./dist/index.d.ts","_nodeVersion":"22.23.1","_npmVersion":"10.9.8","dist":{"integrity":"sha512-mAaYoue50/8WXBj2dMKGiGxfT5qu94AFWkCxZ11Y2pg0eshYbdVDXQA+/LObnmj7DP6jeZzqUEDlqBNNuEpj+A==","shasum":"9000d8d4f21d91cf68a20ee7958ef266d880d92d","tarball":"https://registry.npmjs.org/@codespar/mcp-bold-co/-/mcp-bold-co-0.1.0.tgz","fileCount":4,"unpackedSize":19969,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGCpBzrxqPk60JS4CMIqP52igZLlaZ7jFvxyocYAIdevAiEA6yi5cWhr7PibCF6eZAwX5+4384D5o59X888LFPbMElU="}]},"_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-bold-co_0.1.0_1783129579595_0.8189406151091518"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-04T01:46:19.448Z","0.1.0":"2026-07-04T01:46:19.746Z","modified":"2026-07-04T01:46:19.988Z"},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"description":"MCP server for Bold — Colombian acquirer: payment links for cards, PSE, Nequi and Botón Bancolombia","keywords":["mcp","bold","payments","payment-links","pse","nequi","cards","colombia"],"license":"MIT","readme":"# @codespar/mcp-bold-co\n\n> MCP server for **Bold** — Colombian acquirer (bold.co): payment links for cards, PSE, Nequi and Botón Bancolombia, plus the checkout integrity-signature and webhook-validation helpers.\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-bold-co)](https://www.npmjs.com/package/@codespar/mcp-bold-co)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\nBold's public integrations API is link-first: create a payment link (fixed or open amount), hand the payer `payload.url`, then poll the link until it reports `PAID`. The embedded checkout button flow is secured with a SHA-256 integrity signature and webhooks are HMAC-signed — both covered here as local tools.\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to `~/.config/claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"bold-co\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-bold-co\"],\n      \"env\": {\n        \"BOLD_API_KEY\": \"your-identity-key\",\n        \"BOLD_SECRET_KEY\": \"your-secret-key\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add bold-co --env BOLD_API_KEY=your-identity-key -- npx -y @codespar/mcp-bold-co\n```\n\n## Tools (7)\n\n| Tool | Description |\n|---|---|\n| `create_payment_link` | Create a payment link (`POST /online/link/v1`) — cards, PSE, Nequi, Botón Bancolombia |\n| `create_pse_payment_link` | Convenience: link restricted to PSE bank debit |\n| `create_card_payment_link` | Convenience: link restricted to cards |\n| `get_payment_link` | Query a link's status: ACTIVE, PROCESSING, PAID, REJECTED, EXPIRED |\n| `list_payment_methods` | Payment methods enabled for this merchant |\n| `generate_checkout_signature` | SHA-256 integrity hash for the embedded checkout button (local) |\n| `validate_webhook_signature` | Verify the HMAC signature on a Bold webhook (local) |\n\n## Environment\n\n| Variable | Required | Description |\n|---|---|---|\n| `BOLD_API_KEY` | yes | Identity key (llave de identidad), sent as `Authorization: x-api-key` |\n| `BOLD_SECRET_KEY` | no | Secret key — only for the local signature/webhook tools |\n\nBold has no separate sandbox host; test mode is driven by test keys from the Bold dashboard.\n\n## Docs\n\n- Provider docs: https://developers.bold.co\n- Managed tier (one interface across every LATAM provider, governance + audit): https://codespar.dev/agents\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent-driven payments on Bold? [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-e8a555df2e4e6a51472e01c96a0b79e5"}