Supercharge your AI agents with Macropay as a Model Context Protocol (MCP) server.

What is MCP?

MCP is a protocol for integrating tools with AI agents. It can greatly enhance the capabilities of your AI agents by providing them with real-time data and context. Macropay offers a remote MCP server that you can connect to from most AI clients.

How does it work?

You need a MCP-capable agent environment to use Macropay over MCP. A few of them are Claude Desktop and Cursor.

Connecting to Macropay MCP

Macropay provides two MCP servers:
  • Production: https://mcp.macropay.com/mcp/macropay-mcp - Connect to your live Macropay organization
  • Sandbox: https://mcp.macropay.com/mcp/macropay-sandbox - Connect to the Macropay sandbox environment for testing
When you can specify a MCP URL, use one of the URLs above depending on your environment. If you have to specify a command, use:
{
  "mcpServers": {
    "Macropay": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.macropay.com/mcp/macropay-mcp"]
    }
  }
}
For sandbox:
{
  "mcpServers": {
    "Macropay Sandbox": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.macropay.com/mcp/macropay-sandbox"]
    }
  }
}

Cursor

In .cursor/mcp.json, add:
{
  "mcpServers": {
    "Macropay": {
      "url": "https://mcp.macropay.com/mcp/macropay-mcp"
    }
  }
}
For sandbox:
{
  "mcpServers": {
    "Macropay Sandbox": {
      "url": "https://mcp.macropay.com/mcp/macropay-sandbox"
    }
  }
}

Windsurf

In mcp_config.json, add:
{
  "mcpServers": {
    "Macropay": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.macropay.com/mcp/macropay-mcp"]
    }
  }
}
For sandbox:
{
  "mcpServers": {
    "Macropay Sandbox": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.macropay.com/mcp/macropay-sandbox"]
    }
  }
}

Codex

Add the following to your ~/.codex/config.toml:
[features]
rmcp_client = true

[mcp_servers.macropay]
type = "http"
url = "https://mcp.macropay.com/mcp/macropay-mcp"
Then run:
codex mcp login macropay
For sandbox:
[features]
rmcp_client = true

[mcp_servers.macropay_sandbox]
type = "http"
url = "https://mcp.macropay.com/mcp/macropay-sandbox"
Then run:
codex mcp login macropay_sandbox

Claude Code

Run the following command:
claude mcp add --transport http "Macropay" "https://mcp.macropay.com/mcp/macropay-mcp"
For sandbox:
claude mcp add --transport http "Macropay-Sandbox" "https://mcp.macropay.com/mcp/macropay-sandbox"

ChatGPT

MCP is only available for paid users in beta on ChatGPT web, by enabling Developer Mode. Once Developer Mode is enabled, go to Settings -> Connectors and add the MCP server using https://mcp.macropay.com/mcp/macropay-mcp. For sandbox, use https://mcp.macropay.com/mcp/macropay-sandbox instead.

Claude Desktop

Go to Settings -> Connectors and click Add custom connector. Name it “Macropay” and add https://mcp.macropay.com/mcp/macropay-mcp as the server URL. For sandbox, use https://mcp.macropay.com/mcp/macropay-sandbox as the server URL instead. Save, and click Connect to connect to your Macropay organization.