{"openapi":"3.1.0","info":{"title":"prxy.monster","version":"1.0.0","summary":"A proxy for your AI agents. Other proxies route. This one remembers.","description":"prxy.monster is a proxy for AI agents. Drops in front of any provider (Anthropic / OpenAI / AWS Bedrock / Google) via one env var swap. Same wire format. Per-request pricing, BYOK — we never see your provider bill. Twelve composable modules toggle per request: mcp-optimizer (~90% less MCP tool overhead), semantic-cache (~23% of calls return free), exact-cache (byte-match cache), patterns (Golden Loop pattern injection from past resolutions), compaction-bridge (preserves user intent across auto-compaction boundaries), ipc (infinite context — progressive age-based compression), rehydrator (restore working context), prompt-optimizer (token-density rewrites), cost-guard (per-key/day/month USD ceilings), tool-cache (dedupe MCP calls within request), router (cheapest provider satisfying request), guardrails (PII redaction + jailbreak detection). Supports MPP machine payments via HTTP 402 + Stripe Link.","contact":{"name":"ekkOS Technologies Inc.","email":"hello@prxy.monster","url":"https://prxy.monster"},"license":{"name":"Commercial (hosted, per-request) / MIT (CLI + module SDK + self-host)"},"x-logo":{"url":"https://api.prxy.monster/icon-192.png","altText":"prxy.monster","backgroundColor":"#0a0a0a","href":"https://prxy.monster"},"x-guidance":"Agent guidance: To use prxy.monster autonomously, hit POST /v1/agent/messages with no Authorization header — you will receive a 402 with a WWW-Authenticate Payment challenge. Decode the request= field (base64url JSON), present the offer to the operator (or settle via your wallet), then retry with Authorization: Payment id=\"...\", credential=\"<SPT>\". For API-key flow, sign up free at https://lair.prxy.monster/sign-up (1k req/mo) or subscribe at https://buy.stripe.com/6oUdR88gxgBj7F5ceh6c001 (Pro $20/mo for 100k req) / https://buy.stripe.com/9B67sK9kBgBj3oPfqt6c002 (Team $99/mo for 1M req). All tiers hard-cap (no overage); register your provider keys at the lair dashboard or via PUT /v1/byok/:provider. Models use whatever your provider account supports. See https://prxy.monster/llms-full.txt for full machine-readable context."},"servers":[{"url":"https://api.prxy.monster","description":"Production gateway"}],"x-service-info":{"categories":["ai","llm-gateway","developer-tools"],"docs":{"homepage":"https://prxy.monster","apiReference":"https://docs.prxy.monster","modules":"https://modules.prxy.monster","ledger":"https://receipts.prxy.monster","dashboard":"https://lair.prxy.monster","llms":"https://prxy.monster/llms-full.txt","repository":"https://github.com/Ekkos-Technologies-Inc/prxy-monster-local"},"brand":{"name":"prxy.monster","logo":"https://prxy.monster/og/icon-512.png","publisher":"ekkOS Technologies Inc.","country":"CA"},"machine_readable_alternates":[{"rel":"agent-manifest","href":"https://prxy.monster/agents.json"},{"rel":"llms-full","href":"https://prxy.monster/llms-full.txt"},{"rel":"catalog","href":"https://api.prxy.monster/v1/catalog"},{"rel":"capabilities","href":"https://api.prxy.monster/v1/capabilities"}]},"paths":{"/v1/agent/messages":{"post":{"summary":"MPP-protocol LLM endpoint (pay-per-call)","description":"Anthropic-compatible message completion gated by MPP. Returns HTTP 402 with a payment challenge when called without a valid Authorization: Payment header. Successful 200 responses include a Payment-Receipt header. The challenge includes an RFC 9530 SHA-256 content digest binding it to the request body (replay protection).","x-payment-info":{"authMode":"payment","price":"0.05","minPrice":"0.05","maxPrice":"0.05","currency":"usd","recipient":"acct_1SCXoFBQFhC8k5Tn","protocols":["mpp","x402"],"offers":[{"method":"stripe","intent":"charge","amount":"5","currency":"usd","recipient":"acct_1SCXoFBQFhC8k5Tn","expires":"2099-12-31T23:59:59Z","description":"Pay $0.05 per LLM call via Stripe Shared Payment Token. Drop-in Anthropic format response."}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","example":"bedrock/us.amazon.nova-micro-v1:0"},"max_tokens":{"type":"integer","example":1024},"messages":{"type":"array","items":{"type":"object","properties":{"role":{"type":"string","enum":["user","assistant","system"]},"content":{"type":"string"}}}}},"required":["model","messages"]}}}},"responses":{"200":{"description":"LLM response in canonical Anthropic format","headers":{"Payment-Receipt":{"schema":{"type":"string","example":"id=\"rec_…\", charge=\"ch_…\", amount=\"5\", currency=\"usd\", timestamp=\"2026-05-02T22:30:00Z\""}},"Cache-Control":{"schema":{"type":"string","example":"private"}}}},"402":{"description":"Payment Required — Authorization: Payment header missing or invalid (verification-failed). Body contains the full PaymentRequest with offers[] and expires.","headers":{"WWW-Authenticate":{"schema":{"type":"string","example":"Payment id=\"mpp_…\", realm=\"api.prxy.monster\", method=\"stripe\", intent=\"charge\", request=\"eyJ...\", digest=\"sha-256=:…:\""}},"Cache-Control":{"schema":{"type":"string","example":"no-store"}}},"content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","expires","offers","payment_request"],"properties":{"type":{"type":"string","example":"https://paymentauth.org/problems/payment-required"},"title":{"type":"string","example":"Payment Required"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"expires":{"type":"string","format":"date-time","example":"2026-05-03T01:01:09.000Z"},"offers":{"type":"array","items":{"type":"object","required":["method","intent","amount","currency","recipient"],"properties":{"method":{"type":"string","enum":["stripe"],"example":"stripe"},"intent":{"type":"string","enum":["charge"],"example":"charge"},"amount":{"type":"string","example":"5","description":"Cents (USD base units) for stripe-method offers."},"currency":{"type":"string","example":"usd"},"recipient":{"type":"string","example":"acct_1SCXoFBQFhC8k5Tn","description":"Stripe account ID for stripe-method offers."},"description":{"type":"string"}}}},"payment_request":{"type":"object","properties":{"id":{"type":"string","example":"mpp_abc123"},"realm":{"type":"string","example":"api.prxy.monster"},"expires":{"type":"string","format":"date-time"},"expires_at":{"type":"integer","description":"Unix seconds (legacy duplicate of expires)."},"offers":{"type":"array"}}}}}}}}}}},"/v1/messages":{"post":{"summary":"Anthropic-compatible proxy endpoint (BYOK, API-key auth)","description":"Anthropic-compatible message completion. Requires PRXY_KEY via Authorization: Bearer prxy_… header. Forwards to your registered Anthropic key. NOT an MPP-payable route — uses subscription billing. See /v1/catalog for tier pricing.","security":[{"BearerAuth":[]}],"x-payment-info":{"authMode":"api-key","billingModel":"subscription","price":"0","protocols":["subscription"],"offers":[]},"responses":{"200":{"description":"OK"},"401":{"description":"Auth required"},"429":{"description":"Tier cap reached — upgrade plan"}}}},"/v1/chat/completions":{"post":{"summary":"OpenAI-compatible proxy endpoint (BYOK, API-key auth)","description":"Drop-in OpenAI chat-completions shape. Same PRXY_KEY auth as /v1/messages. NOT an MPP-payable route — uses subscription billing.","security":[{"BearerAuth":[]}],"x-payment-info":{"authMode":"api-key","billingModel":"subscription","price":"0","protocols":["subscription"],"offers":[]},"responses":{"200":{"description":"OK"},"401":{"description":"Auth required"},"429":{"description":"Tier cap reached — upgrade plan"}}}},"/v1/catalog":{"get":{"summary":"Machine-readable pricing + tiers (free, public)","security":[],"x-payment-info":{"authMode":"public","billingModel":"free","price":"0","protocols":["none"],"offers":[]},"responses":{"200":{"description":"Catalog JSON"}}}},"/v1/capabilities":{"get":{"summary":"Wire formats, providers, modules, features (free, public)","security":[],"x-payment-info":{"authMode":"public","billingModel":"free","price":"0","protocols":["none"],"offers":[]},"responses":{"200":{"description":"Capabilities JSON"}}}},"/health":{"get":{"summary":"Liveness + provider config (free, public)","security":[],"x-payment-info":{"authMode":"public","billingModel":"free","price":"0","protocols":["none"],"offers":[]},"responses":{"200":{"description":"Healthy"}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"prxy-api-key","description":"API key minted via /v1/keys after subscription. Format: prxy_<32-byte-base64url>."}}}}