# 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

https://www.ifthenpay.com

ifthenpay payments