INSTALL GUIDE

Install Magpie MCP Server

Connect your AI agent to the Magpie Payment Platform. 33 tools covering payments, customers, checkout, invoices, and payment links.

Home GitHub npm

Hosted Server Recommended

No installation required. Connect via OAuth at https://mcp.magpie.im/mcp — your API keys are stored securely on the server.

⌨️ Cursor

Install in Cursor

Or add manually to ~/.cursor/mcp.json

~/.cursor/mcp.json

{
  "mcpServers": {
    "magpie": {
      "url": "https://mcp.magpie.im/mcp"
    }
  }
}

🔷 VS Code

Install in VS Code

Or add manually to .vscode/mcp.json

.vscode/mcp.json

{
  "servers": {
    "magpie": {
      "type": "http",
      "url": "https://mcp.magpie.im/mcp"
    }
  }
}

🤖 Claude Desktop & Claude Code

Desktop

Code

Add to claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "magpie": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.magpie.im/mcp"]
    }
  }
}

Run in your terminal

Terminal

claude mcp add --transport http magpie https://mcp.magpie.im/mcp

🏄 Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "magpie": {
      "serverUrl": "https://mcp.magpie.im/mcp"
    }
  }
}

💬 ChatGPT

Pro / Plus / Business / Enterprise

Go to Settings → Connectors → Add custom connector
Server URL: https://mcp.magpie.im/mcp
Auth: OAuth

Self-Hosted / run it yourself

Your API keys stay on your machine. Requires Node.js 18+.

⌨️ Cursor

Install in Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "magpie": {
      "command": "npx",
      "args": ["-y", "magpie-mcp-server"],
      "env": {
        "MAGPIE_PUBLIC_KEY": "pk_live_...",
        "MAGPIE_SECRET_KEY": "sk_live_..."
      }
    }
  }
}

🔷 VS Code prompts for keys

Install in VS Code

VS Code will prompt you for your API keys on first launch.

.vscode/mcp.json

{
  "inputs": [
    { "type": "promptString", "id": "pub", "description": "Magpie Public Key" },
    { "type": "promptString", "id": "sec", "description": "Magpie Secret Key", "password": true }
  ],
  "servers": {
    "magpie": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "magpie-mcp-server"],
      "env": {
        "MAGPIE_PUBLIC_KEY": "${input:pub}",
        "MAGPIE_SECRET_KEY": "${input:sec}"
      }
    }
  }
}

🤖 Claude Desktop

claude_desktop_config.json

{
  "mcpServers": {
    "magpie": {
      "command": "npx",
      "args": ["-y", "magpie-mcp-server"],
      "env": {
        "MAGPIE_PUBLIC_KEY": "pk_live_...",
        "MAGPIE_SECRET_KEY": "sk_live_..."
      }
    }
  }
}

📦 Global npm install

faster startup · offline use

Terminal

npm install -g magpie-mcp-server

Then replace npx -y magpie-mcp-server with magpie-mcp-server in any config above.

OpenClaw

🦞 OpenClaw Agent

Hosted

Self-Hosted

Add to ~/.openclaw/openclaw.json

~/.openclaw/openclaw.json

{
  "mcpServers": {
    "magpie": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.magpie.im/mcp"]
    }
  }
}

Add to ~/.openclaw/openclaw.json

~/.openclaw/openclaw.json

{
  "mcpServers": {
    "magpie": {
      "command": "npx",
      "args": ["-y", "magpie-mcp-server"],
      "env": {
        "MAGPIE_PUBLIC_KEY": "pk_live_...",
        "MAGPIE_SECRET_KEY": "sk_live_..."
      }
    }
  }
}

After updating, restart the OpenClaw gateway: openclaw gateway restart

Available Tools / 33 tools

Sources

create_source · get_source

Customers

create · get · update
find · attach · detach

Charges

create · get · list
capture · void · refund · verify

Checkout

create · get · list
expire · capture

Payment Requests

create · get · list
void · resend

Payment Links

create · get · list
update · activate · deactivate