mcp-clip — Claude Code MCP server: Clip payments and links
An MCP server for taking payments through Clip (PayClip) in Mexico. Agents get hosted payment links, card-token charges, refunds and payment lookups, priced in MXN.
claude mcp add --env CLIP_AUTH_TOKEN=<CLIP_AUTH_TOKEN> --env CLIP_BASE_URL=<CLIP_BASE_URL> --transport stdio clip -- npx -y @codespar/mcp-clipWhat mcp-clip does
Six tools come with it. create_payment_link produces a hosted checkout page and get_payment_link reports on it. create_payment charges a card token issued by Clip's client-side SDK; get_payment and list_payments return payment details and a paged list. refund_payment covers full or partial money-back. The server never takes a raw card number, so without a tokenisation front-end the payment link is the path you have. Get the Basic token from the Clip developer dashboard and pass it as CLIP_AUTH_TOKEN; the token alone decides whether calls hit test mode, no separate sandbox URL exists.
What it helps with
- send a customer a payable checkout link in MXN
- charge a card through a token without handling the number
- check whether a payment link was paid
- page through past payments
- refund a payment in full or in part
Example prompts for the agent
- Make a 450.00 MXN payment link for the consulting gig and send it to the client.
- What is the status of this morning's payment link?
- Issue a partial refund on the latest payment.
How to install mcp-clip
Platform CLI
claude mcp add --env CLIP_AUTH_TOKEN=<CLIP_AUTH_TOKEN> --env CLIP_BASE_URL=<CLIP_BASE_URL> --transport stdio clip -- npx -y @codespar/mcp-clipReplace <…> with your own values
Platform CLI
codex mcp add clip --env CLIP_AUTH_TOKEN=<CLIP_AUTH_TOKEN> --env CLIP_BASE_URL=<CLIP_BASE_URL> -- npx -y @codespar/mcp-clipReplace <…> with your own values
Config file
{
"mcpServers": {
"clip": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-clip"
],
"env": {
"CLIP_AUTH_TOKEN": "<CLIP_AUTH_TOKEN>",
"CLIP_BASE_URL": "<CLIP_BASE_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"clip": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-clip"
],
"env": {
"CLIP_AUTH_TOKEN": "<CLIP_AUTH_TOKEN>",
"CLIP_BASE_URL": "<CLIP_BASE_URL>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e CLIP_AUTH_TOKEN=<CLIP_AUTH_TOKEN> -e CLIP_BASE_URL=<CLIP_BASE_URL> clip npx -y @codespar/mcp-clipReplace <…> 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-clip
How do I install mcp-clip in Claude Code?
Run claude mcp add mcp-clip -e CLIP_AUTH_TOKEN=<CLIP_AUTH_TOKEN> -- npx -y @codespar/mcp-clip. To point it at a different API base, use the longer form: claude mcp add --env CLIP_AUTH_TOKEN=<CLIP_AUTH_TOKEN> --env CLIP_BASE_URL=<CLIP_BASE_URL> --transport stdio clip -- npx -y @codespar/mcp-clip.
What does mcp-clip do?
It lets an agent create Clip payment links, take card-token charges, read payment details and issue refunds, all denominated in MXN.
What does mcp-clip need to run?
A Basic auth token from the Clip developer dashboard, supplied as CLIP_AUTH_TOKEN. Test mode is chosen by the token itself, since there is no separate sandbox URL.
