API docs

Learn how to best use the Mambu Payments (formerly Numeral) API docs

The Mambu Payments API docs are a versatile tool to specific, develop, and test your integration.

1. Integrate with the sandbox

You can also connect to the Mambu Payments sandbox, make API requests, and receive responses directly from the API reference by adding your API key in the Authentication field of any API endpoint page.

2. Download the OpenAPI specification

The Mambu Payments OpenAPI specification can be downloaded at https://docs.numeral.io/openapi.

3. Use the MCP server

The Mambu Payments model context protocol (MCP) server enables AI-powered code editors like Cursor and Windsurf, plus general-purpose tools like Claude Desktop, to interact directly with your Mambu Payments API docs and API.

What is MCP?

Model context protocol (MCP) is an open standard that allows AI applications to securely access external data sources and tools. The Mambu Payments MCP server provides AI agents with:

  • Direct API access to Mambu Payments features
  • Documentation search capabilities
  • Real-time data from your Mambu Payments account
  • Code generation assistance for Mambu Payments integrations

Mambu Payments MCP server setup

Mambu Payments hosts a remote MCP server at https://docs.numeral.io/mcp. Configure your AI development tools to connect to this server. If your APIs require authentication, you can pass in headers via query parameters or however headers are configured in your MCP client.

Add to~/.cursor/mcp.json:

{
  "mcpServers": {
    "numeral": {
      "url": "https://docs.numeral.io/mcp"
    }
  }
}

Testing your MCP setup

Once configured, you can test your MCP server connection:

  1. Open your AI editor (Cursor, Windsurf, etc.)
  2. Start a new chat with the AI assistant
  3. Ask about Mambu Payments - try questions like:
    • "How do I [common use case]?"
    • "Show me an example of [API functionality]"
    • "Create a [integration type] using Mambu Payments"

The AI should now have access to your Mambu Payments account data and documentation through the MCP server.