Macropay over Model Context Protocol (MCP)

Macropay ships a hosted Model Context Protocol (MCP) server, so any MCP-capable assistant or agent can read and act on your account in plain language — “what did we bill last week?”, “create a sandbox product”, “list customers with an active subscription” — without you writing a line of glue code. Because Macropay is the merchant of record, those same agents operate on top of tax-compliant, dispute-managed billing data. The numbers an agent reads back are already net of the sales tax and VAT we remit on your behalf.

Why connect over MCP

Conversational ops

Query orders, customers, and revenue from inside your AI client — no dashboard tab-switching.

Agent tooling

Expose Macropay as a first-class tool so autonomous agents can manage products and read billing context.

Safe to experiment

Point at the sandbox server to try destructive actions against test data before touching production.

What you’ll need

An MCP-capable client — Claude Desktop, Claude Code, Cursor, Windsurf, Codex, or ChatGPT (Developer Mode).
A Macropay account. The server authenticates you through your client’s standard MCP login flow on first connect.

Choose your server

Macropay exposes two remote endpoints. Pick the one that matches the environment you want the agent to touch.

Environment	URL	Use it for
Production	`https://mcp.macropay.ai/mcp/macropay-mcp`	Your live organization and real billing data
Sandbox	`https://mcp.macropay.ai/mcp/macropay-sandbox`	Testing against disposable data

The production server acts on real customers, orders, and payouts. When you’re prototyping agent behavior, connect to the sandbox endpoint first.

Anywhere a client lets you paste a raw MCP URL, use one of the two above. If a client instead wants a launch command, wrap the URL with mcp-remote:

{
  "mcpServers": {
    "Macropay": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.macropay.ai/mcp/macropay-mcp"]
    }
  }
}

{
  "mcpServers": {
    "Macropay Sandbox": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.macropay.ai/mcp/macropay-sandbox"]
    }
  }
}

Client setup

Configuration differs slightly per client. Find yours below — each tab shows the production setup, with the sandbox variant alongside it.

Add the server to .cursor/mcp.json:

{
  "mcpServers": {
    "Macropay": {
      "url": "https://mcp.macropay.ai/mcp/macropay-mcp"
    }
  }
}

{
  "mcpServers": {
    "Macropay Sandbox": {
      "url": "https://mcp.macropay.ai/mcp/macropay-sandbox"
    }
  }
}

Add the server to mcp_config.json:

{
  "mcpServers": {
    "Macropay": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.macropay.ai/mcp/macropay-mcp"]
    }
  }
}

{
  "mcpServers": {
    "Macropay Sandbox": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.macropay.ai/mcp/macropay-sandbox"]
    }
  }
}

Add the server to ~/.codex/config.toml, then run the login command.

[features]
rmcp_client = true

[mcp_servers.macropay]
type = "http"
url = "https://mcp.macropay.ai/mcp/macropay-mcp"

[features]
rmcp_client = true

[mcp_servers.macropay_sandbox]
type = "http"
url = "https://mcp.macropay.ai/mcp/macropay-sandbox"

codex mcp login macropay

For sandbox, log in with codex mcp login macropay_sandbox instead.

claude mcp add --transport http "Macropay" "https://mcp.macropay.ai/mcp/macropay-mcp"

For sandbox:

claude mcp add --transport http "Macropay-Sandbox" "https://mcp.macropay.ai/mcp/macropay-sandbox"

MCP support is in beta and limited to paid ChatGPT web accounts with Developer Mode turned on.

Enable Developer Mode

Turn on Developer Mode in your ChatGPT settings.

Add the connector

Open Settings → Connectors and add the MCP server https://mcp.macropay.ai/mcp/macropay-mcp. For testing, use https://mcp.macropay.ai/mcp/macropay-sandbox instead.

Open connector settings

Go to Settings → Connectors and click Add custom connector.

Add the server

Name it Macropay and set the server URL to https://mcp.macropay.ai/mcp/macropay-mcp. For sandbox, use https://mcp.macropay.ai/mcp/macropay-sandbox.

Connect

Save, then click Connect to authenticate against your Macropay organization.

Once connected, try a read-only prompt first — for example “summarize this month’s orders” — to confirm the agent is reaching the right environment before you let it create or modify anything.

Bootup

Features

Integrate

Merchant of Record (MoR)

Macropay over Model Context Protocol (MCP)

Why connect over MCP

Conversational ops

Agent tooling

Safe to experiment

What you’ll need

Choose your server

Client setup

​Why connect over MCP

Conversational ops

Agent tooling

Safe to experiment

​What you’ll need

​Choose your server

​Client setup

Why connect over MCP

What you’ll need

Choose your server

Client setup