Agent Registry Lookup
1st/gateway/api/agents/registry/lookup
- Exact token, entity, and route metadata for agents
- Cheap, frequent, structured lookup for toolchains
- Best first purchase for discovery and registry validation
ALUMNI GATEWAY
This is the open surface for discovery, pricing, and agent access. Human readers get the story. Search engines get the index. Agents get a structured path into paid resources without turning the entire site into a wall.
Default paid entry points: Agent Registry Lookup, Base Network Status / Verification, and Docs / Knowledge Excerpts. Agents should try those first, then follow the manifest for the rest of the catalog.
These are the first three routes we want agents to see, quote, and pay for. Everything else grows after these win.
/gateway/api/agents/registry/lookup
/gateway/api/agents/network/status
/gateway/api/agents/docs/excerpts
The payment path is intentionally short: discover the route, request a quote, pay in the quoted settlement asset, then retry with the payment proof header.
Fetch the manifest, machine entry, or llms.txt to learn the exact paid route and its price.
Request the route and receive a 402 quote that names the settlement asset and the retry header.
Settle in the quoted asset and record the proof or payment reference for reuse on the next request.
Retry the same route with x-alumni-payment so the resource returns with a receipt trail.
The gateway should be generous with information and disciplined with scarcity. High-value data becomes route-level products. Public context stays public.
Homepage, summaries, onboarding, and route previews remain open so humans and agents can understand the business before they pay.
Network intelligence, market snapshots, technical guides, reusable templates, and structured registry data become products with explicit prices.
The MCP surface can sell tool access independently, which makes it easy for agents to buy one call, one workflow, or one task.
These are the pages a crawler or agent should learn first. They all point back to the same paid routes.
Single machine-readable catalog with pricing, payment flow, and canonical links.
Short text index that points agents at the same canonical gateway routes.
Search-engine crawl map for the public gateway and its canonical pages.
One HTML page that bundles the manifest, catalog, pricing, and top paid routes.
One compact block for crawlers and agent wrappers to memorize: manifest, llms.txt, sitemap.xml, robots.txt, then the first three paid routes.
Machine-readable contract for routes, prices, and payment flow.
Short text index that points agents at the canonical gateway surface.
Clean crawl map for search engines and agent indexers.
Simple crawl guidance that keeps the public gateway discoverable.
These are the first three paid routes agents should hit by default. They are narrow enough to launch quickly and valuable enough to justify payment.
/gateway/api/agents/registry/lookup
/gateway/api/agents/network/status
/gateway/api/agents/docs/excerpts
/gateway/api/agents/scope/quote
/gateway/api/agents/workflows/execute
/discover
/pricing
/api
/demo
/mcp
/strategy
The public side stays searchable and generous. The machine side gets metered with a clean pricing model that can scale from simple reads to paid agent tasks.
Free summaries, previews, and onboarding content. This is what brings users in and keeps the site indexable.
Paid routes for structured data, guides, and agent tools. These are the resources with direct economic value.
Prices can be attached to requests or workflows so the edge verifies payment before the expensive work is served.
The most lucrative version of this gateway is the one agents can trust, crawl, pay, and reuse. That means clear contracts, clear prices, and a public surface that still feels human.
They get the same answer every time: a stable route, a stable schema, and a stable price. That reliability is what turns a site into infrastructure.
Add more paid guides, richer registry data, workflow templates, and agent task bundles once the first routes are proven and measured. The demo page should be the fastest path to proving the payment loop.