pympp 0.1.0

HTTP 402 Payment Authentication for Python

pympp

Python SDK for the Machine Payments Protocol

Documentation

Full documentation, API reference, and guides are available at machinepayments.dev/sdk/python.

Install

pip install pympp

Quick Start

Server

from mpp import Credential, Receipt
from mpp.server import Mpp
from mpp.methods.tempo import tempo, ChargeIntent

server = Mpp.create(
    method=tempo(
        intents={"charge": ChargeIntent()},
        currency="0x20c0000000000000000000000000000000000000",
        recipient="0x742d35Cc6634c0532925a3b844bC9e7595F8fE00",
    ),
)

@app.get("/paid")
@server.pay(amount="0.50")
async def handler(request, credential: Credential, receipt: Receipt):
    return {"data": "...", "payer": credential.source}

Client

from mpp.client import Client
from mpp.methods.tempo import tempo, TempoAccount, ChargeIntent

account = TempoAccount.from_key("0x...")

async with Client(methods=[tempo(account=account, intents={"charge": ChargeIntent()})]) as client:
    response = await client.get("https://api.example.com/resource")

Examples

Example	Description
api-server	Payment-gated API server
fetch	CLI tool for fetching URLs with automatic payment handling
mcp-server	MCP server with payment-protected tools

Development

Always run formatting and lint checks before committing:

uv run ruff format .
uv run ruff check .
uv run python -m pytest tests/ -x -q

Protocol

Built on the "Payment" HTTP Authentication Scheme. See payment-auth-spec for the full specification.

License

MIT OR Apache-2.0