Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
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
Open on GitHub

What 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-co

Replace <…> 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.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

From the same set125

The whole set →
mcp-braspag Gives coding agents access to the Braspag orchestration API from Cielo Group. It handles sales, card tokenization in Cartão Protegido, and recurring billing. CX Codex +1 ★ 279repo stars mcp-brasil-api mcp-brasil-api hands your agent Brazilian public data: addresses by CEP, companies by CNPJ, banks, holidays, weather and FIPE vehicle prices. CX Codex +1 ★ 279repo stars mcp-braintree Connects AI assistants to the Braintree GraphQL API. Lets agents process charges, store payment methods in the vault, and track payment disputes. CX Codex +1 ★ 279repo stars mcp-bradesco This MCP server lets an agent use Bradesco APIs for Pix, boletos, statements, and transfers. OAuth2 credentials and an mTLS certificate are required. CX Codex +1 ★ 279repo stars mcp-bling Connects your assistant to the Bling ERP platform. Lets you query inventory, generate invoices, and handle sales orders via chat. CX Codex +1 ★ 279repo stars mcp-bitso Connect an AI agent to Bitso to inspect market data, manage orders, and check account balances. API credentials are required. CX Codex +1 ★ 279repo stars mcp-bigdatacorp Wires BigDataCorp into your agent: CPF and CNPJ lookups, vehicles, property, antifraud scoring. Useful when you build onboarding or credit flows for Brazil. CX Codex +1 ★ 279repo stars mcp-belvo MCP server interfacing with Belvo Open Finance in Latin America. Enables your AI assistant to retrieve bank transactions, account balances, and tax records during coding sessions. CX Codex +1 ★ 279repo stars

Project sponsors

Companies that keep this analytics open