PactPay MCP Server

PactPay MCP server for browser-based authentication, organization and plan queries, balance checks, and API key management.

Package:

• @pactpay/mcp-server

Defaults:

• API: https://pactpay.app
• Web: https://pactpay.app

Optional endpoint overrides:

• PACTPAY_BASE_URL
• PACTPAY_WEB_BASE_URL

No manual configuration is required for tokens, email login, org ID, or auth callback port.

Install

npx -y @pactpay/mcp-server

Or:

npm i -g @pactpay/mcp-server
pactpay-mcp-server

Configuration

Codex CLI

~/.codex/config.toml

[mcp_servers.pactpay]
command = "npx"
args = ["-y", "@pactpay/mcp-server"]
startup_timeout_sec = 60

With custom endpoints:

[mcp_servers.pactpay]
command = "npx"
args = ["-y", "@pactpay/mcp-server"]
startup_timeout_sec = 60

[mcp_servers.pactpay.env]
PACTPAY_BASE_URL = "https://pactpay.app"
PACTPAY_WEB_BASE_URL = "https://pactpay.app"

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "pactpay": {
      "command": "npx",
      "args": ["-y", "@pactpay/mcp-server"]
    }
  }
}

VS Code / Copilot

.vscode/mcp.json

{
  "servers": {
    "pactpay": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@pactpay/mcp-server"]
    }
  }
}

Claude Code

claude mcp add pactpay --scope project -- npx -y @pactpay/mcp-server

Auth Flow

1. Start the MCP server.
2. Call get_auth_url, open_auth_browser, or any protected tool.
3. The server opens the browser to the PactPay auth page.
4. If the browser already has an active PactPay session, authorization completes automatically.
5. If not, sign in and the token is returned to the local MCP server automatically.
6. The server automatically selects the first manageable organization as the default context.