About ifthenpay Payments MCP
ifthenpay Payments MCP is an official remote server for interacting with ifthenpay payment services. It serves MCP-compatible applications with tools for creating payment requests and references, checking payment status, and retrieving completed payments.
Key features
- 01Create Multibanco references
- 02Request and check MB WAY payments
- 03Create Payshop references
- 04Create card and other payment links
- 05List completed payments
Use cases
- 01Create payment references for customers
- 02Send and check MB WAY requests
- 03Retrieve completed payment records
MCP support
The remote Streamable HTTP MCP server exposes ifthenpay payment tools to compatible clients, including payment creation, status checks and reporting.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://ai.ifthenpay.com/mcp/payments/claude mcp add --transport http com-ifthenpay-payments https://ai.ifthenpay.com/mcp/payments/{"mcpServers":{"com-ifthenpay-payments":{"type":"http","url":"https://ai.ifthenpay.com/mcp/payments/"}}}Open in Cursor{"servers":{"com-ifthenpay-payments":{"type":"http","url":"https://ai.ifthenpay.com/mcp/payments/"}}}Open in VS Code{"mcpServers":{"com-ifthenpay-payments":{"type":"http","url":"https://ai.ifthenpay.com/mcp/payments/"}}}{"mcpServers":{"com-ifthenpay-payments":{"serverUrl":"https://ai.ifthenpay.com/mcp/payments/"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
8| Parameter | Type | Required | Description |
|---|---|---|---|
| amount | number | Yes | Payment amount in EUR (e.g. 10.50). |
| mb_key | string | Yes | ifthenpay Multibanco key. |
| order_id | string | Yes | Unique order identifier in your system. |
| expiry_days | integer | No | Number of days until the reference expires. Defaults to no expiry if omitted. |
Details
From the project READMEifthenpay MCP Server
Official Model Context Protocol (MCP) server for ifthenpay payment services.
The ifthenpay MCP Server enables AI assistants and MCP-compatible applications to securely interact with ifthenpay payment services, including Multibanco, MB WAY, Payshop, Credit Card, PinPay, Cofidis Pay, PIX, and payment reporting.
Registry
Registry ID
com.ifthenpay/payments
Remote Endpoint
https://ai.ifthenpay.com/mcp/payments/
Protocol
- Model Context Protocol (MCP)
- JSON-RPC 2.0
- Streamable HTTP
Supported Clients
The server is compatible with any MCP client, including:
- Claude Desktop
- GitHub Copilot
- Visual Studio Code
- Cursor
- Windsurf
- Continue.dev
- Any other MCP-compatible client
Available Tools
| Tool | Description |
|---|---|
multibanco_create_reference | Create a Multibanco payment reference |
mbway_request_payment | Send an MB WAY payment request |
mbway_check_status | Check the status of an MB WAY payment |
payshop_create_reference | Create a Payshop payment reference |
creditcard_create_payment | Create a hosted Credit/Debit Card checkout |
pinpay_create_payment | Create a Pay-by-Link supporting Card, Multibanco, MB WAY, Payshop, Google Pay, Apple Pay, Cofidis Pay and PIX |
cofidis_create_payment | Create a Cofidis Pay payment |
pix_create_payment | Create a PIX payment |
payments_list | Retrieve completed payments from the ifthenpay Backoffice |
Rate Limits
To ensure platform stability, the server applies rate limiting.
- 60 requests per IP per minute
- Exceeded requests return HTTP 429 Too Many Requests
- Batch JSON-RPC requests are not supported
Client Configuration
Claude Desktop
{
"mcpServers": {
"ifthenpay": {
"url": "https://ai.ifthenpay.com/mcp/payments/"
}
}
}
GitHub Copilot / Visual Studio Code
{
"servers": {
"ifthenpay": {
"type": "http",
"url": "https://ai.ifthenpay.com/mcp/payments/"
}
}
}
Cursor
{
"mcpServers": {
"ifthenpay": {
"url": "https://ai.ifthenpay.com/mcp/payments/"
}
}
}
Windsurf
{
"mcpServers": {
"ifthenpay": {
"serverUrl": "https://ai.ifthenpay.com/mcp/payments/"
}
}
}
Continue.dev
{
"mcpServers": [
{
"name": "ifthenpay",
"transport": {
"type": "streamable-http",
"url": "https://ai.ifthenpay.com/mcp/payments/"
}
}
]
}
Example MCP Request
Initialize the connection:
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-03-26",
"clientInfo": {
"name": "my-client",
"version": "1.0"
}
}
}
List available tools:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list"
}
Call a tool:
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "multibanco_create_reference",
"arguments": {
"mb_key": "...",
"order_id": "1001",
"amount": 25.00
}
}
}
Documentation
Complete documentation, examples and API reference are available at:
Documentation
https://ai.ifthenpay.com/mcp/docs/
Interactive Test Client
https://ai.ifthenpay.com/mcp/client/
ifthenpay
License
Copyright © ifthenpay.
All rights reserved.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.