Metadata-Version: 2.4
Name: mcp-ucashpay
Version: 0.1.1
Summary: Merchant-side MCP server for U.CASH Pay: create checkouts, verify webhooks, read settings/integrations. Non-custodial.
Author: U.CASH
License: MIT
Project-URL: Homepage, https://pay.u.cash
Project-URL: Repository, https://github.com/UdotCASH/mcp-ucashpay
Project-URL: Documentation, https://github.com/UdotCASH/mcp-ucashpay#readme
Project-URL: Changelog, https://github.com/UdotCASH/mcp-ucashpay/blob/main/CHANGELOG.md
Keywords: mcp,ucash,u.cash,model-context-protocol,payments,crypto,checkout,ai-agents,non-custodial
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp
Provides-Extra: dev
Requires-Dist: pytest>=7; extra == "dev"
Dynamic: license-file

# mcp-ucashpay

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-ucashpay python -m mcp_ucashpay
```

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_ucashpay.py
```

## Claude Desktop / Cursor config

```json
{
  "mcpServers": {
    "ucashpay": {
      "command": "uvx",
      "args": ["--from", "mcp-ucashpay", "python", "-m", "mcp_ucashpay"],
      "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.
