# mcp-ucash

<!-- mcp-name: io.github.UdotCASH/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](https://smithery.ai).

## License

MIT.