SIBS Payment MCP
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.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SIBS Payment MCPCreate 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
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.
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]
endTools (8 total)
Tool | Description |
| Create a new checkout. Returns |
| Get payment state, amount, method, and timestamps by transaction ID |
| Capture an authorised payment — full or partial |
| Refund a captured payment — full or partial |
| Cancel an authorised payment before capture |
| Generate a Multibanco entity/reference for ATM payment |
| Send MB WAY push to customer phone ( |
| Validate credentials and connectivity |
Stack
Component | Tool |
Protocol | |
Language | TypeScript 5 + Node.js |
Schema validation | |
Payment gateway | SIBS API (Portugal) |
Build |
|
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 build2. 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_id3. 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 / MastercardMBWAY— MB WAY mobile paymentREFERENCE— Multibanco ATM referenceCOFIDIS— InstalmentsPAYPAL— PayPal
License
MIT — free to use, adapt, and build on.
Built by Robson Advincula — AI & Automation Consultant
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Flicense-quality-maintenanceEnables 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.Last updated2
- Alicense-qualityDmaintenanceEnables AI agents to access Magpie Payment Platform APIs for processing payments, creating checkout sessions, sending invoices, and managing payment links through natural conversation.Last updated391MIT
- Alicense-qualityBmaintenanceLets AI agents accept US payments (cards, Apple Pay, Google Pay) via Stripe hosted checkout. Includes tools to create payment links and query payment status.Last updatedMIT
- Alicense-qualityBmaintenanceEnables AI agents to accept payments in Poland via Stripe, providing tools to create hosted-checkout links and query payment status.Last updatedMIT
Related MCP Connectors
Portugal payments for AI agents — Multibanco via Stripe. Never holds funds.
Let AI agents add Yolfi crypto checkout, paylinks, webhooks, and status checks.
Brazil payments for AI agents — Pix, cards, boleto via Mercado Pago. Never holds funds.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/RobsonAdvincula/sibs-payment-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server