MONEI

欧洲支付平台MCP服务器。通过AI助手生成支付链接、查询交易、查看收入分析和管理订阅。首家原生支持MCP的欧洲支付机构。西班牙央行#6911。OAuth 2.0 + PKCE。上线于mcp.monei.com。

文档

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