mcp-bold-co — Claude Code MCP server for Bold payment links
mcp-bold-co — an MCP server for Bold, the Colombian acquirer. Agents create card, PSE, Nequi and Botón Bancolombia payment links and poll their status.
MIT ★ 279 updated 2026-09-27
claude mcp add mcp-bold-co -e BOLD_API_KEY=<BOLD_API_KEY> -e BOLD_SECRET_KEY=<BOLD_SECRET_KEY> -- npx -y @codespar/mcp-bold-coWhat mcp-bold-co does
Bold's integrations API is link-first. You create a payment link with a fixed or open amount, hand the payer payload.url, then poll until the link reports PAID. This server exposes that flow as seven tools: create a link, two convenience methods restricted to PSE or cards, status lookup, a list of payment methods, and two local helpers.
The local tools cover the embedded checkout button signature and webhook verification. generate_checkout_signature computes a SHA-256 integrity hash, validate_webhook_signature checks the HMAC on incoming Bold webhooks. Both run locally and need BOLD_SECRET_KEY; the API key alone handles link creation.
No separate sandbox host exists. Test mode comes from test keys in the Bold dashboard. The server needs BOLD_API_KEY set, and the secret key is optional unless you use the signature tools.
What it helps with
- create a payment link for cards, PSE, Nequi or Botón Bancolombia
- restrict a link to one method: PSE bank debit or cards only
- check a link's status: ACTIVE, PROCESSING, PAID, REJECTED, EXPIRED
- generate the SHA-256 checkout button integrity hash
- verify the HMAC signature on a Bold webhook
Example prompts for the agent
- Create a payment link for 50 000 COP restricted to cards with
create_card_payment_link - Poll the link status by its id through
get_payment_link - Compute the integrity signature for the embedded checkout button
How to install mcp-bold-co
Platform CLI
claude mcp add mcp-bold-co -e BOLD_API_KEY=<BOLD_API_KEY> -e BOLD_SECRET_KEY=<BOLD_SECRET_KEY> -- npx -y @codespar/mcp-bold-coReplace <…> with your own values
Platform CLI
codex mcp add bold-co --env BOLD_API_KEY=<BOLD_API_KEY> --env BOLD_SECRET_KEY=<BOLD_SECRET_KEY> -- npx -y @codespar/mcp-bold-coReplace <…> with your own values
Config file
{
"mcpServers": {
"bold-co": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-bold-co"
],
"env": {
"BOLD_API_KEY": "<BOLD_API_KEY>",
"BOLD_SECRET_KEY": "<BOLD_SECRET_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"bold-co": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-bold-co"
],
"env": {
"BOLD_API_KEY": "<BOLD_API_KEY>",
"BOLD_SECRET_KEY": "<BOLD_SECRET_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e BOLD_API_KEY=<BOLD_API_KEY> -e BOLD_SECRET_KEY=<BOLD_SECRET_KEY> bold-co npx -y @codespar/mcp-bold-coReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-bold-co
How do I install mcp-bold-co in Claude Code?
Run claude mcp add mcp-bold-co -e BOLD_API_KEY=<BOLD_API_KEY> -e BOLD_SECRET_KEY=<BOLD_SECRET_KEY> -- npx -y @codespar/mcp-bold-co. The server is then available in your Claude Code session.
What does mcp-bold-co do?
It gives an agent seven tools for Bold's payments API: links for cards, PSE, Nequi and Botón Bancolombia, status polling, the merchant's payment methods, and local helpers for checkout and webhook signatures.
Do I need BOLD_SECRET_KEY?
Link creation works with BOLD_API_KEY alone. The secret key is only required by the two local signature tools.