MONEI
European payment platform MCP server. Generate payment links, look up transactions, view revenue analytics, and manage subscriptions through AI assistants. First European Payment Institution with native MCP support. Banco de España #6911. OAuth 2.0 + PKCE. Live at mcp.monei.com.
Documentation
MONEI MCP Server
The first European payment platform with native AI agent support.
Connect your MONEI account to Claude, ChatGPT, or any MCP-compatible AI assistant. Generate payment links, check transactions, view analytics — all through natural language.
Regulated by Banco de España (#6911) · PCI DSS Level 1 · Bizum Direct Acquirer · GraphQL Native
MCP Server URL: https://mcp.monei.com/mcp
Quick Start · Available Tools · Security · API Docs
Demo
You: "Generate a €25 payment link for order #1234 — customer is alex@example.com"
Claude: ✅ Payment link created!
Amount: €25.00
Link: https://pay.monei.com/ch_abc123
Status: PENDING
Customer: alex@example.com
You: "What's my revenue this week?"
Claude: 📊 This week's KPIs (Apr 1–7):
Total: €12,450.00 (142 transactions)
Success rate: 96.5%
Average: €87.68
You: "Refund the last payment"
Claude: ⛔ Refunds are not available through AI assistants for security reasons.
Please use the MONEI Dashboard: https://dashboard.monei.com
Why MONEI?
If you're comparing MCP payment servers:
| MONEI | Stripe | Square | |
|---|---|---|---|
| European payment rails | Bizum, Servired, SEPA, Cofidis, MB WAY | Limited EU methods | US-focused |
| Regulation | Banco de España PI (#6911) | EMI (Ireland) | EMI (Luxembourg) |
| API | GraphQL native (AppSync) | REST | REST |
| Open source | ✅ MIT | Partial | ❌ |
| Safety guardrails | Hard-blocked restricted ops | Configurable | Configurable |
| Analytics built-in | chargesDateRangeKPI tool | Separate API | Separate API |
MONEI is purpose-built for European merchants — especially Spain, Portugal, and Andorra — with native support for local payment methods that global providers don't offer.
Quick Start
Connect to Claude (fastest)
Claude.ai — Add as a custom connector:
- Go to Settings → Connectors → Add
- Enter:
https://mcp.monei.com/mcp - Complete the OAuth flow
Claude Desktop — Add to claude_desktop_config.json:
{
"mcpServers": {
"monei": {
"url": "https://mcp.monei.com/mcp"
}
}
}
Claude Code:
claude mcp add monei --transport http https://mcp.monei.com/mcp
Self-host
git clone https://github.com/MONEI/MONEI-MCP-Server.git
cd MONEI-MCP-Server
npm install
cp .env.example .env # Add your MONEI API key
npm run dev
Or with Docker:
docker build -t monei-mcp .
docker run -p 3000:3000 -e MONEI_API_KEY=your_key monei-mcp
The server starts at http://localhost:3000 with:
| Endpoint | Purpose |
|---|---|
/mcp | Streamable HTTP transport (recommended) |
/sse | Legacy SSE transport |
/health | Health check + GraphQL connectivity |
/oauth/authorize | Merchant OAuth 2.0 flow |
Available Tools
| Tool | Type | What it does | Example prompt |
|---|---|---|---|
generate_payment_link | Write | Create a shareable payment URL | "Generate a €50 link for order #42" |
send_payment_link | Write | Send link via email or SMS | "Send that link to alex@example.com" |
get_payment | Read | Look up a payment by ID | "What's the status of payment ch_abc123?" |
list_payments | Read | Search and filter transactions | "Show me all failed payments this week" |
get_payments_kpi | Read | Revenue analytics for a date range | "What's my revenue for March?" |
get_subscription | Read | View subscription details | "Get details of subscription sub_xyz" |
list_subscriptions | Read | Browse subscriptions | "List all active subscriptions" |
get_account_info | Read | Account config and payment methods | "What payment methods do I have enabled?" |
Payment amounts are in cents (smallest currency unit). €10.50 = 1050.
Security by Design
This server enforces strict guardrails on what AI assistants can do. Restricted operations are hard-blocked at the server level — not just hidden from the tool list.
| Blocked Operation | Why |
|---|---|
| Refund payments | Financial risk — requires manual review |
| Capture/cancel payments | Requires authorization context |
| Charge cards/Bizum directly | Requires PCI context + cardholder consent |
| Card/Bizum payouts | Funds disbursement needs compliance controls |
| Cancel subscriptions | Destructive — affects recurring revenue |
| Modify account settings | Security-sensitive configuration |
| Create/delete API keys | Credential management |
| Delete webhooks | Can break integrations |
Even if a tool call is crafted manually, the server rejects it with a clear message and links to the MONEI Dashboard.
Authentication & Transport Security
- OAuth 2.0 + PKCE (RFC 7636) — Proof Key for Code Exchange prevents authorization code interception
- Single-use state tokens — CSRF protection with time-limited, one-use OAuth state parameters
- Scoped access — Tokens limited to
payments:read,payments:create,subscriptions:read,account:read - Rate limiting — Per-account sliding window (60 req/min)
- Audit logging — Every tool call logged with timestamps, account ID, and sanitized parameters
Architecture
src/
├── index.ts # Entry — Streamable HTTP + SSE + OAuth
├── server.ts # MCP server + tool registration
├── api/
│ └── monei-client.ts # MONEI GraphQL API client (graphql.monei.com)
├── tools/
│ ├── index.ts # Tool registry + routing + restriction enforcement
│ ├── payments.ts # Payment + KPI + send link tools
│ ├── subscriptions.ts # Subscription tools
│ └── account.ts # Account info tool
├── auth/
│ ├── oauth.ts # OAuth 2.0 + PKCE flow
│ ├── pkce.ts # RFC 7636 implementation
│ └── session.ts # Single-use state manager (CSRF)
├── middleware/
│ ├── security.ts # CORS, security headers, input guard
│ ├── rate-limiter.ts # Per-account sliding window
│ └── audit-logger.ts # Structured JSON audit log
└── types/
└── index.ts # Types + restricted operations registry
All operations go through MONEI's GraphQL API (https://graphql.monei.com) via AWS AppSync. The previous REST client was removed in v0.2.0.
CI/CD
| Workflow | Trigger | What it does |
|---|---|---|
| CI | Every PR + push to main | TypeScript check → tests → build (Node 18/20/22) |
| Schema Check | Weekly (Mon 09:00 UTC) | Introspects MONEI GraphQL API, opens issue on new operations |
| Dependabot | Weekly | npm + GitHub Actions dependency updates |
Branch protection requires CI to pass + 1 approval before merging to main.
Roadmap
- Anthropic Connectors Directory listing
- npm publishing (
npx @monei/mcp-server) - Webhook notifications for payment status changes
- Docker container + deploy templates
- Persistent token storage (Redis/PostgreSQL)
- Multi-language tool descriptions (ES, PT, FR)
- Bizum-specific tools (request-to-pay)
- Settlement and payout reporting tools
- Claude Desktop Extension (.mcpb bundle)
Documentation
| Resource | Link |
|---|---|
| MONEI GraphQL API | docs.monei.com/apis/graphql |
| MONEI REST API | docs.monei.com/apis/rest |
| Postman Collection | postman.monei.com |
| MCP Specification | modelcontextprotocol.io |
| Security Policy | SECURITY.md |
| Contributing | CONTRIBUTING.md |
| Changelog | CHANGELOG.md |
License
MIT © MONEI
MONEI Digital Payments, S.L. — Banco de España license #6911 — monei.com