Payments Orchestration Platform MCP Server

Connect your AI-powered application to the Payments Orchestration Platform using the Model Context Protocol.

Once connected, any MCP-compatible LLM client can discover and invoke Payments Orchestration 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 Payments Orchestration 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 Payments Orchestration Platform API access, you receive two credentials passed as HTTP headers on every request.

Server endpoint

The Payments Orchestration 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 Payments Orchestration Platform MCP test server.

{
  "servers": {
    "OPP-payments": {
      "type": "http",
      "url": "https://eu-test.OPP.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 Payments Orchestration Platform merchant UI.

Supported clients

The Payments Orchestration 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.OPP.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.OPP.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.OPP.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 Payments Orchestration Platform tools.

Tools summary

The Payments Orchestration Platform MCP Server exposes 8 tools across two categories.

Use cases

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

Security best practices

Next steps

• Review the MCP Specification for advanced client configuration options
• Contact OPP Developer Support to enable Payments Orchestration Platform MCP Server