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
- Claude
- Claude Code
- Cursor
- VS Code
- Other clients
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_typeshould 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?”
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 examplePAYAZA_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
My assistant is not using the Payaza tools
My assistant is not using the Payaza tools
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”.
I get a 429 Too Many Requests error
I get a 429 Too Many Requests error
The server is rate limited per user. Wait a few minutes and try again.
My client does not support remote MCP servers
My client does not support remote MCP servers
Use the
mcp-remote bridge shown in the Other clients tab.