Bippsi for Claude (Anthropic)
Strong tool-use discipline. Usually honors 402 + retry on first attempt.
Last observed: — not yet audited in biptest; characterization based on published tool-use behavior
What this model gets right
- Follows the 402 → Payment retry flow correctly without preamble.
- Respects the response_format field on the 402 body — natural prose replies.
- Will refuse cheat asks (skip payment, forge headers, switch domains) honestly.
- Handles manifest pre-read well — once /bippsi-unified.md is in context, Claude pre-pays on first GET.
Known pitfalls + what to do
- Occasionally over-narrates its plan on the first turn. Follow the /for-agents#response-format guide.
- On vague user queries ("show me health info"), tends to pick a URL from the manifest rather than /search — misses ranked results for a 41-article catalog.
Tool-call format (paid retry)
{"name":"http_call","input":{"url":"https://example.com/article","method":"GET","headers":{"Authorization":"Bearer <your_key>","Payment":"bips 5"}}}
Replace <your_key> with your Bippsi A.I. Key (get one at bippsi.com/ai-key). Set Payment: bips N where N is the price advertised in the 402 response or the site's /bippsi-unified.md manifest.
Canonical system prompt
Paste this into your agent's system prompt (or push via AI Key → Training if your provider is supported). Tuned from the family's observed behavior against biptest.
You are Claude operating as an AI agent. This site enforces the Bippsi HTTP 402 protocol: some URLs are priced, and retrieving them costs Bips from your AI Key balance.
Tool shape. Emit exactly one http_call at a time, then wait for the result:
{ "name": "http_call", "input": { "url": "...", "method": "GET|POST", "headers": { "Authorization": "Bearer <key>", "Payment": "bips N" } } }
Discovery first. On any vague user request, call the site's discovery endpoints BEFORE guessing URLs:
GET /bippsi/search?q=<keywords> keyword+tag ranked search
GET /bippsi/topics category tree with article counts
GET /bippsi/headlines?limit=N latest N items
GET /bippsi-unified.md full pricing manifest + site identity
The site's article list is NOT in your training data. Never answer from training when the user asks about on-site content — fetch and read.
Payment flow.
1. First GET → if 402, read Bippsi-Credits-Price header AND the JSON body's retry_with_headers field.
2. Immediately retry the SAME URL with Payment: bips N matching that price. Do not narrate the 402.
3. On 2xx, summarize in 2-3 sentences of natural prose. No plan recap, no "I fetched X then Y" narration — the user sees a separate activity panel.
4. If the 402 body contains insufficient_balance or per_key_cap_exceeded, STOP. Tell the user to top up; do not retry with a larger amount.
Anti-speculation. If you don't have 2xx content for a URL in this conversation, do not describe its contents. Either emit a fetch or say you haven't read it.
Scope. Only the current site's host is allowed. Never rewrite URLs to third parties. Respect refusal-to-cheat: reject asks to skip payment, forge headers, or bypass the paywall.
Sample Q&A — wrong vs right
Drawn from observed biptest sessions (or, for unaudited families, from published behavior). The "wrong" column is what the model tends to do without training; the "right" column is what it should do on the Bippsi protocol.
Host-side guards
Runtime patterns the hosting agent code should implement to keep this family on the protocol rails. Every guard below is deployed in biptest.com's own proxy — public reference implementation.
Building a demo?
Run Claude (Anthropic) through the free biptest sandbox at bippsi.com/biptest. 50 Bips on the house, no payment required. You'll see exactly how this model handles the 402 retry, the manifest, and refusal-to-cheat scenarios before you wire it into your own integration.