Open Payment Platform MCP Server

Connect your AI-powered application to the Open Payment Platform using the Model Context Protocol.

Once connected, any MCP-compatible LLM client can discover and invoke Open Payment Platform payment tools, such as capturing payments, processing refunds, and querying transactions, through natural language or programmatic agent workflows.

Prerequisites

Before you begin, make sure you have:

• An active Open Payment Platform merchant account with API credentials
• An MCP-compatible LLM client (see Supported clients)
• Basic familiarity with JSON configuration files

Your credentials

When you sign up for Open Payment Platform API access, you receive two credentials passed as HTTP headers on every request.

Server endpoint

The Open Payment Platform MCP Server uses the Streamable HTTP transport, the current MCP standard for remote servers, broadly supported across all major LLM clients.

Configuration

MCP clients are configured via a JSON file that specifies the server endpoint, transport type, and required headers. Below is the minimal configuration to connect to the Open Payment Platform MCP test server.

{
  "servers": {
    "OPP-payments": {
      "type": "http",
      "url": "https://eu-test.oppwa.com/agentic/v1/mcp",
      "headers": {
        "X-Entity-Id": "YOUR_ENTITY_ID",
        "X-Token":     "YOUR_ACCESS_TOKEN"
      }
    }
  }
}

Replace YOUR_ENTITY_ID and YOUR_ACCESS_TOKEN with the credentials from your Open Payment Platform merchant UI.

Supported clients

The Open Payment Platform MCP Server is compatible with any LLM client that supports the Streamable HTTP (or SSE) transport, including:

Client examples

Claude Desktop

1. Open Settings → Connectors → Add Custom Connector
2. Enter the server URL: https://eu-test.oppwa.com/agentic/v1/mcp
3. Add headers X-Entity-Id and X-Token with your credentials
4. Save and enable the connector in your chat session

OpenAI Agents SDK (Python)

from agents import Agent
from agents.mcp import MCPServerStreamableHttp

OPP_server = MCPServerStreamableHttp(
    url="https://eu-test.oppwa.com/agentic/v1/mcp",
    headers={
        "X-Entity-Id": "YOUR_ENTITY_ID",
        "X-Token":     "YOUR_ACCESS_TOKEN"
    }
)

agent = Agent(
    name="PaymentAgent",
    mcp_servers=[OPP_server]
)

AnythingLLM

Add the following entry to your anythingllm_mcp_servers.json file:

{
  "mcpServers": {
    "OPP-payments": {
      "type": "streamable",
      "url": "https://eu-test.oppwa.com/agentic/v1/mcp",
      "headers": {
        "X-Entity-Id": "YOUR_ENTITY_ID",
        "X-Token":     "YOUR_ACCESS_TOKEN"
      }
    }
  }
}

Testing the connection

Once configured, ask your LLM client to list available tools, most clients will discover them automatically. You can also prompt:

A successful connection returns the full list of Open Payment Platform tools.

Tools summary

The Open Payment Platform MCP Server exposes 8 tools across two categories.

Use cases

Below are two example use cases showing how an LLM agent can combine Open Payment Platform MCP tools with natural language to automate payment workflows.

Security best practices

Next steps

• Review the MCP Specification for advanced client configuration options