ifthenpay 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.