Openpay MCP Server
by codespario.github.codespar/mcp-openpayv0.2.2
MCP server for Openpay — BBVA-owned Mexican gateway (cards, SPEI, OXXO, subscriptions, payouts)
context tax
queued
security
queued
cold start
queued
freshness
Active12d ago
Install Openpay MCP server
Install in Claude Code
claude mcp add openpay -e OPENPAY_MERCHANT_ID='<openpay-merchant-id>' -e OPENPAY_PRIVATE_KEY='<openpay-private-key>' -- npx -y @codespar/mcp-openpayInstall in Cursor
{
"mcpServers": {
"openpay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-openpay"
],
"env": {
"OPENPAY_MERCHANT_ID": "<openpay-merchant-id>",
"OPENPAY_PRIVATE_KEY": "<openpay-private-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"openpay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-openpay"
],
"env": {
"OPENPAY_MERCHANT_ID": "<openpay-merchant-id>",
"OPENPAY_PRIVATE_KEY": "<openpay-private-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"openpay": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-openpay"
],
"env": {
"OPENPAY_MERCHANT_ID": "<openpay-merchant-id>",
"OPENPAY_PRIVATE_KEY": "<openpay-private-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"openpay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-openpay"
],
"env": {
"OPENPAY_MERCHANT_ID": "<openpay-merchant-id>",
"OPENPAY_PRIVATE_KEY": "<openpay-private-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| OPENPAY_MERCHANT_ID | yes | — | Openpay merchant id (forms part of the API URL path) |
| OPENPAY_PRIVATE_KEY | yes | yes | Openpay private API key (used as HTTP Basic auth username with empty password) |
| OPENPAY_ENV | — | — | Environment: 'sandbox' (default) or 'production'. Selects between https://sandbox-api.openpay.mx and https://api.openpay.mx. |
Freshness
Active — last maintenance signal 12d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-27 · 12d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-06-22 · 4mo ago · official registry · v0.2.2
FAQ
›How do I install the Openpay MCP server in Claude Code?
Run: claude mcp add openpay -e OPENPAY_MERCHANT_ID='<openpay-merchant-id>' -e OPENPAY_PRIVATE_KEY='<openpay-private-key>' -- npx -y @codespar/mcp-openpay. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Openpay require an API key?
Yes. It expects OPENPAY_MERCHANT_ID, OPENPAY_PRIVATE_KEY, of which 1 is a secret.
›Can I use Openpay as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Openpay in the official MCP registry?
Yes, as io.github.codespar/mcp-openpay.