MENTAT

{
  "name": "MENTAT",
  "description": "MENTAT: agent-native OTC venue. Disciplined intelligence. Three settlement paths: escrow on Base (FloorEscrow contract, atomic, no admin keys), CoW Protocol relay (agent-signed, MEV-protected), and an XMR route via Wagyu (XMR in/out routed through XMR1 on Hyperliquid; Wagyu is the settlement counterparty; MENTAT never holds XMR; not trustless). Every fill carries whatever its chain can prove: one proof per leg in proofs[]. ERC-8004 Agent #31596.",
  "url": "https://mentat.market",
  "version": "3.0.0",
  "protocolVersion": "0.3.0",
  "provider": {
    "organization": "Agora0x",
    "url": "https://mentat.market",
    "contact": "trade@mentat.market"
  },
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "extensions": [
      {
        "uri": "https://mentat.market/a2a/extensions/settlement-paths/v1",
        "description": "settlement_path, route_legs, and proofs[] on every quote and order response",
        "params": {
          "settlement_paths": [
            "escrow",
            "cow_relay",
            "wagyu_route"
          ]
        }
      }
    ]
  },
  "authentication": {
    "schemes": []
  },
  "mentat": {
    "tagline": "disciplined intelligence",
    "principle": "every fill carries whatever its chain can prove",
    "contact": "trade@mentat.market",
    "homepage": "https://mentat.market",
    "receipts": "https://mentat.market/ledger",
    "settlement_paths": {
      "escrow": {
        "chain": "base",
        "chain_id": 8453,
        "contract": "0x9EC9d882C93F52621CBD0d146D3F2e0929E53AA7",
        "trustless": true,
        "fee_bps": 25,
        "skills": [
          "execute_trade",
          "check_trade"
        ],
        "contracts": {
          "v2": {
            "name": "FloorEscrow V2",
            "address": "0x9EC9d882C93F52621CBD0d146D3F2e0929E53AA7",
            "used_by": "execute_trade, check_trade and the Telegram bot"
          },
          "v3": {
            "name": "FloorEscrow V3",
            "address": "0x83818036539737a813D1D99f1c6Cd2867c7D6a6d",
            "deploy_block": 52006064,
            "used_by": "web deals: a maker posts at https://mentat.market/new and shares the deal link https://mentat.market/deal/{id}",
            "flow": "The maker funds the deal when creating it; the taker's fill settles both legs in one transaction; only the maker can cancel. A deal is not listed on MENTAT, but it is public on-chain and anyone with the link can fill it at the stated price. No skill calls V3: maker and taker use their own wallets.",
            "post": "https://mentat.market/new",
            "deal_link": "https://mentat.market/deal/{id}"
          }
        }
      },
      "cow_relay": {
        "chain": "base",
        "chain_id": 8453,
        "settlement": "0x9008D19f58AAbD9eD0D60971565AA8510560ab41",
        "vault_relayer": "0xC92E8bdf79f0507f65a392b0ab4667716BFE0110",
        "custody": "non-custodial",
        "fee_bps": 25,
        "skills": [
          "prepare_trade",
          "submit_signed_trade",
          "check_cow_order"
        ]
      },
      "wagyu_route": {
        "counterparty": "Wagyu (wagyu.xyz)",
        "trustless": false,
        "custody": "MENTAT never holds XMR",
        "route": "XMR in/out through XMR1 on Hyperliquid spot; three legs: source chain, Hyperliquid swap, destination chain",
        "pairs": [
          "XMR/USDC on Base (both directions)"
        ],
        "minimums_usd": {
          "sell_xmr": 25,
          "buy_xmr": 500
        },
        "fee_bps": 25,
        "fee_note": "MENTAT earns a 25 bps integrator fee on every order, applied inside Wagyu's quoted amount. Included in to_amount; reported by Wagyu as integrator_fee; counted in effective_cost_bps.",
        "paused_state": "When Wagyu answers 503 unavailable the route is paused; quotes return code routing_paused and the tape shows \"XMR routing paused\".",
        "proofs": [
          "deposit_tx (Monero tx hash on XMR legs)",
          "fill_tx (one per Hyperliquid fill hash from hlFills[])",
          "payout_tx (destination-chain tx hash)"
        ],
        "skills": [
          "get_quote",
          "create_xmr_order",
          "check_xmr_order",
          "get_route_status"
        ]
      }
    },
    "proof_shape": {
      "chain": "string",
      "kind": "deposit_tx | fill_tx | payout_tx | escrow_create_tx | cow_order_uid | settlement_tx",
      "hash": "string",
      "explorer_url": "string | null"
    },
    "identity": {
      "erc8004_agent_id": 31596,
      "registry": "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
      "chain_id": 8453
    },
    "payments": {
      "x402": true,
      "price_per_quote": "$0.01",
      "network": "base"
    },
    "endpoints": {
      "a2a": "https://api.mentat.market/a2a",
      "rest_quote": "https://api.mentat.market/api/quote",
      "rest_xmr_orders": "https://api.mentat.market/api/xmr/orders",
      "rest_tape": "https://api.mentat.market/api/tape",
      "rest_stats": "https://api.mentat.market/api/stats",
      "ledger": "https://mentat.market/ledger",
      "mcp": "https://api.mentat.market/mcp",
      "telegram": "https://t.me/FloorOTCbot"
    }
  },
  "skills": [
    {
      "id": "get_quote",
      "name": "Get OTC Quote",
      "description": "Live quote for a token swap at real market rates. USDC, USDT, USDbC, DAI, WETH, ETH, BTC pairs quote against escrow or CoW relay; XMR pairs (XMR/USDC on Base, both directions) quote through the Wagyu route and return settlement_path \"wagyu_route\", the three route_legs, and an empty proofs[]. MENTAT charges 25 bps on every path; on the XMR route it is an integrator fee applied inside Wagyu's quoted amount (mentat_fee_bps, already in to_amount; effective_cost_bps is all-in). Direction-aware minimums: sell XMR from $25, buy XMR from $500. Answers code \"routing_paused\" while XMR routing is paused.",
      "tags": [
        "otc",
        "swap",
        "quote",
        "xmr",
        "wagyu",
        "cow",
        "escrow"
      ],
      "examples": [
        "Get a quote for swapping 1000 USDC to DAI",
        "Quote 0.1 XMR to USDC on Base",
        "How much XMR do I get for 600 USDC?"
      ]
    },
    {
      "id": "execute_trade",
      "name": "Execute Escrow Trade",
      "description": "Create an escrow deal on Base through the FloorEscrow V2 contract (settlement_path \"escrow\"). Both parties deposit, settlement is atomic, no admin keys. Returns the create tx as the first proof. Web deals (mentat.market/new and deal links) settle through FloorEscrow V3 and need no skill: maker and taker call it from their own wallets.",
      "tags": [
        "otc",
        "swap",
        "trade",
        "escrow",
        "settlement"
      ],
      "examples": [
        "Swap 1000 USDC for DAI",
        "Execute trade: 5000 USDC to WETH"
      ]
    },
    {
      "id": "check_trade",
      "name": "Check Escrow Trade",
      "description": "On-chain status of a FloorEscrow V2 deal by its trade ID, with settlement_path, route_legs, and proofs[]. A FloorEscrow V3 web deal is read at mentat.market/deal/{id}.",
      "tags": [
        "trade",
        "status",
        "escrow"
      ],
      "examples": [
        "Check trade status for 0x8cb14ec9..."
      ]
    },
    {
      "id": "get_prices",
      "name": "Get Live Prices",
      "description": "Current token prices from CoinGecko for the escrow and CoW pairs. XMR is priced live by the Wagyu route at quote time.",
      "tags": [
        "prices",
        "market",
        "rates"
      ],
      "examples": [
        "What are the current token prices?"
      ]
    },
    {
      "id": "prepare_trade",
      "name": "Prepare CoW Order",
      "description": "Build a CoW Protocol order for the calling agent to sign (settlement_path \"cow_relay\"). Returns the EIP-712 typed data, MENTAT appData (25 bps partner fee), and a preflight check on the trader's balance and relayer allowance. The trader signs locally; MENTAT never custodies funds.",
      "tags": [
        "cow",
        "swap",
        "relay",
        "eip-712",
        "sign"
      ],
      "examples": [
        "Prepare a CoW order to swap 1000 USDC for WETH from 0xabc..."
      ]
    },
    {
      "id": "submit_signed_trade",
      "name": "Submit Signed CoW Order",
      "description": "Forward a trader-signed CoW order to the CoW order book on Base. MENTAT validates the EIP-712 signature locally, then relays. Returns the orderUid (first proof) and explorer URL.",
      "tags": [
        "cow",
        "swap",
        "relay",
        "submit"
      ],
      "examples": [
        "Submit signed order with signature 0x... and trader 0xabc..."
      ]
    },
    {
      "id": "check_cow_order",
      "name": "Check CoW Order",
      "description": "Status of a CoW order by its 56-byte orderUid: open / fulfilled / cancelled / expired, executed amounts, and proofs[] with the settlement transaction hash(es) once filled.",
      "tags": [
        "cow",
        "status",
        "order"
      ],
      "examples": [
        "Check CoW order 0x..."
      ]
    },
    {
      "id": "create_xmr_order",
      "name": "Create XMR Order (Wagyu route)",
      "description": "Create a durable XMR order routed through Wagyu: XMR -> USDC on Base or USDC on Base -> XMR. Requires to_address on the destination chain; optional refund_address on the source chain. Returns the exact deposit address, amount, and expiry from the venue (the funding instruction), settlement_path \"wagyu_route\", route_legs, and proofs[] (empty until each leg confirms). MENTAT earns a 25 bps integrator fee applied inside Wagyu's quoted amount (mentat_fee_bps). Wagyu is the settlement counterparty; MENTAT never holds XMR; not trustless.",
      "tags": [
        "xmr",
        "monero",
        "wagyu",
        "hyperliquid",
        "order"
      ],
      "examples": [
        "Create an order: 0.1 XMR to USDC, pay out to 0xYourBaseAddress",
        "Buy XMR with 600 USDC, deliver to 4AdUnd..."
      ]
    },
    {
      "id": "check_xmr_order",
      "name": "Check XMR Order (Wagyu route)",
      "description": "Status of an XMR order by order_id plus its to_address (the destination address is the read proof; a mismatch is not found). Returns the three legs (source-chain confirmations, Hyperliquid swap, destination delivery) and proofs[]: the Monero deposit tx hash, one fill_tx per Hyperliquid fill hash, and the destination payout tx hash. Hyperliquid fill hashes are appended as Wagyu saves them, including after completion.",
      "tags": [
        "xmr",
        "status",
        "proofs",
        "wagyu"
      ],
      "examples": [
        "Check XMR order ord_... for 0xYourBaseAddress"
      ]
    },
    {
      "id": "get_route_status",
      "name": "Route Status",
      "description": "Whether XMR routing is live or paused (Wagyu 503 unavailable pauses it), with the pause deadline and reason.",
      "tags": [
        "status",
        "xmr",
        "routing"
      ],
      "examples": [
        "Is XMR routing paused?"
      ]
    }
  ],
  "defaultInputModes": [
    "text"
  ],
  "defaultOutputModes": [
    "text"
  ]
}