{"schemaVersion":"1.0","service":{"name":"Agent Research Desk","version":"1.8.0","releaseTag":"v1.8.0-agent-acquisition-loop","url":"https://agent-research-brief-api-production.up.railway.app"},"summary":"Agent-first entry path for other agents. It turns discovery into one clear machine loop: inspect schema, start free, buy one named-company trust decision, then keep that same subject alive through Company Watch instead of starting over later.","privacy":{"note":"Agent Research Desk does not publicly expose buyer prompts, wallet-level request history, or paid response contents. Public metrics are aggregate only.","publicMetrics":"aggregate-only"},"entryPoints":{"agentGuide":"/agents","capabilityManifest":"/agent-capabilities.json","docs":"/docs.json","routeAdvisor":"/start","trustPreview":"/trust-preview","firstPaid":"/api/company-intel","repeatRevenue":"/api/company-watch","publicDashboard":"/dashboard"},"paymentFlow":["Send an unpaid request to a protected POST route and expect HTTP 402.","Use the payment requirements in that challenge to retry with x402 on Base mainnet.","Receive HTTP 200 with structured JSON after settlement succeeds."],"heroFlow":["Start at /agents so the buyer agent sees one entry path instead of the whole product surface.","Inspect /agent-capabilities.json or /docs.json first, then use /trust-preview or /start before spending.","Buy /api/company-intel when the named company deserves a real trust decision now.","Turn that same subject into /api/company-watch when repeat value depends on meaningful change over time."],"machineFlow":["Read /agent-capabilities.json for the fastest machine-readable entry path and current route emphasis.","Use /trust-preview or /api/route-advisor when you want a free pre-buy decision before triggering payment.","Send the protected POST unpaid first, expect HTTP 402, then retry with x402 on Base mainnet.","Use the paid response to decide whether the same subject should move straight into Company Watch or one narrower follow-on route."],"repeatLoop":["Trust Preview filters weak targets before money moves.","Company Intel makes the first paid named-company decision.","Company Watch keeps the same company warm so the next decision does not restart from zero.","Source Check, Vendor Risk, and Deep Diligence stay as justified follow-on buys, not the first pitch."],"boundaries":["Do not send other agents to the full route ladder first when the named-company flow is enough.","Do not treat Company Watch as a first purchase. It compounds only after the first company decision exists.","Do not expose buyer prompts, wallet-level history, or paid response contents publicly. Public metrics stay aggregate only."],"outputShape":["summary","confidence","trustProfile","decisionSignals","risks","opportunities","nextActions","questions","sourceAttribution","commercial"],"starterPayloads":{"trustPreview":{"companyName":"Alpine Foods","website":"https://example.com","industry":"Food distribution","geography":"United States","researchFocus":"growth","knownClaims":["Regional specialty food distributor","Expanding private-label program"],"knownSignals":["Hiring for operations and sales","Launching new product categories"],"questions":["How concentrated is demand around a few buyers?","What trust signals matter most to partners?"]},"routeAdvisor":{"objective":"I need a fast trust snapshot on one named company before outreach.","subjectType":"company","decisionType":"outreach","hasNamedCompany":true,"wantsCheapestFirst":false,"hasSingleClaim":false,"seriousDecision":false},"companyIntel":{"companyName":"Alpine Foods","website":"https://example.com","industry":"Food distribution","geography":"United States","researchFocus":"growth","knownClaims":["Regional specialty food distributor","Expanding private-label program"],"knownSignals":["Hiring for operations and sales","Launching new product categories"],"questions":["How concentrated is demand around a few buyers?","What trust signals matter most to partners?"]},"companyWatch":{"companyName":"Alpine Foods","website":"https://example.com","industry":"Food distribution","geography":"United States","researchFocus":"growth","knownClaims":["Regional specialty food distributor","Expanding private-label program"],"knownSignals":["Hiring for operations and sales","Launching new product categories"],"questions":["How concentrated is demand around a few buyers?","What trust signals matter most to partners?"],"watchGoal":"Keep this named company under a live trust watch until the next approval, outreach, or diligence move is obvious.","decisionHorizon":"this-month","alertSensitivity":"balanced"}},"liveSignals":{"paymentCompletionRate":"6%","busiestRoute":{"endpoint":"company-intel","title":"Company Intel","path":"/api/company-intel","totalRequests":64,"paidRequests":2},"easiestWinRoute":{"endpoint":"research-brief","title":"Research Brief","path":"/api/research-brief"},"biggestFrictionRoute":{"endpoint":"company-intel","title":"Company Intel","path":"/api/company-intel"},"activeWatches":0,"changedLast24h":0,"followOnPotentialUsd":"0.00","repeatPaidBuyers":0,"topSource":{"source":"direct-or-unknown","agentPageVisits":0,"testerPageVisits":7,"docsPageVisits":45},"scout":{"status":"ready","merchantVisible":true,"indexedRoutes":2,"relevantMarketHits":39,"competitorCount":39,"topFocusEndpoint":"company-intel","topFocusTitle":"Company Intel","topFocusPath":"/api/company-intel"}},"sourcePlaybook":[{"source":"warm-technical","label":"Warm technical tester","firstRoute":"opportunity-check","firstRoutePath":"/api/opportunity-check","firstRoutePrice":"$0.01","whyThisRoute":"It is the fastest low-risk way to see the paid flow, the route ladder, and the structured JSON shape without overspending on the first test.","escalationRoute":"company-intel","escalationRoutePath":"/api/company-intel","escalationPrice":"$0.05","escalationRule":"the cheap screen says the target deserves more spend and the next question is about one real company","doNotStartWith":"deep-diligence","doNotStartWithReason":"the premium route is premature before the tester understands the ladder and knows the proof gap is serious"},{"source":"x402-builder","label":"x402 or Base builder","firstRoute":"opportunity-check","firstRoutePath":"/api/opportunity-check","firstRoutePrice":"$0.01","whyThisRoute":"It is the cheapest way to validate the 402 to paid 200 handoff before testing a larger diligence product.","escalationRoute":"vendor-risk","escalationRoutePath":"/api/vendor-risk","escalationPrice":"$0.05","escalationRule":"the buyer already knows the vendor and the real blocker is trust, rollout risk, or procurement readiness","doNotStartWith":"research-brief","doNotStartWithReason":"the broader memo is a worse first test unless the workflow is about open-ended research rather than the payment handoff"},{"source":"mcp-builder","label":"MCP or agent-tool builder","firstRoute":"company-intel","firstRoutePath":"/api/company-intel","firstRoutePrice":"$0.05","whyThisRoute":"This route is the easiest core product for an agent builder to wire into a deterministic workflow after schema inspection.","escalationRoute":"deep-diligence","escalationRoutePath":"/api/deep-diligence","escalationPrice":"$0.50","escalationRule":"the first-pass company read still leaves proof gaps that could change a real decision or approval flow","doNotStartWith":"lead-brief","doNotStartWithReason":"the sales-facing route is the wrong first move unless the workflow is explicitly about outreach rather than diligence"},{"source":"base-builder","label":"Base ecosystem builder","firstRoute":"opportunity-check","firstRoutePath":"/api/opportunity-check","firstRoutePrice":"$0.01","whyThisRoute":"It keeps the first live spend low while proving the service can screen a trust question for a real operator decision.","escalationRoute":"company-intel","escalationRoutePath":"/api/company-intel","escalationPrice":"$0.05","escalationRule":"the cheap screen suggests the company or operator is worth a proper trust-and-posture read","doNotStartWith":"deep-diligence","doNotStartWithReason":"jumping to the premium route too early creates more spend before the workflow has shown that missing evidence really changes the decision"},{"source":"manual-dm","label":"Manual direct outreach","firstRoute":"company-intel","firstRoutePath":"/api/company-intel","firstRoutePrice":"$0.05","whyThisRoute":"It shows a clear before-contact or before-approval use case without forcing the buyer to understand every route on the first pass.","escalationRoute":"vendor-risk","escalationRoutePath":"/api/vendor-risk","escalationPrice":"$0.05","escalationRule":"the buyer already knows the company is interesting and now needs a sharper trust or control read","doNotStartWith":"research-brief","doNotStartWithReason":"the broadest route slows the buyer down when the outreach is about one named target and a simple trust decision"}]}