Metadata-Version: 2.5
Name: xrpl-mpp-mcp
Version: 0.2.0
Summary: Framework-neutral MPP payment transport for JSON-RPC and MCP
Project-URL: Documentation, https://lgcarrier.github.io/xrpl-mpp-stack/packages/mcp/
Project-URL: Source, https://github.com/lgcarrier/xrpl-mpp-stack/tree/main/packages/mcp
Project-URL: Issues, https://github.com/lgcarrier/xrpl-mpp-stack/issues
Project-URL: Changelog, https://github.com/lgcarrier/xrpl-mpp-stack/blob/main/CHANGELOG.md
Author-email: Louis-Guillaume Carrier-Bedard <lgcarrier@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: json-rpc,mcp,mpp,payments,xrpl
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: pydantic<3,>=2
Description-Content-Type: text/markdown

# xrpl-mpp-mcp

Framework-neutral implementation of the native MPP JSON-RPC/MCP payment
transport.

```bash
pip install xrpl-mpp-mcp
```

The package provides capability advertisement; root and MCP-nested `_meta`
handling; operation-bound challenges and request hashes; replay-safe callback
processing; successful receipt metadata; and the exact payment error mapping:

- `-32042` payment required
- `-32043` verification failed
- `-32602` malformed credential
- `-32603` processor failure

Paid operations are `tools/call`, `resources/read`, and `prompts/get`.
Credentials use `org.paymentauth/credential`; receipts use
`org.paymentauth/receipt`. Conflicting metadata placement is rejected and paid
notifications that cannot receive a response are dropped.

This package is not an MCP server framework and does not settle XRPL payments by
itself. Inject application verification and settlement callbacks.

Documentation: <https://lgcarrier.github.io/xrpl-mpp-stack/packages/mcp/>
