{
  "markdown": "# Alternative Payments MCP Server\n\n[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that gives AI\nassistants **read + safe-write** access to [Alternative Payments](https://www.alternativepayments.io/) —\ncustomers, invoices, payment requests, transactions, payouts, and webhooks.\n\n> Maintained by [Wyre Technology](https://github.com/WYRE-AI).\n\n## Capabilities\n\nThis server deliberately **does not move money**. It exposes reads and safe writes\n(creating customers, invoices, and hosted payment links). It does **not** implement\ndirect payment creation (`POST /payments`), which would charge a card or bank account.\n\nThe three destructive tools — `ap_archive_customer`, `ap_archive_invoice`,\n`ap_delete_webhook` — require interactive confirmation before they run.\n\n| Domain | Tools |\n|--------|-------|\n| customers | `ap_list_customers`, `ap_get_customer`, `ap_list_customer_users`, `ap_create_customer`, `ap_add_customer_user`, `ap_archive_customer` ⚠ |\n| 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` ⚠ |\n| payments | `ap_list_transactions`, `ap_get_transaction`, `ap_list_payouts`, `ap_get_payout`, `ap_list_payout_transactions` |\n| webhooks | `ap_list_webhooks`, `ap_list_webhook_events`, `ap_create_webhook`, `ap_retry_webhooks`, `ap_delete_webhook` ⚠ |\n\nPlus discovery tools `ap_navigate` and `ap_status`.\n\n## Authentication\n\nAlternative Payments uses **OAuth 2.0 client-credentials**. Generate an API key\n(`client_id` / `client_secret`) in the Partner Dashboard. Set:\n\n- `ALTERNATIVE_PAYMENTS_CLIENT_ID`\n- `ALTERNATIVE_PAYMENTS_CLIENT_SECRET`\n- `ALTERNATIVE_PAYMENTS_ENVIRONMENT` (`production` or `demo`, default `production`)\n\nThe server exchanges these for a bearer token automatically and refreshes it before expiry.\n\n## Quick start\n\n**Claude Code (CLI):**\n\n```bash\nclaude mcp add alternative-payments \\\n  -e ALTERNATIVE_PAYMENTS_CLIENT_ID=your-client-id \\\n  -e ALTERNATIVE_PAYMENTS_CLIENT_SECRET=your-client-secret \\\n  -- npx -y github:WYRE-AI/alternative-payments-mcp\n```\n\n**Docker (HTTP transport, gateway mode):**\n\n```bash\ndocker run --rm -p 8080:8080 \\\n  -e AUTH_MODE=env \\\n  -e MCP_TRANSPORT=http \\\n  -e ALTERNATIVE_PAYMENTS_CLIENT_ID=... \\\n  -e ALTERNATIVE_PAYMENTS_CLIENT_SECRET=... \\\n  ghcr.io/wyre-ai/alternative-payments-mcp:latest\n```\n\n## Transports\n\n- **stdio** (default): `node dist/index.js`\n- **HTTP** (`MCP_TRANSPORT=http`): streamable HTTP on `MCP_HTTP_PORT` (default 8080),\n  with `/mcp` and `/health` endpoints. Each request gets a fresh stateless server,\n  which is required for the WYRE MCP Gateway.\n\n## Development\n\n```bash\nnpm install\nnpm run build\nnpm test\nnpm run lint\n```\n\n## License\n\nApache-2.0\n",
  "bytes": 3030,
  "sha": "8dd45cfaeae7f972e752d68d2b5ab548ac0f92b7b7d8212d3d2ab847aa7b0e3d",
  "repo_slug": "wyre-technology/alternative-payments-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_wyre_technology_alternative_pa_8edd4e0d/readme"
}