Payway

What your agent can do

Payway gives your agent 6 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.

• →create_token — Tokenize sensitive card data (PAN, expiry, CVV, cardholder, document) into a single-use payment token (POST /tokens). Uses the PUBLIC apikey. Returns a token id consumed by create_payment, plus the card bin.
• →create_payment — Create a card charge from a token produced by create_token (POST /payments). Uses the PRIVATE apikey. amount is an integer in minor units (50000 = ARS 500.00). payment_type 'single' for a normal sale, 'distributed' with sub_payments for split/marketplace.
• →get_payment — Fetch a single payment by its Payway payment id (GET /payments/{id}). Uses the PRIVATE apikey.

// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("create_token", { /* ... */ });

Install

$ npm install @codespar/mcp-payway

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

{
  "mcpServers": {
    "payway": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-payway"
      ],
      "env": {
        "PAYWAY_PUBLIC_API_KEY": "<your_payway_public_api_key>",
        "PAYWAY_PRIVATE_API_KEY": "<your_payway_private_api_key>"
      }
    }
  }
}

After restart, your agent can call any of the 6 tools below — try create_token first.

Environment variables · 3

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

Available tools · 6

Each tool is independent — your agent loads only what it needs to reduce context and response time.

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Frequently asked questions