Which integrations are available for this server?

Allows processing Mastercard payments through the SIBS payment gateway, including creating checkouts, capturing payments, and issuing refunds. Allows processing payments via PayPal through the SIBS payment gateway, including creating checkouts, capturing payments, and issuing refunds. Allows processing Visa card payments through the SIBS payment gateway, including creating checkouts, capturing payments, and issuing refunds.

How do I use SIBS Payment MCP?

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., "@SIBS Payment MCP Create a €29.99 checkout with card payment" 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.

SIBS Payment MCP

by RobsonAdvincula

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

SIBS Payment MCP

A Model Context Protocol (MCP) server that exposes the SIBS payment gateway as tools for AI agents — enabling LLMs to create checkouts, verify payments, issue refunds, and generate Multibanco references natively in any MCP-compatible environment.

MCP TypeScript SIBS License

What It Does

Bridges the SIBS payment gateway to the MCP ecosystem. Any AI agent or LLM-powered tool running in an MCP-compatible host (Claude Desktop, n8n, custom agents) can:

Check payment status in real time
Create checkout sessions with configurable payment methods
Capture, refund, or cancel authorised payments
Generate Multibanco references for ATM/homebanking payment
Initiate MB WAY push notifications to a customer's phone

Related MCP server: Magpie MCP Server

Architecture

flowchart LR
    A[AI Agent\nClaude / n8n] -->|MCP tool call| B[sibs-payment-mcp\nMCP Server]
    B -->|REST API| C[SIBS Gateway\nAPI]
    C -->|response| B
    B -->|structured result| A

    subgraph Tools
        T1[sibs_create_checkout]
        T2[sibs_payment_status]
        T3[sibs_capture_payment]
        T4[sibs_refund_payment]
        T5[sibs_cancel_payment]
        T6[sibs_generate_mb_reference]
        T7[sibs_mbway_payment]
        T8[sibs_test]
    end

Tools (8 total)

Tool	Description
`sibs_create_checkout`	Create a new checkout. Returns `transactionID` and hosted checkout URL
`sibs_payment_status`	Get payment state, amount, method, and timestamps by transaction ID
`sibs_capture_payment`	Capture an authorised payment — full or partial
`sibs_refund_payment`	Refund a captured payment — full or partial
`sibs_cancel_payment`	Cancel an authorised payment before capture
`sibs_generate_mb_reference`	Generate a Multibanco entity/reference for ATM payment
`sibs_mbway_payment`	Send MB WAY push to customer phone (`351#912345678` format)
`sibs_test`	Validate credentials and connectivity

Stack

Component	Tool
Protocol	Model Context Protocol SDK
Language	TypeScript 5 + Node.js
Schema validation	Zod
Payment gateway	SIBS API (Portugal)
Build	`tsc` → `dist/`

Setup

Prerequisites

Node.js 18+
SIBS merchant account with API credentials
MCP-compatible host (Claude Desktop, n8n, custom agent)

1. Install

git clone https://github.com/RobsonAdvincula/sibs-payment-mcp.git
cd sibs-payment-mcp
npm install
npm run build

2. Configure environment

SIBS_BASE_URL=https://stargate.sibs.pt/m001/v1
SIBS_BEARER_TOKEN=your_bearer_token
SIBS_CLIENT_ID=your_client_id
SIBS_TERMINAL_ID=your_terminal_id

3. Add to MCP host

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "sibs-payment": {
      "command": "node",
      "args": ["/path/to/sibs-payment-mcp/dist/index.js"],
      "env": {
        "SIBS_BEARER_TOKEN": "...",
        "SIBS_CLIENT_ID": "...",
        "SIBS_TERMINAL_ID": "..."
      }
    }
  }
}

n8n MCP Client node: point to the compiled dist/index.js with the same env vars.

Example Interactions

Create a payment and send MB WAY:

Agent: "Create a €29.99 checkout for customer +351912345678"

→ sibs_create_checkout({ amount: 2999, currency: "EUR", paymentMethods: ["MBWAY"] })
→ sibs_mbway_payment({ transactionId: "txn_xxx", amount: 2999, customerPhone: "351#912345678" })

Result: "MB WAY notification sent. Customer has 4 minutes to confirm."

Verify and refund:

Agent: "Check transaction txn_abc and refund if paid"

→ sibs_payment_status({ transactionId: "txn_abc" })
  ← { status: "Success", amount: 4999 }
→ sibs_refund_payment({ transactionId: "txn_abc" })
  ← { refunded: true }

Payment Methods Supported

CARD — Visa / Mastercard
MBWAY — MB WAY mobile payment
REFERENCE — Multibanco ATM reference
COFIDIS — Instalments
PAYPAL — PayPal

License

MIT — free to use, adapt, and build on.

Built by Robson Advincula — AI & Automation Consultant

Available Tools

8 tools

sibs_cancel_paymentA

Cancel a SIBS payment authorization. Only works for payments not yet captured.

Name	Required	Description	Default
`transactionId`	Yes	SIBS transaction ID to cancel

sibs_capture_paymentA

Capture a previously authorized SIBS payment. Omit amount for full capture, or specify partial amount in minor units.

Name	Required	Description	Default
`amount`	No	Amount to capture in minor units (omit for full capture)
`currency`	No	Currency code (default: EUR)	EUR
`transactionId`	Yes	SIBS transaction ID to capture

sibs_create_checkoutB

Create a new SIBS checkout/payment. Amount in minor units (1000 = 10.00 EUR). Returns transactionID and checkout URL.

Name	Required	Description	Default
`amount`	Yes	Payment amount in minor units (e.g., 1000 = 10.00 EUR)
`currency`	No	Currency code (default: EUR)	EUR
`customerEmail`	No	Customer email address
`customerPhone`	No	Customer phone number
`paymentMethods`	No	Allowed payment methods (e.g., ['CARD', 'MBWAY', 'REFERENCE']). Defaults to all.
`merchantTransactionId`	No	Your own transaction reference/ID for reconciliation

sibs_generate_mb_referenceA

Generate a Multibanco (MB) payment reference. Returns entity, reference number, and amount for ATM/homebanking payment.

Name	Required	Description	Default
`amount`	Yes	Amount in minor units (e.g., 1000 = 10.00 EUR)
`currency`	No	Currency code (default: EUR)	EUR
`expiryDate`	No	Reference expiry date in ISO 8601 (e.g., '2026-03-01T23:59:59Z')
`transactionId`	Yes	SIBS transaction ID for Multibanco reference generation

sibs_mbway_paymentA

Initiate MB WAY payment. Sends notification to customer's MB WAY app. Phone format: '351#912345678'.

Name	Required	Description	Default
`amount`	Yes	Amount in minor units (e.g., 1000 = 10.00 EUR)
`currency`	No	Currency code (default: EUR)	EUR
`customerPhone`	Yes	Customer phone with country code (e.g., '351#912345678')
`transactionId`	Yes	SIBS transaction ID for the MB WAY payment

sibs_payment_statusA

Get the status of a SIBS payment by transaction ID. Returns payment state, amount, method, and timestamps.

Name	Required	Description	Default
`transactionId`	Yes	SIBS transaction ID (returned when payment was created)

sibs_refund_paymentA

Refund a SIBS payment. Omit amount for full refund, or specify partial amount in minor units.

Name	Required	Description	Default
`amount`	No	Amount to refund in minor units (omit for full refund)
`currency`	No	Currency code (default: EUR)	EUR
`transactionId`	Yes	SIBS transaction ID to refund

sibs_testA

Test SIBS API authentication. Verifies Bearer token and credentials are valid.

Name	Required	Description	Default
No parameters

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

8 tool updatesv1.0.0Sep 6, 2026
- First observedsibs_cancel_payment
- First observedsibs_capture_payment
- First observedsibs_create_checkout
- First observedsibs_generate_mb_reference
- First observedsibs_mbway_payment
- First observedsibs_payment_status
- First observedsibs_refund_payment
- First observedsibs_test

Deploy Server

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

TDQS

A3.9/5.0

Scored 2026-09-06 14:40 across 8 tools

Disambiguation5/5

Each tool targets a distinct operation: authentication testing, initiating MB WAY, creating a checkout, generating Multibanco references, querying status, and lifecycle actions (capture, refund, cancel). There is no meaningful overlap or ambiguity between tool purposes.

Naming Consistency4/5

Most tools follow the sibs_verb_noun pattern (create_checkout, capture_payment, refund_payment, cancel_payment, generate_mb_reference). Minor deviations exist: sibs_mbway_payment and sibs_payment_status omit an explicit verb, and sibs_test uses a bare verb, but the shared sibs_ prefix keeps the family recognizable.

Tool Count5/5

Eight tools is well-scoped for a payment MCP server covering authentication, multiple payment methods, status lookup, and payment lifecycle operations. Each tool serves a necessary and distinct role without unnecessary bloat or duplication.

Completeness5/5

The tool surface covers the core payment workflow end-to-end: create payments via MB WAY, checkout, and Multibanco reference, check status, capture, refund, and cancel. Authentication testing is also included, making the set self-sufficient for typical SIBS integration scenarios.

Maintenance

ActivityStale

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Portugal Payments (Stripe — Multibanco)A
app.wishpool
Portugal payments for AI agents — Multibanco via Stripe. Never holds funds.
Payments & Billing Finance
2
https://mcp-pt.wishpool.app/mcp
mifactory-paymentsA
io.github.mifactory-bot
Stripe payments for AI agents. Create links, verify, manage customers.
Payments & Billing Finance App Automation
42
https://mifactory-payments.vercel.app/mcp
Yolfi Payments MCP
io.github.yolfinance
Let AI agents add Yolfi crypto checkout, paylinks, webhooks, and status checks.
Payments & Billing Cryptocurrency
2173
https://app.yolfi.com/mcp
Brazil Payments (Mercado Pago — Pix / cards / boleto)A
app.wishpool
Brazil payments for AI agents — Pix, cards, boleto via Mercado Pago. Never holds funds.
Payments & Billing Finance
2
https://mcp-br.wishpool.app/mcp

Related MCP Servers

Fin-MCP Payment Server
Finance App Automation E-commerce & Retail
Veri5ied
F
license
Not graded
quality
Not graded
maintenance
Enables AI agents to interact with multiple payment providers (Stripe, Paystack) through a unified API. Supports payment initialization, verification, refunds, customer management, and invoicing without requiring knowledge of specific provider implementations.
Updated a year ago (2025-09-10 07:56 UTC)
2
-
Magpie MCP Server
Finance Payments & Billing
domdanao
A
license
Not graded
quality
D
maintenance
Enables AI agents to access Magpie Payment Platform APIs for processing payments, creating checkout sessions, sending invoices, and managing payment links through natural conversation.
Updated 7 months ago (2026-04-12 02:53 UTC)
122 npm
2
MIT
app.wishpool/usa-payments-mcp
Payments & Billing E-commerce & Retail Finance
junter1989k-ai
A
license
Not graded
quality
B
maintenance
Lets AI agents accept US payments (cards, Apple Pay, Google Pay) via Stripe hosted checkout. Includes tools to create payment links and query payment status.
Updated 4 months ago (2026-07-11 05:49 UTC)
MIT
Poland Payments MCP
Payments & Billing Finance
junter1989k-ai
A
license
Not graded
quality
B
maintenance
Enables AI agents to accept payments in Poland via Stripe, providing tools to create hosted-checkout links and query payment status.
Updated 4 months ago (2026-07-11 05:48 UTC)
MIT

SIBS Payment MCP

What It Does

Architecture

Tools (8 total)

Stack

Setup

Prerequisites

1. Install

2. Configure environment

3. Add to MCP host

Example Interactions

Payment Methods Supported

License

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Fin-MCP Payment Server

Magpie MCP Server

app.wishpool/usa-payments-mcp

Poland Payments MCP