How do I use PCP MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@PCP MCP Server List all commerce cases created in the last 7 days" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

PCP MCP Server

Official

by PAYONE-GmbH

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

PCP MCP Server

MCP (Model Context Protocol) server for the PAYONE Commerce Platform (PCP). Provides an AI-accessible interface that abstracts the PCP Node.js SDK, enabling LLMs and AI agents to interact with the PAYONE Commerce Platform.

Architecture

AI Agent / n8n / LLM Client
        │
        ▼ (MCP over Streamable HTTP)
┌─────────────────────────┐
│   PCP MCP Server        │
│   (Express + MCP SDK)   │
│                         │
│   ┌───────────────────┐ │
│   │  Authentication   │ │
│   │  (API Key / KC)   │ │
│   └───────────────────┘ │
│   ┌───────────────────┐ │
│   │   MCP Tools       │ │
│   │  ┌─────────────┐  │ │
│   │  │CommerceCases│  │ │
│   │  │ Checkouts   │  │ │
│   │  │ Payments    │  │ │
│   │  │ OrderMgmt   │  │ │
│   │  │ PaymentInfo │  │ │
│   │  └─────────────┘  │ │
│   └───────────────────┘ │
│   ┌───────────────────┐ │
│   │  PCP Node.js SDK  │ │
│   └───────────────────┘ │
└─────────────────────────┘
        │
        ▼ (HTTPS)
  PAYONE Commerce Platform API

Related MCP server: Paytm MCP Server

Available Tools

Commerce Cases

Tool	Description
`list_commerce_cases`	List commerce cases with optional query filters
`get_commerce_case`	Get a single commerce case by ID
`create_commerce_case`	Create a new commerce case
`update_commerce_case`	Patch an existing commerce case

Checkouts

Tool	Description
`list_checkouts`	List checkouts with optional query filters
`get_checkout`	Get a checkout by commerce case and checkout ID
`create_checkout`	Create a new checkout within a commerce case
`update_checkout`	Patch an existing checkout
`remove_checkout`	Delete a checkout
`complete_checkout`	Finalize a checkout / complete an order

Payments

Tool	Description
`create_payment`	Create a payment execution for a checkout
`capture_payment`	Capture a previously authorized payment
`cancel_payment`	Cancel a payment execution
`refund_payment`	Refund a payment execution
`complete_payment`	Complete a payment requiring additional steps
`pause_payment`	Pause a payment execution
`refresh_payment`	Refresh a payment execution status
`create_fund_split`	Create a fund split for a payment event

Order Management

Tool	Description
`create_order`	Create an order for a checkout
`deliver_order`	Mark an order as delivered
`return_order`	Process a return for an order
`cancel_order`	Cancel an order

Payment Information

Tool	Description
`create_payment_information`	Create payment information for a checkout
`get_payment_information`	Get payment information by ID
`refund_payment_information`	Refund via payment information

Prerequisites

Node.js 24+
Docker & Docker Compose
Traefik (as edge router in the target environment)
PAYONE Commerce Platform API credentials

Configuration

Copy the example environment file and fill in the required values:

cp .env.example .env

Required Variables

Variable	Description
`PCP_API_KEY`	PCP API key
`PCP_API_SECRET`	PCP API secret
`PCP_MERCHANT_ID`	PCP merchant ID
`INTERNAL_API_KEY`	Static API key for authentication

Optional Variables

Variable	Default	Description
`CONTAINER_NAME_PREFIX`	`pcp-mcp`	Docker container name prefix
`MCP_PORT`	`3100`	Container-internal server port
`PCP_API_HOST`	`https://commerce-api.payone.com/v1`	PCP API base URL override
`TRAEFIK_ROUTER_SERVICE`	`pcp-mcp`	Traefik router name
`TRAEFIK_HOST_RULE_SERVICE`	`mcp.patsy-dev.payone-office.de`	Traefik host rule
`KEYCLOAK_URL`	`https://authorize.patsy-dev.payone-office.de`	Keycloak base URL
`KEYCLOAK_REALM`	`patsy`	Keycloak realm
`KEYCLOAK_CLIENT_ID`	`pcp-mcp`	Keycloak client ID
`KEYCLOAK_CLIENT_SECRET`	(empty)	Keycloak client secret (leave empty for API key only mode)

Authentication

The server supports two authentication methods:

API Key

Set INTERNAL_API_KEY in .env and pass it as a Bearer token:

Authorization: Bearer <your-api-key>

Keycloak (Optional)

Set KEYCLOAK_CLIENT_SECRET in .env to enable Keycloak JWT validation. When left empty, the server starts in API key only mode.

Development

npm install
npm run dev

Build

npm run build
npm start

Type Check

npx tsc --noEmit

Deployment

Docker Compose

cp .env.example .env
cp docker-compose.override.yml.example docker-compose.override.yml
# Edit .env with your credentials
bash service.sh build
bash service.sh run

Service Commands

Command	Description
`bash service.sh build`	Build the container image
`bash service.sh rebuild`	Build without cache
`bash service.sh run`	Start the container
`bash service.sh update`	Pull latest changes, rebuild, and restart
`bash service.sh restart`	Restart the container
`bash service.sh stop`	Stop and remove the container

Verify Deployment

curl -s https://mcp.patsy-dev.payone-office.de/health

Expected response:

{"status":"ok","service":"pcp-mcp"}

Usage

MCP Initialize

curl -s -X POST https://mcp.patsy-dev.payone-office.de/mcp \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": { "name": "test", "version": "1.0.0" }
    }
  }'

Tool Call Example

curl -s -X POST https://mcp.patsy-dev.payone-office.de/mcp \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "list_commerce_cases",
      "arguments": {}
    }
  }'

Project Structure

pcp-mcp/
├── docker-compose.yml
├── docker-compose.override.yml.example
├── image/
│   └── Dockerfile
├── service.sh
├── package.json
├── tsconfig.json
└── src/
    ├── index.ts                          # Express server, auth, entry point
    ├── server.ts                         # MCP server factory
    ├── auth/
    │   ├── keycloak.ts                   # Keycloak JWT verification
    │   └── token-manager.ts              # Keycloak token lifecycle
    ├── pcp/
    │   └── client.ts                     # PCP SDK configuration wrapper
    └── tools/
        ├── commerce-cases.ts             # Commerce Case API tools
        ├── checkouts.ts                  # Checkout API tools
        ├── payments.ts                   # Payment Execution API tools
        ├── order-management.ts           # Order Management API tools
        └── payment-information.ts        # Payment Information API tools

Dependencies

Package	Purpose
`@modelcontextprotocol/sdk`	MCP server implementation
`pcp-server-nodejs-sdk`	PAYONE Commerce Platform SDK
`express`	HTTP server
`jsonwebtoken` / `jwks-rsa`	Keycloak JWT validation
`zod`	Input schema validation

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

CraloOAuth
ai.cralo
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
Agent Orchestration Developer Tools
1
Airbyte AgentsOAuth
io.github.airbytehq
Let AI agents query data and act across all your business apps via MCP.
Data Platforms AI & Machine Learning RAG Systems
2
Unified.to MCP Server C
to.unified.docs
Unified MCP Server is a remote MCP connector for AI agents and vertical AI products that provides access to 22,000+ authorized SaaS tools across 400+ integrations and 24 categories directly inside LLMs (Claude, GPT, Gemini, Cohere). Tools operate only on explicitly authorized customer connections, enabling agents to safely read and write against live third-party systems.
App Automation Agent Orchestration Developer Tools
252
FinCore Agentic Commerce A
io.github.athenalion
Agentic commerce with 58 MCP tools for product search, checkout, A2A negotiation, C-Suite analytics.
E-commerce & Retail Autonomous Agents
2

Related MCP Servers

commercetools MCP Essentialsofficial
E-commerce & Retail Databases Developer Tools
commercetools
A
license
Not graded
quality
C
maintenance
An MCP server that enables AI agents to interact with the commercetools Composable Commerce platform. It provides tools for managing products, categories, orders, carts, and customer data through secure read and write operations.
Updated a month ago (2026-08-17 15:19 UTC)
13
MIT
Paytm MCP Server
Payments & Billing Finance E-commerce & Retail
santosh-chourasiya
A
license
A
quality
D
maintenance
Enables AI agents and developers to securely access Paytm's Payments and Business Payments APIs via MCP, allowing contextual automation of payment workflows like refunds, settlement tracking, and transaction status checks.
Updated a year ago (2025-05-22 09:50 UTC)
3
MIT
E-Commerce MCP Server
E-commerce & Retail Payments & Billing
bhavik-dreamz
F
license
Not graded
quality
D
maintenance
Enables AI assistants to manage products, shopping carts, and orders in an online store through a well-defined MCP API.
Updated 7 months ago (2026-02-15 13:13 UTC)
-
Payme MCP Server
sirliboyev-uz
A
license
A
quality
D
maintenance
MCP server for Payme — the leading payment system in Uzbekistan. Enables AI agents to process payments, manage cards, and generate checkout links through the Model Context Protocol.
Updated 6 months ago (2026-03-06 07:27 UTC)
10
7 npm
MIT

PCP MCP Server

Architecture

Available Tools

Commerce Cases

Checkouts

Payments

Order Management

Payment Information

Prerequisites

Configuration

Required Variables

Optional Variables

Authentication

API Key

Keycloak (Optional)

Development

Build

Type Check

Deployment

Docker Compose

Service Commands

Verify Deployment

Usage

MCP Initialize

Tool Call Example

Project Structure

Dependencies

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

commercetools MCP Essentialsofficial

Paytm MCP Server

E-Commerce MCP Server

Payme MCP Server