Endpoint
https://mcp.celopaygrid.xyz/mcpList tools
curl -X POST https://mcp.celopaygrid.xyz/mcp \
-H "content-type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Authentication
Read-only tools are public. Remote write tools require Authorization: Bearer <PAYGRID_MCP_API_KEY> or X-API-Key.
Current tools
| Tool | Auth | Purpose |
|---|---|---|
create_payment_request | API key | Create an agent-owned payment request on Celo. |
get_payment_request | public | Fetch a payment request and its state. |
verify_payment | public | Verify whether a payment request is paid. |
list_agent_requests | API key | List requests owned by the configured ERC-8004 agent. |
create_card_checkout | API key | Create a card-funded checkout session for an existing request. |
pay_x402_endpoint | API key | Call an x402-protected endpoint with caller-provided payment headers. |
get_supported_stablecoins | public | List supported Celo stablecoins and configured addresses. |
get_agent_capabilities | public | Return endpoints, auth model, current flows and guardrails. |
get_agent_connection_guide | public | Return MCP connection examples. |
get_celo_defi_context | public | Return Celo DeFi context for future agent spend features. |
Discover capabilities
curl -X POST https://mcp.celopaygrid.xyz/mcp \
-H "content-type: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_agent_capabilities","arguments":{}}}'Create a payment request
curl -X POST https://mcp.celopaygrid.xyz/mcp \
-H "content-type: application/json" \
-H "authorization: Bearer <PAYGRID_MCP_API_KEY>" \
-d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"create_payment_request","arguments":{"amount":"10.00","token":"USDC","description":"Agent service payment","recipientAddress":"0x...","acceptedMethods":["crypto","card"]}}}'Verify payment
curl -X POST https://mcp.celopaygrid.xyz/mcp \
-H "content-type: application/json" \
-d '{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"verify_payment","arguments":{"id":"<payment_request_id>"}}}'