Skip to main content
The Payaza documentation ships with a hosted Model Context Protocol (MCP) server. Once you connect it, your AI assistant can search these docs and the API reference while it writes code for you, so its answers use the real Payaza endpoints, headers and field names instead of guesses. Server URL
The MCP server is read-only. It searches public documentation only. It does not need your API keys, cannot see your Payaza account, and cannot move money.

What your assistant can do with it

  • Search the Payaza guides and API reference (collections, transfers, virtual accounts, subscriptions, webhooks and more).
  • Read a full docs page, including request and response examples.
  • Answer integration questions such as “which headers does the card charge endpoint need?” with the answer taken from the docs.

Connect your AI tool

Works in Claude on the web and in the Claude desktop app.
1

Open Connectors

2

Add a custom connector

Click Add custom connector. Set the name to Payaza and the URL to https://docs.payaza.africa/mcp, then click Add.
3

Use it in a chat

In a chat, click the attachments (+) button and turn on Payaza.

Try it

Once connected, ask your assistant something that needs the Payaza docs. For example:
  • “Using the Payaza docs, write an Express route that creates a dynamic virtual account with payaza-node-sdk.”
  • “How do I verify a Payaza webhook signature in Spring Boot?”
  • “Which transaction_type should I use to send a payout to a mobile wallet in Ghana?”
  • “My card charge timed out. How do I check whether the customer was charged before I retry?”
Pair the MCP server with an official SDK. Tell your assistant to use the Node.js SDK or the Java SDK, and it will handle authentication headers and request shapes for you.

Keep your keys safe

The MCP server never needs your keys, so never paste them into an AI chat. Keep them in environment variables (for example PAYAZA_PUBLIC_KEY) and use test mode keys while you build. If a key is exposed, regenerate it under Settings > Developers on the Payaza dashboard.

Troubleshooting

Make sure the server is turned on for the current chat or workspace, then mention Payaza in your prompt, for example “check the Payaza docs”.
The server is rate limited per user. Wait a few minutes and try again.
Use the mcp-remote bridge shown in the Other clients tab.
Still stuck? Ask in the Payaza Developers Discord or email integrationsupport@payaza.africa.