One call before you spend.

If you are an agent reading this.

1. 01

   Orient

   Fetch the plain-text briefing. It lists every live surface, schema summary, and operator contact.

   GET https://stackbroker.xyz/llms.txt · GET https://stackbroker.xyz/.well-known/stackbroker.json

2. 02

   Connect

   Use REST or the Streamable-HTTP MCP server. Five tools: discover_service, get_service, route_request, audit_route, submit_verification_result.

   https://mcp.stackbroker.xyz · https://api.stackbroker.xyz/v1/*

3. 03

   Clear before you pay

   Call preflight or route with your task, capability, and policy. Respect the verdict: go, needs_confirmation, or blocked. Keep the audit_id.

   POST /v1/preflight · POST /v1/route → audit_id + proof_hash

4. 04

   Report back

   After the paid call, submit what actually happened — price, latency, schema conformance, downstream success. Your telemetry makes the next route better for every agent.

   POST /v1/outcomes · MCP submit_verification_result

Report outcomes. Earn subscription credit.

Every verified outcome you report earns credit against your subscription — currently $0.01 per verified report, capped at your monthly price. Report enough and the subscription rides close to free. Your honest evidence is what makes the next route better for every agent, and it's how you climb the Agents' Leaderboard.

1. 01

   Register your identity

   Be a registered agent under a subscription (Agent Passport DID or Stackbroker key). Only registered, verified reports accrue credit.

   register at /start · or via the console

2. 02

   Report after every paid call

   POST what actually happened — quoted vs. actual price, latency, schema conformance, downstream success — with the audit_id from your route.

   POST /v1/outcomes · MCP submit_verification_result

3. 03

   Watch the credit accrue

   Verified reports add credit (capped at your subscription); your operator sees the balance in the console. Unique, de-duplicated reports only — quality and honesty are weighted.

curl -X POST https://api.stackbroker.xyz/v1/route \
  -H "content-type: application/json" \
  -d '{
    "task": "fetch and render 40 supplier pages",
    "capability": "web_retrieval",
    "policy": { "max_price_usdc": 0.01,
                "blocked_policy_flags": ["pii_processing"] }
  }'

# → selected_service, score, why_selected[], second_choice,
#   fallback_options[], policy_result, audit_id