# tur-credits

> Prepaid micropayments (balance in öre) for MCP tools and AI agents.

tur-credits is a shared credits service. Hold prepaid balance, charge before a paid tool runs, get HTTP 402 or MCP JSON-RPC error -32042 when payment is required.

## Site

- Home: /
- Developers: /developers
- Quickstart: /quickstart
- Pricing: /pricing
- Machine catalog: /.well-known/mcp.json

## Facts

- Currency: öre (100 öre = 1 SEK)
- Starter credit: 1000 öre after verified email (once per address, credit projects)
- Trials: 3 free calls per tool, agent, and day
- Agent identity for trials: clientId or X-Credits-Client-Id (64 hex SHA-256). Without it, CF-Connecting-IP is used.
- Typical paid call: 100 to 200 öre (set by each service)
- Top-up: invoice (live). Stripe Checkout packages 50, 100, 250 SEK (coming soon)
- Paywall: HTTP 402, MCP error -32042 (PAYMENT_REQUIRED)

## Public API (Worker)

Base URL is configured via env (PUBLIC_CREDITS_BASE_URL / CREDITS_BASE_URL). Do not assume a workers.dev hostname from source.

- GET /health
- POST /v1/charge
- POST /v1/keys
- GET /v1/keys/verify
- GET /v1/:project/balance
- GET /v1/:project/usage
- POST /v1/:project/top-ups
- GET /v1/:project/trust
- POST /v1/:project/service-orders (service-billed projects only)

## Client

TypeScript package in-repo: @tur/credits-client
Helpers: checkAndCharge, CreditsClient, withCreditsGate

## Contact

https://theunnamedroads.com