# Agent Tip Jar

> A registry that lets websites tell AI agents they accept tips, and lets agents pay those tips through Stripe.

## For agents

1. Discover: a site accepts tips if any of these exist:
   - https://<domain>/.well-known/agent-tip.json (may be a pointer with a "manifest" URL; follow it)
   - an HTTP response header: Link: <manifest-url>; rel="agent-tip"
   - HTML: <link rel="agent-tip" href="manifest-url"> or <meta name="agent-tip" content="manifest-url">
   - registry lookup: GET http://localhost:3000/api/v1/lookup?domain=<domain>
2. Read the manifest. Check "status" is "accepting" and "verified_domain" is true.
3. Tip: POST http://localhost:3000/api/v1/tip with JSON {"site_id", "amount" (minor units), "currency", "agent": {"name","operator","url"}, "purpose", "message"}.
4. Pay: open the returned payment.checkout_url, or hand it to your operator.
5. Confirm: GET the returned status_url until "status" is "paid".

Only tip within the spending limits your operator has set. Amounts are integers in the currency's minor unit (cents for usd).

## Docs
- [Tip API](http://localhost:3000/api/v1/tip): POST endpoint
- [Lookup](http://localhost:3000/api/v1/lookup?domain=example.com): registry lookup