@codespar/mcp-bold-co (Model Context Protocol) Server

This MCP server provides Bold (bold.co) integration for link-based payments in Colombia. It supports creating payment links for cards, PSE, Nequi, and Botón Bancolombia, and includes helpers for checkout integrity-signature and webhook-validation. The public integrations API is described as link-first: create a link, give the payer payload.url, then poll until the link reports PAID.

🛠️ Key Features

Payment links for cards
Payment links for PSE
Payment links for Nequi
Payment links for Botón Bancolombia
Checkout integrity-signature helpers
Webhook-validation helpers

🚀 Use Cases

Generating payer URLs for Colombian acquirer payments
Handling payment confirmation by polling until PAID
Validating webhook events and request integrity

⚡ Developer Benefits

Uses Bold’s link-first flow via payload.url
Adds signature and webhook validation support for checkout flows

⚠️ Limitations

Described scope is Colombia link-based payments and related signature/webhook helpers (no additional payment methods or regions are specified)

@codespar/mcp-bold-co

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.

Bold'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.

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json

{
  "mcpServers": {
    "bold-co": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-bold-co"],
      "env": {
        "BOLD_API_KEY": "your-identity-key",
        "BOLD_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

Claude Code

bash

claude mcp add bold-co --env BOLD_API_KEY=your-identity-key -- npx -y @codespar/mcp-bold-co

Tools (7)

Tool

Description

create_payment_link

Create a payment link (POST /online/link/v1) — cards, PSE, Nequi, Botón Bancolombia

create_pse_payment_link

Convenience: link restricted to PSE bank debit

create_card_payment_link

Convenience: link restricted to cards

get_payment_link

Query a link's status: ACTIVE, PROCESSING, PAID, REJECTED, EXPIRED

list_payment_methods

Payment methods enabled for this merchant

generate_checkout_signature

SHA-256 integrity hash for the embedded checkout button (local)

validate_webhook_signature

Verify the HMAC signature on a Bold webhook (local)

Variable

Required

Description

BOLD_API_KEY

yes

Identity key (llave de identidad), sent as Authorization: x-api-key

BOLD_SECRET_KEY

Secret key — only for the local signature/webhook tools

Install

Configuration

Environment variables

BOLD_API_KEYrequiredsecret

Bold identity API key (llave de identidad), sent as x-api-key

BOLD_SECRET_KEYsecret

Bold secret key. Only needed for the local checkout-signature and webhook-validation tools.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-bold-co": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-bold-co@0.1.0"
      ],
      "env": {
        "BOLD_API_KEY": "<YOUR_BOLD_API_KEY>",
        "BOLD_SECRET_KEY": "<YOUR_BOLD_SECRET_KEY>"
      }
    }
  }
}

io.github.codespar/mcp-bold-co

@codespar/mcp-bold-co (Model Context Protocol) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

@codespar/mcp-bold-co

Quick Start

Claude Desktop

Claude Code

Tools (7)

Environment

Docs

Enterprise

License

Install

Configuration

Related servers