Client SDK and docs for MCP Billing Gateway — add Stripe + x402 billing to any MCP server
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add billing-gateway -- uvx mcp-billing-gateway~/.codex/config.toml
[mcp_servers.billing-gateway]
command = "uvx"
args = ["mcp-billing-gateway"]
# codex mcp add billing-gateway -- uvx mcp-billing-gateway~/.cursor/mcp.json
{
"mcpServers": {
"billing-gateway": {
"command": "uvx",
"args": [
"mcp-billing-gateway"
]
}
}
}.vscode/mcp.json
{
"servers": {
"billing-gateway": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-billing-gateway"
]
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"billing-gateway": {
"command": "uvx",
"args": [
"mcp-billing-gateway"
]
}
}
}claude_desktop_config.json
{
"mcpServers": {
"billing-gateway": {
"command": "uvx",
"args": [
"mcp-billing-gateway"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"billing-gateway": {
"command": "uvx",
"args": [
"mcp-billing-gateway"
]
}
}
}Remote
claude mcp add --transport http billing-gateway https://mcp-billing-gateway-production.up.railway.app/mcp/~/.codex/config.toml
[mcp_servers.billing-gateway]
url = "https://mcp-billing-gateway-production.up.railway.app/mcp/"
# codex mcp add billing-gateway --url https://mcp-billing-gateway-production.up.railway.app/mcp/~/.cursor/mcp.json
{
"mcpServers": {
"billing-gateway": {
"url": "https://mcp-billing-gateway-production.up.railway.app/mcp/"
}
}
}.vscode/mcp.json
{
"servers": {
"billing-gateway": {
"type": "http",
"url": "https://mcp-billing-gateway-production.up.railway.app/mcp/"
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"billing-gateway": {
"httpUrl": "https://mcp-billing-gateway-production.up.railway.app/mcp/"
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"billing-gateway": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp-billing-gateway-production.up.railway.app/mcp/"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"billing-gateway": {
"url": "https://mcp-billing-gateway-production.up.railway.app/mcp/"
}
}
}