Celo PayGrid Docs | MCP Reference

Endpoint

https://mcp.celopaygrid.xyz/mcp

List 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.
`quote_payment_request`	public	Quote exact-token or swap-enabled payment settlement.
`pay_payment_request`	API key	Prepare exact-token or swap-enabled approval and payment transactions.
`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"]}}}'

Quote a payment request

curl -X POST https://mcp.celopaygrid.xyz/mcp \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"quote_payment_request","arguments":{"id":"<payment_request_id>","payerToken":"USDT","maxSlippageBps":100}}}'

Quotes support USDC, USDT and USDm. If the payer token differs from the request token, Paygrid returns a Mento-first swap quote. Mainnet proof: 0xef8a70228255479df5b42ad57aa708a14b108faff4725c0cbcb4e1a4439ce4d5 shows USDT routed through Mento and settled as USDC.

Prepare a payment

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":6,"method":"tools/call","params":{"name":"pay_payment_request","arguments":{"id":"<payment_request_id>","payerToken":"USDT","maxSlippageBps":100,"preferExactToken":true}}}'

The response includes approval and payment transaction payloads. The recipient still receives the settlement token requested by the link.

Verify payment

curl -X POST https://mcp.celopaygrid.xyz/mcp \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":7,"method":"tools/call","params":{"name":"verify_payment","arguments":{"id":"<payment_request_id>"}}}'

Raw markdown Next: security model

MCP reference