MONEI

Máy chủ MCP của nền tảng thanh toán châu Âu. Tạo liên kết thanh toán, tra cứu giao dịch, xem phân tích doanh thu và quản lý đăng ký thông qua trợ lý AI. Tổ chức thanh toán châu Âu đầu tiên hỗ trợ MCP gốc. Banco de España #6911. OAuth 2.0 + PKCE. Hoạt động tại mcp.monei.com.

Tài liệu

MONEI MCP Server

CI Schema Check Live License: MIT Node.js MCP

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:

MONEIStripeSquare
European payment railsBizum, Servired, SEPA, Cofidis, MB WAYLimited EU methodsUS-focused
RegulationBanco de España PI (#6911)EMI (Ireland)EMI (Luxembourg)
APIGraphQL native (AppSync)RESTREST
Open source✅ MITPartial❌
Safety guardrailsHard-blocked restricted opsConfigurableConfigurable
Analytics built-inchargesDateRangeKPI toolSeparate APISeparate 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:

  1. Go to Settings → Connectors → Add
  2. Enter: https://mcp.monei.com/mcp
  3. 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:

EndpointPurpose
/mcpStreamable HTTP transport (recommended)
/sseLegacy SSE transport
/healthHealth check + GraphQL connectivity
/oauth/authorizeMerchant OAuth 2.0 flow

Available Tools

ToolTypeWhat it doesExample prompt
generate_payment_linkWriteCreate a shareable payment URL"Generate a €50 link for order #42"
send_payment_linkWriteSend link via email or SMS"Send that link to alex@example.com"
get_paymentReadLook up a payment by ID"What's the status of payment ch_abc123?"
list_paymentsReadSearch and filter transactions"Show me all failed payments this week"
get_payments_kpiReadRevenue analytics for a date range"What's my revenue for March?"
get_subscriptionReadView subscription details"Get details of subscription sub_xyz"
list_subscriptionsReadBrowse subscriptions"List all active subscriptions"
get_account_infoReadAccount 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 OperationWhy
Refund paymentsFinancial risk — requires manual review
Capture/cancel paymentsRequires authorization context
Charge cards/Bizum directlyRequires PCI context + cardholder consent
Card/Bizum payoutsFunds disbursement needs compliance controls
Cancel subscriptionsDestructive — affects recurring revenue
Modify account settingsSecurity-sensitive configuration
Create/delete API keysCredential management
Delete webhooksCan 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

WorkflowTriggerWhat it does
CIEvery PR + push to mainTypeScript check → tests → build (Node 18/20/22)
Schema CheckWeekly (Mon 09:00 UTC)Introspects MONEI GraphQL API, opens issue on new operations
DependabotWeeklynpm + 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

ResourceLink
MONEI GraphQL APIdocs.monei.com/apis/graphql
MONEI REST APIdocs.monei.com/apis/rest
Postman Collectionpostman.monei.com
MCP Specificationmodelcontextprotocol.io
Security PolicySECURITY.md
ContributingCONTRIBUTING.md
ChangelogCHANGELOG.md

License

MIT © MONEI


MONEI Digital Payments, S.L. — Banco de España license #6911 — monei.com