API docs

Learn how to use the Mambu Payments API docs to specify, develop, and test your integration.

1. Integrate with the sandbox

Connect to the Mambu Payments sandbox, make API requests, and receive responses directly from the API reference. Add your API key in the Credentials section of any API endpoint page.

2. Download the OpenAPI specification

Download the Mambu Payments OpenAPI specifications at https://docs.numeral.io/openapi.

3. API docs MCP server

The Mambu Payments MCP server enables AI-powered code editors like Cursor and Windsurf – and 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 gives AI agents:

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

MCP server setup

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

Cursor – add to ~/.cursor/mcp.json:

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

Windsurf – add to ~/.codeium/windsurf/mcp_config.json:

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

Claude Desktop – add to claude_desktop_config.json:

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

Testing your MCP setup

Open your AI editor.
Start a new chat with the AI assistant.
Ask about Mambu Payments – for example:
- "How do I [common use case]?"
- "Show me an example of [API functionality]."
- "Create a [integration type] using Mambu Payments."

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

4. LLMs.txt and .md files

docs.numeral.io/llms.txt is a machine-readable index of the Mambu Payments documentation, formatted for LLMs.

https://docs.numeral.io/llms.txt

It lists every guide as a direct link to its .md source. Use it to give an LLM a complete map of the documentation – for example, when building a custom agent, grounding a prompt, or setting up a retrieval pipeline outside of the MCP server.

If you are already using the MCP server (section 3), you do not need llms.txt separately. The MCP server already indexes the documentation.

You can also access the .md version of any page by appending .md to its URL.

5. Release notes

Release notes are available at https://docs.numeral.io/changelog. Subscribe via the RSS feed.