MCP server for Openpay — BBVA-owned Mexican gateway (cards, SPEI, OXXO, subscriptions, payouts)
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add openpay --env OPENPAY_MERCHANT_ID='<OPENPAY_MERCHANT_ID>' --env OPENPAY_PRIVATE_KEY='<OPENPAY_PRIVATE_KEY>' -- npx -y @codespar/mcp-openpay~/.codex/config.toml
[mcp_servers.openpay]
command = "npx"
args = ["-y", "@codespar/mcp-openpay"]
env = { OPENPAY_MERCHANT_ID = "<OPENPAY_MERCHANT_ID>", OPENPAY_PRIVATE_KEY = "<OPENPAY_PRIVATE_KEY>" }
# codex mcp add openpay --env OPENPAY_MERCHANT_ID='<OPENPAY_MERCHANT_ID>' --env OPENPAY_PRIVATE_KEY='<OPENPAY_PRIVATE_KEY>' -- npx -y @codespar/mcp-openpay~/.cursor/mcp.json
{
"mcpServers": {
"openpay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-openpay"
],
"env": {
"OPENPAY_MERCHANT_ID": "<OPENPAY_MERCHANT_ID>",
"OPENPAY_PRIVATE_KEY": "<OPENPAY_PRIVATE_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"openpay": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-openpay"
],
"env": {
"OPENPAY_MERCHANT_ID": "<OPENPAY_MERCHANT_ID>",
"OPENPAY_PRIVATE_KEY": "<OPENPAY_PRIVATE_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"openpay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-openpay"
],
"env": {
"OPENPAY_MERCHANT_ID": "<OPENPAY_MERCHANT_ID>",
"OPENPAY_PRIVATE_KEY": "<OPENPAY_PRIVATE_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"openpay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-openpay"
],
"env": {
"OPENPAY_MERCHANT_ID": "<OPENPAY_MERCHANT_ID>",
"OPENPAY_PRIVATE_KEY": "<OPENPAY_PRIVATE_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"openpay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-openpay"
],
"env": {
"OPENPAY_MERCHANT_ID": "<OPENPAY_MERCHANT_ID>",
"OPENPAY_PRIVATE_KEY": "<OPENPAY_PRIVATE_KEY>"
}
}
}
}Environment variables
OPENPAY_MERCHANT_IDOPENPAY_PRIVATE_KEY
Replace the placeholders with your own credentials and keep them out of version control.