io.github.codespar/mcp-clip

io.github.codespar/mcp-clip · 273 stars · TypeScript · MIT

MCP server MCP server for Clip (PayClip) — Mexico's leading acquirer: payment links, card charges, refunds

Install

The repo has no one-line install. Follow its README.

Published as

npm@codespar/mcp-clipstdio

From the server's entry in the official MCP Registry.

Open the repo

Configuration

Name	Set as	What it is
`CLIP_AUTH_TOKEN`Required · Secret	Env var	Basic auth token from the Clip developer dashboard
`CLIP_BASE_URL`Optional	Env var	API base URL override. Defaults to https://api.payclip.com.

Files

packages/mexico/clip/README.md

@codespar/mcp-clip

MCP server for Clip (PayClip) — Mexico's leading native acquirer. Hosted payment links, transparent card-token charges, queries and refunds, in MXN.

Quick Start

Claude Desktop

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

{
  "mcpServers": {
    "clip": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-clip"],
      "env": {
        "CLIP_AUTH_TOKEN": "your-basic-token"
      }
    }
  }
}

Claude Code

claude mcp add clip -- npx @codespar/mcp-clip

Environment

Variable	Required	Description
`CLIP_AUTH_TOKEN`	yes	Basic auth token from the Clip developer dashboard (sent as `Authorization: Basic <token>`)
`CLIP_BASE_URL`	no	API base override (default `https://api.payclip.com`)

Test mode: Clip distinguishes environments by the token itself — test tokens hit the sandbox processing path; there is no separate URL.

Tools (6)

Tool	What it does
`create_payment_link`	Hosted checkout link (`POST /v2/checkout`) — the no-PCI path
`get_payment_link`	Checkout status by id
`create_payment`	Transparent charge with a client-side card token (`POST /payments`)
`get_payment`	Payment detail
`list_payments`	List payments, paginated
`refund_payment`	Full or partial refund (`POST /payments/{id}/refund`)

Raw card numbers are never accepted — create_payment takes a token from Clip's client-side SDK. When you have no tokenization front-end, use create_payment_link.

Example

"Cobra 450 pesos por la consultoría y mándame el link."

The agent calls create_payment_link (amount: 450.00, purchase_description: "Consultoría") and returns the payment_request_url for the buyer.

Authentication

Clip issues a single Basic auth token in the developer dashboard; the server sends it as Authorization: Basic <CLIP_AUTH_TOKEN> on every call.

Enterprise

Need governance, budget limits, and audit trails for agent-driven payments on Clip? CodeSpar Enterprise adds a policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

Facts

Kind: MCP server
Repo: codespar/mcp-dev-latam
Group: Uncategorized
Stars: 273
License: MIT
Language: TypeScript
Last push: 2026-09-27
Forks: 50
MCP Registry: io.github.codespar/mcp-clip
Homepage: codespar.dev/servers
Topics: agentic-commerce, ai-agents, brazil, claude, fintech, latin-america, llm-tools, mcp, model-context-protocol, nfe, open-finance, payments, pix