# mcp-bold-co

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 279 repo stars
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/colombia/bold-co
- Updated: 2026-09-27
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-bold-co

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `BOLD_API_KEY`, `BOLD_SECRET_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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

### Codex

**Platform CLI**
```bash
codex mcp add bold-co --env BOLD_API_KEY=<BOLD_API_KEY> --env BOLD_SECRET_KEY=<BOLD_SECRET_KEY> -- npx -y @codespar/mcp-bold-co
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e BOLD_API_KEY=<BOLD_API_KEY> -e BOLD_SECRET_KEY=<BOLD_SECRET_KEY> bold-co npx -y @codespar/mcp-bold-co
```
Replace <…> with your own values

## When to use it
- 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
- 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

## Similar
- [energia](https://affpapa.org/en/nevibecode/plugins/energia.md) — plugin · ★ 60 repo stars
- [IBANforge](https://affpapa.org/en/nevibecode/mcp/ibanforge.md) — MCP server · 4179 installs
- [bold](https://affpapa.org/en/nevibecode/skills/bold.md) — skill · 2800 installs
- [okx-agent-payments-protocol](https://affpapa.org/en/nevibecode/skills/okx-agent-payments-protocol.md) — skill · 16200 installs
- [solar-duotone-bold](https://affpapa.org/en/nevibecode/skills/solar-duotone-bold.md) — skill · 1700 installs
- [MoltPe](https://affpapa.org/en/nevibecode/mcp/moltpe.md) — MCP server · 170 installs

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 125 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
