MODEL CONTEXT PROTOCOL

Magpie MCP Server

Connect AI agents to the Magpie Payment Platform. Process payments, create checkouts, send invoices, and manage payment links through natural conversation.

GitHub npm OAuth Metadata Health

Quick Start

Add this to your Claude Desktop config and restart. No installation needed.

claude_desktop_config.json

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

Requires Node.js 18+ for npx / mcp-remote

How It Works

Connect

Add the config above and restart Claude Desktop. The mcp-remote bridge connects to the server automatically.

Authorize

Your browser opens to an OAuth flow. Enter your Magpie API keys from the Magpie Dashboard. This only happens once.

Use

Ask Claude to process payments, create checkout sessions, send invoices, or manage payment links. 33 tools are available.

Available Tools / 33 tools across 6 categories

Payment Sources 2

create_source get_source

Customers 6

create_customer get_customer update_customer get_customer_by_email attach_source_to_customer detach_source_from_customer

Charges 7

create_charge get_charge list_charges capture_charge void_charge refund_charge verify_charge

Checkout Sessions 5

create_checkout_session get_checkout_session list_checkout_sessions expire_checkout_session capture_checkout_session

Payment Requests 5

create_payment_request get_payment_request list_payment_requests void_payment_request resend_payment_request

Payment Links 6

create_payment_link get_payment_link list_payment_links update_payment_link activate_payment_link deactivate_payment_link

Utility Tools / 2 tools

Account 2

get_me get_magpie_api_reference

Supported Payment Methods

Method	Payments	Checkout	Requests	Links
Card	✓	✓	✓	✓
GCash	✓	✓	✓	✓
Maya	✓	✓	✓	✓
GrabPay	✓	✓	—	—
BPI	✓	✓	—	—
Alipay	✓	✓	—	—
UnionPay	✓	✓	—	—
WeChat Pay	✓	✓	—	—
QR PH	✓	—	—	—
InstaPay	✓	—	—	—

Self-Hosted / run it yourself

Install from npm

Run the MCP server locally. Provide your API keys as environment variables instead of using the hosted OAuth flow.

npm install -g magpie-mcp-server

Claude Desktop config (self-hosted)

Point Claude Desktop at the local server with your Magpie credentials:

{
  "mcpServers": {
    "magpie": {
      "command": "npx",
      "args": ["-y", "magpie-mcp-server"],
      "env": {
        "MAGPIE_PUBLIC_KEY": "your_public_key",
        "MAGPIE_SECRET_KEY": "your_secret_key"
      }
    }
  }
}