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.

Install

npm install @payotex.com/mcp
# or run on demand
npx -y @payotex.com/mcp

The npm package is published as @payotex.com/mcp.

Transports

stdio (default)

Launched as a subprocess by the MCP client. Optionally reads PAYOTEX_BASE_URL and PAYOTEX_MIDGARD_URL from the environment.

Streamable HTTP

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

Client configuration

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "payotex": {
      "command": "npx",
      "args": ["-y", "@payotex.com/mcp"],
      "env": { "PAYOTEX_BASE_URL": "https://payotex.com" }
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json (or the project-level .cursor/mcp.json):

{
  "mcpServers": {
    "payotex": {
      "command": "npx",
      "args": ["-y", "@payotex.com/mcp"]
    }
  }
}

Generic HTTP MCP client

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

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)

Payotex MCP Server