APIs

Agent Connect · MCP

Plug AI agents into OpenPay Pro with Model Context Protocol — read-oriented wallet tools with OAuth-protected resources.

MCP endpoint

MCP server URL
https://openpaypro.space/mcp

REST helpers
https://openpaypro.space/.mcp/list-tools
https://openpaypro.space/.mcp/invoke-tool/$tool

OAuth protected resource metadata
https://openpaypro.space/.well-known/oauth-protected-resource

In-app setup UI: sign in → /connect

Authentication & permissions

The MCP server uses Supabase Auth OAuth (issuer JWT, audience authenticated). Clients complete OAuth when prompted. Tools act as the signed-in user.

All tools are read-only (readOnlyHint). Agents can answer questions about balances and history — they cannot silently transfer funds. Money moves go through Pro UI or Partner Transfer with explicit user consent.

Available tools

get_profile

Signed-in profile: display name, username, KYC status, account details. No input params.

list_wallets

Pro wallets with addresses and per-asset balances (OUSD, PI, SOL, USDC, …). No input params.

list_transactions

Recent wallet activity, newest first. Optional limit (1–100, default 20).

list_ledger_entries

Public ledger rows, newest first. Optional limit (1–100) and asset filter (e.g. OUSD, PI).

List & invoke (REST helpers)

# Discover tools
curl https://openpaypro.space/.mcp/list-tools

# Invoke (auth required — use your MCP client OAuth session)
POST https://openpaypro.space/.mcp/invoke-tool/list_ledger_entries
Content-Type: application/json

{ "limit": 10, "asset": "OUSD" }

Prefer the MCP transport at https://openpaypro.space/mcp from ChatGPT / Claude / Cursor rather than calling REST helpers by hand.

Client setup

Cursor / Claude Desktop style

{
  "mcpServers": {
    "openpay-pro": {
      "url": "https://openpaypro.space/mcp"
    }
  }
}

ChatGPT / Claude connectors

Add a custom MCP / connector pointing at the server URL above.
Complete OAuth when the client prompts (OpenPay Pro / Supabase Auth).
Ask the agent to list wallets or ledger entries — confirm tools appear after auth.

Product UI walkthrough: https://openpaypro.space/connect

Errors & troubleshooting

Not authenticated — finish OAuth; retry tool call.
Empty wallets / transactions — user has no Pro wallet yet; open /authpi once.
Tool missing — hit /.mcp/list-tools and refresh the client.
CORS / host — use production host openpaypro.space; trust forwarded host is enabled for MCP handlers.