Back to the catalog

ifthenpay Payments MCP

Remote MCP for ifthenpay payments: Multibanco, MB WAY and Payshop.

Open source Repository Open in the app JSON README (API)

About

Remote MCP for ifthenpay payments: Multibanco, MB WAY and Payshop.

Details

Kind
MCP servers
Topic
Finance & crypto
Publisher
com.ifthenpay
Origin
official
Category
ferramentas
Transport
http
Version
1.0.2
Last push
2026-06-25T16:17:49Z
Repository state
ativo
License
NOASSERTION
Added
2026-08-29 03:01:09
Updated
2026-08-29 03:01:09
Origin id
com.ifthenpay/payments

README

# 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**

```text
com.ifthenpay/payments
```

**Remote Endpoint**

```text
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

```json
{
  "mcpServers": {
    "ifthenpay": {
      "url": "https://ai.ifthenpay.com/mcp/payments/"
    }
  }
}
```

## GitHub Copilot / Visual Studio Code

```json
{
  "servers": {
    "ifthenpay": {
      "type": "http",
      "url": "https://ai.ifthenpay.com/mcp/payments/"
    }
  }
}
```

## Cursor

```json
{
  "mcpServers": {
    "ifthenpay": {
      "url": "https://ai.ifthenpay.com/mcp/payments/"
    }
  }
}
```

## Windsurf

```json
{
  "mcpServers": {
    "ifthenpay": {
      "serverUrl": "https://ai.ifthenpay.com/mcp/payments/"
    }
  }
}
```

## Continue.dev

```json
{
  "mcpServers": [
    {
      "name": "ifthenpay",
      "transport": {
        "type": "streamable-http",
        "url": "https://ai.ifthenpay.com/mcp/payments/"
      }
    }
  ]
}
```

---

# Example MCP Request

Initialize the connection:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-03-26",
    "clientInfo": {
      "name": "my-client",
      "version": "1.0"
    }
  }
}
```

List available tools:

```json
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list"
}
```

Call a tool:

```json
{
  "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

---

# License

Copyright © ifthenpay.

All rights reserved.

More