U.CASH Pay

Fetch the public 402 payment door for a resource (what a buyer sees at https://agents.u.cash/r/{res_id}): the price + the multi-coin accepts[] (each asset, the seller receive address, and the exact amount to pay). No key. Use as a BUYER to see what to pay, then uxc_verify_payment after paying. status=true polls settlement without minting a new challenge.

{
  "type": "object",
  "properties": {
    "res_id": {
      "type": "string"
    },
    "status": {
      "type": "boolean",
      "description": "poll mode: GET /r/{id}?status=1 - no-mint settlement check"
    }
  },
  "required": [
    "res_id"
  ]
}

BUYER-SIDE. After paying a resource (from uxc_view_door) on-chain from your own wallet, submit the transaction hash to settle it. Pass the challengeId from the accepts[] entry you paid and the on-chain transaction hash. Returns settled (confirmed) or pending (awaiting confirmations). No seller key needed - the challengeId identifies the resource, and settlement is gated by on-chain confirmation.

{
  "type": "object",
  "properties": {
    "challengeId": {
      "type": "string"
    },
    "hash": {
      "type": "string"
    }
  },
  "required": [
    "challengeId",
    "hash"
  ]
}

The PUBLIC cross-merchant market catalog: every published checkout across merchants (id, title, price, currency, merchant, domain, payable url). No key. q filters by title/merchant/description.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "filter by title/merchant/description"
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "default": 50
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 20,
      "description": "Optional response projection: dot paths to keep, e.g. [\"items.title\",\"items.price\"] or row-level [\"title\",\"price\"]. Envelope/meta keys (ok, success, total, count, pagination) are always kept; unknown paths are ignored; empty/absent = full response."
    }
  }
}

The PUBLIC cross-provider services catalog (eSend rail: each row carries the provider contact email, a sendable asset code and a price). No key.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 200,
      "default": 50
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 20,
      "description": "Optional response projection: dot paths to keep, e.g. [\"items.asset\",\"items.price\"] or row-level [\"asset\",\"price\"]. Envelope/meta keys (ok, success, total, count, pagination) are always kept; unknown paths are ignored; empty/absent = full response."
    }
  }
}

Search a merchant catalog (text query + price filters + pagination). The merchant is resolved from a cloud token (the "cloud" argument) or the platform default. No key.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "filters": {
      "type": "string"
    },
    "pagination": {
      "type": "string"
    },
    "cloud": {
      "type": "string"
    }
  }
}

Fetch a single catalog product by id. Public (no key); pair with uxc_search_catalog to find ids.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "cloud": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ]
}

Batch catalog lookup by ids. Public (no key).

{
  "type": "object",
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "cloud": {
      "type": "string"
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 20,
      "description": "Optional response projection: dot paths to keep, e.g. row-level [\"id\",\"title\",\"price\"]. Envelope/meta keys (ok, success, total, count, pagination) are always kept; unknown paths are ignored; empty/absent = full response."
    }
  },
  "required": [
    "ids"
  ]
}

Create a UCP checkout session (multi-item, mixed-currency cart) for a merchant catalog. No key. Returns {id, status, currency, line_items, totals, ap2}.

{
  "type": "object",
  "properties": {
    "line_items": {
      "type": "array",
      "description": "each: {item:{id}, quantity}"
    },
    "currency": {
      "type": "string",
      "description": "optional cart display currency"
    },
    "buyer": {
      "type": "string"
    },
    "context": {
      "type": "string"
    },
    "cloud": {
      "type": "string",
      "description": "merchant token when buying from a hosted merchant"
    }
  },
  "required": [
    "line_items"
  ]
}

Fetch a UCP checkout session by id (status: incomplete -> ready_for_complete -> completed). No key; pass cloud for a hosted merchant.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "cloud": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ]
}

Mint payment challenges for a checkout session -> ready_for_complete. Optional ap2 (AP2 checkout mandate). No key; pass cloud for a hosted merchant.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "ap2": {
      "type": "string",
      "description": "optional AP2 checkout mandate"
    },
    "cloud": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ]
}

Cancel a UCP checkout session. No key; pass cloud for a hosted merchant.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "cloud": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ]
}

View a UCP checkout session as an order (per-item fulfillment status + fulfillment events). No key; pass cloud for a hosted merchant.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "cloud": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ]
}

List every u.cash MCP server in the fleet (buyer, seller, prime, legacy): product surface, auth model, transports with install coordinates, docs URL. Optional q filters by name/product/summary. Discovery only - connect to each server directly with your own credentials; no call is ever proxied.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "case-insensitive substring over name/product/summary"
    }
  }
}

Search tools across every u.cash MCP server by name or description (case-insensitive substring), optionally scoped to one server. Returns the tool, a one-liner, its server, and how to connect. Discovery only - connect to that server directly; no call is ever proxied.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "substring matched over tool name + description"
    },
    "server": {
      "type": "string",
      "description": "optional: restrict to one fleet server name"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    }
  }
}