Portugal Payments MCP — let AI agents accept payments in Portugal

Use it in 60 seconds

Paste this into your MCP client config (Claude Desktop, Cursor, Windsurf, or any MCP-capable agent):

{
  "mcpServers": {
    "portugal-payments": {
      "type": "http",
      "url": "https://mcp-pt.wishpool.app/mcp"
    }
  }
}

Nothing to install. Credentials, when you need them, travel as HTTP headers on each request and are never stored — see the threat model.

Or run it yourself

Would you rather not send production credentials to a server you do not control? Deploy this identical code to your own account and point your agent at your own URL:

Deploy with Vercel

git clone https://github.com/junter1989k-ai/portugal-payments-mcp && cd portugal-payments-mcp && npx vercel --prod

MIT-licensed. Self-hosting removes us from the picture entirely, at no cost and with no loss of function.

Live · MCP endpoint: https://mcp-pt.wishpool.app/mcp · Listed on the official MCP Registry as app.wishpool/portugal-payments-mcp · Part of a 50-country family — hub: mcp.wishpool.app

A remote MCP server that lets any AI agent (Claude, ChatGPT, Cursor…) accept payments in Portugal: Multibanco (the rail Portuguese buyers actually use), cards, Apple Pay — via Stripe's hosted checkout.

⚖️ Stateless translation layer: funds always flow buyer → Stripe → merchant directly. Never holds funds or stores credentials — no database at all.

Quick start

MCP endpoint: https://mcp-pt.wishpool.app/mcp (Streamable HTTP, stateless JSON-RPC)

Header	Value
`x-stripe-secret-key`	your Stripe secret key (sk_test_ = test mode from dashboard.stripe.com, sk_live_ = production)

Tools

Tool	What it does
`create_payment_link`	Create a EUR hosted-checkout link.
`query_payment_status`	Pull-based status check; `paid=true` when PAID. Returns `invoice_url` + `invoice_pdf` once paid for invoiced payments.
`issue_invoice` / `collect_tax_id` (options on create)	VAT-ready invoicing: auto-create a Stripe invoice (PDF, emailed to the buyer) and collect the buyer's EU VAT / business tax ID at checkout.
`refund_payment`	Full or partial refund of a paid payment; respects the same owner policy guardrails.
`create_subscription_link` / `query_subscription` / `cancel_subscription`	Recurring billing: the buyer authorizes once and is charged every period until canceled.

Develop

node test/serve.js      # local server (http://localhost:3243/mcp)
node test/e2e.js        # protocol + validation suite (probes real Stripe auth errors)

Zero runtime dependencies; Node ≥ 18. MIT license.

app.wishpool/portugal-payments-mcp