Payotex MCP Server

The Payotex MCP server is a stateless Model Context Protocol server that exposes cross-chain swap quotes, deposit preparation, asset metadata, and tx-hash status lookups as typed tools, so AI agents (Claude Desktop, Cursor, custom MCP clients) can quote and track cross-chain swaps. It is a thin wrapper around public swap endpoints — no authentication, no per-user state, no database writes.

Transports

Streamable HTTP (available now)

Hosted at https://payotex.com/mcp. Each request runs against a fresh stateless server instance — no authentication required.

stdio (coming soon)

The npm package @payotex.com/mcp is not yet published. Once released, it will run as a subprocess launched by the MCP client (e.g. npx -y @payotex.com/mcp), optionally reading PAYOTEX_BASE_URL and PAYOTEX_MIDGARD_URL from the environment. Until then, use the hosted Streamable HTTP endpoint.

Client configuration

Any MCP client with Streamable HTTP support

{
  "mcpServers": {
    "payotex": {
      "url": "https://payotex.com/mcp"
    }
  }
}

Claude Desktop and Cursor stdio configuration will be documented here once the npm package is published.

Tool catalog (8 tools)

• payotex_meta_list_chains — List chains currently available for swaps. (public)
• payotex_meta_list_assets — List swappable asset identifiers (filterable by chain). (public)
• payotex_swap_quote — Indicative swap quote — pricing, fees, expected output, slippage, ETA, vault_verification. Does NOT return deposit address; call payotex_swap_prepare_deposit after the user confirms. (public)
• payotex_swap_prepare_deposit — Prepare a deposit after the user confirms — returns the deposit address and the EXACT amount to send. The amount's final digits identify the swap, so no memo / tag / OP_RETURN field is needed from the user's wallet. (public)
• payotex_swap_list_pools — List available swap pools (asset, status, depths). (public)
• payotex_swap_list_assets — List swappable assets with USD prices and halted flags. (public)
• payotex_swap_inbound_addresses — Per-chain deposit (inbound) addresses, gas rates, and dust thresholds — informational only. (public)
• payotex_swap_status — Raw swap status by deposit tx hash — stateless lookup, does not call the Payotex API. (public)