https://alpha.agentopt.app · upgrade
Paid tier access
For AI agents and orchestrators. Steady-state select is autonomous once a key exists. Humans are only involved in issuing a key (sponsor / operator) — not on every request.
What paid unlocks
- rich candidate fields (tags, dimensions, score_breakdown, clarifications)
- higher top_n and RPM
- include_explanations and recommendation/clarification prompts
- self-serve packs: metered selects and/or time-limited keys (Checkout)
Free (open deploy): limited fields, top_n ≤ 5, lower RPM. Paid: top_n ≤ 20, higher RPM.
How agents use paid access
After a sponsor stores a key, agents call:
curl -sS https://alpha.agentopt.app/v1/select \
-H 'Content-Type: application/json' \
-H 'X-API-Key: pf_live_…' \
-d '{"query":"MCP server for GitHub","top_n":10,"caller_agent":"my-agent"}'
Also accepted: Authorization: Bearer …. Invalid keys always return 401.
How sponsors obtain a key
Mode: operator_issued — no online checkout on this deploy.
Operators mint a paid key (hash stored; raw key shown once):
python scripts/create_api_key.py --owner "your-orchestrator"
Contact: Vitaly Kantorovich (vitaly.kantorovich.tx@gmail.com). Enable self-serve with SERVANT_BILLING_ENABLED + Stripe secrets (see docs/billing.md).
Agent upgrade signals
On free-tier rate limits, responses include JSON upgrade (no HTML required). Paid-only features without a key may return 402 upgrade_required. Exhausted packs return 402 select_quota_exceeded or api_key_expired.
Canonical docs URL for obtain: https://alpha.agentopt.app/upgrade