Summary
Connects Claude to Alternative Payments' API for reading and managing customers, invoices, payment requests, transactions, payouts, and webhooks. Deliberately limited to safe operations: you can create customers, generate invoices, and build hosted payment links, but not charge cards directly. Three destructive actions (archiving customers or invoices, deleting webhooks) require confirmation. Uses OAuth 2.0 client credentials from your Partner Dashboard. Reach for this when you want Claude to query payment data, generate invoices on the fly, or set up payment infrastructure without risking accidental charges. Ships with stdio and HTTP transports, the latter designed for stateless gateway deployments.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Alternative Payments MCP Server
A Model Context Protocol (MCP) server that gives AI assistants read + safe-write access to Alternative Payments — customers, invoices, payment requests, transactions, payouts, and webhooks.
Maintained by Wyre Technology.
Capabilities
This server deliberately does not move money. It exposes reads and safe writes
(creating customers, invoices, and hosted payment links). It does not implement
direct payment creation (POST /payments), which would charge a card or bank account.
The three destructive tools — ap_archive_customer, ap_archive_invoice,
ap_delete_webhook — require interactive confirmation before they run.
| Domain | Tools |
|---|---|
| customers | ap_list_customers, ap_get_customer, ap_list_customer_users, ap_create_customer, ap_add_customer_user, ap_archive_customer ⚠ |
| invoicing | ap_list_invoices, ap_get_invoice, ap_get_invoice_payment_link, ap_get_invoice_pdf_link, ap_create_invoice, ap_create_payment_request, ap_get_payment_request, ap_archive_invoice ⚠ |
| payments | ap_list_transactions, ap_get_transaction, ap_list_payouts, ap_get_payout, ap_list_payout_transactions |
| webhooks | ap_list_webhooks, ap_list_webhook_events, ap_create_webhook, ap_retry_webhooks, ap_delete_webhook ⚠ |
Plus discovery tools ap_navigate and ap_status.
Authentication
Alternative Payments uses OAuth 2.0 client-credentials. Generate an API key
(client_id / client_secret) in the Partner Dashboard. Set:
ALTERNATIVE_PAYMENTS_CLIENT_IDALTERNATIVE_PAYMENTS_CLIENT_SECRETALTERNATIVE_PAYMENTS_ENVIRONMENT(productionordemo, defaultproduction)
The server exchanges these for a bearer token automatically and refreshes it before expiry.
Quick start
Claude Code (CLI):
claude mcp add alternative-payments \
-e ALTERNATIVE_PAYMENTS_CLIENT_ID=your-client-id \
-e ALTERNATIVE_PAYMENTS_CLIENT_SECRET=your-client-secret \
-- npx -y github:WYRE-AI/alternative-payments-mcp
Docker (HTTP transport, gateway mode):
docker run --rm -p 8080:8080 \
-e AUTH_MODE=env \
-e MCP_TRANSPORT=http \
-e ALTERNATIVE_PAYMENTS_CLIENT_ID=... \
-e ALTERNATIVE_PAYMENTS_CLIENT_SECRET=... \
ghcr.io/wyre-ai/alternative-payments-mcp:latest
Transports
- stdio (default):
node dist/index.js - HTTP (
MCP_TRANSPORT=http): streamable HTTP onMCP_HTTP_PORT(default 8080), with/mcpand/healthendpoints. Each request gets a fresh stateless server, which is required for the WYRE MCP Gateway.
Development
npm install
npm run build
npm test
npm run lint
License
Apache-2.0
Featured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Configuration
ALTERNATIVE_PAYMENTS_CLIENT_ID*secretOAuth client id (API key) from the Alternative Payments Partner Dashboard.
ALTERNATIVE_PAYMENTS_CLIENT_SECRET*secretOAuth client secret paired with the client id.
ALTERNATIVE_PAYMENTS_ENVIRONMENTdefault: productionTarget environment: 'production' or 'demo'.
MCP_TRANSPORTdefault: stdioTransport mode. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting.
AUTH_MODEdefault: envCredential source: 'env' reads vars locally, 'gateway' expects header injection from the WYRE MCP Gateway.
LOG_LEVELdefault: infoLog verbosity: debug, info, warn, error
Categories
Registryactive
Packageghcr.io/wyre-technology/alternative-payments-mcp:v1.0.1
TransportSTDIO
AuthRequired
UpdatedJun 5, 2026
