U.CASH Pay

Official12 tools

by UdotCASH · Python

Pay x402 resources on U.CASH from your own wallet: view the price, pay on-chain, settle by hash.

cash.u/ucash-pay — Model Context Protocol (MCP) Server

The cash.u/ucash-pay MCP server supports paying x402 resources on U.CASH from a user’s own wallet. It enables users to view the price, submit an on-chain payment, and settle the transaction by providing a hash. The server is identified by the slug cash-u-ucash-pay.

🛠️ Key Features

View the price for an x402 resource on U.CASH
Pay on-chain from a user’s own wallet
Settle using a transaction hash

🚀 Use Cases

Paying x402 resources on U.CASH
Verifying and reconciling settlements via transaction hash

⚡ Developer Benefits

Clear flow for price lookup, on-chain payment, and hash-based settlement
Focused integration surface for U.CASH x402 payments

⚠️ Limitations

Available details describe payment, pricing visibility, and hash settlement; no additional tools, topics, or broader scope are provided.

Topics

agentsbitcoincrypto-paymentsdefiethereumhttp-402mcpnon-custodialpayment-gatewayucashweb3ai-agentsmodel-context-protocol

Captured live from the server via tools/list.

uxc_view_door

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.

Parameters2

res_id	string	required
status	boolean	optional	poll mode: GET /r/{id}?status=1 - no-mint settlement check

Raw schema

{
  "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"
  ]
}

uxc_verify_payment

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.

Parameters2

challengeId	string	required
hash	string	required

Raw schema

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

uxc_get_market

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.

Parameters2

q	string	optional	filter by title/merchant/description
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "filter by title/merchant/description"
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "default": 50
    }
  }
}

uxc_get_services

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

Parameters1

limit

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 200,
      "default": 50
    }
  }
}

uxc_search_catalog

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.

Parameters4

query	string	optional
filters	string	optional
pagination	string	optional
cloud	string	optional

Raw schema

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

uxc_get_product

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

Parameters2

id	string	required
cloud	string	optional

Raw schema

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

uxc_lookup_products

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

Parameters2

ids	array	required
cloud	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "cloud": {
      "type": "string"
    }
  },
  "required": [
    "ids"
  ]
}

uxc_create_checkout

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

Parameters5

line_items	array	required	each: {item:{id}, quantity}
currency	string	optional	optional cart display currency
buyer	string	optional
context	string	optional
cloud	string	optional	merchant token when buying from a hosted merchant

Raw schema

{
  "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"
  ]
}

uxc_get_checkout

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

Parameters2

id	string	required
cloud	string	optional

Raw schema

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

uxc_complete_checkout

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

Parameters3

id	string	required
ap2	string	optional	optional AP2 checkout mandate
cloud	string	optional

Raw schema

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

uxc_cancel_checkout

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

Parameters2

id	string	required
cloud	string	optional

Raw schema

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

uxc_get_order

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

Parameters2

id	string	required
cloud	string	optional

Raw schema

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

README.md2 KBView on GitHub

mcp-ucash

A merchant-side MCP server for U.CASH Pay. Let Claude Desktop, Cursor, or any MCP client manage a merchant's pay.u.cash: create checkouts, verify settlement webhooks, and read settings + integration credentials.

Tools

create_checkout(amount, currency, title, external_reference) → hosted checkout URL + transaction id
verify_webhook(raw_body, signature_header) → HMAC verify an X-Webhook-Signature
get_integrations() → Discord/Telegram/BigCommerce/Ecwid/Wix credentials (from /v1/integrations)
get_settings() → safe agent settings (from /v1/settings)

Run

bash

# one-liner: uv installs an isolated Python 3.10+ and the deps for you
uvx --from mcp-ucash python -m mcp_ucash

Or from source:

bash

pip install "mcp[cli]"
export UXC_API_KEY=uxc_...          # agent API key, for /v1/* reads
export UCASH_CLOUD_TOKEN=st_...     # store cloud token, for create_checkout
export UCASH_WEBHOOK_SECRET=...     # for verify_webhook
python mcp_ucash.py

Claude Desktop / Cursor config

json

{
  "mcpServers": {
    "ucash": {
      "command": "uvx",
      "args": ["--from", "mcp-ucash", "python", "-m", "mcp_ucash"],
      "env": {
        "UXC_API_KEY": "uxc_...",
        "UCASH_CLOUD_TOKEN": "st_...",
        "UCASH_WEBHOOK_SECRET": "..."
      }
    }
  }
}

MCP directories

This repo ships the manifests the MCP directories read:

mcp.json - client/registry descriptor (Glama, MCP Registry).
smithery.yaml - build + start spec for Smithery.

License

MIT.

Install

Tools (12)

uxc_view_dooruxc_verify_paymentuxc_get_marketuxc_get_servicesuxc_search_cataloguxc_get_productuxc_lookup_productsuxc_create_checkout

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.u.cash/

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "ucash-pay": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.u.cash/"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

cash.u/ucash-pay — Model Context Protocol (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

uxc_view_door

uxc_verify_payment

uxc_get_market

uxc_get_services

uxc_search_catalog

uxc_get_product

uxc_lookup_products

uxc_create_checkout

uxc_get_checkout

uxc_complete_checkout

uxc_cancel_checkout

uxc_get_order

mcp-ucash

Tools

Run

Claude Desktop / Cursor config

MCP directories

License

Install

Remote endpoint

Related servers