Revuo developer resources
Everything Revuo publishes is available in structured form. Prefer the
MCP endpoint for tool calls;
every HTML page also serves Markdown via Accept: text/markdown.
Public MCP server
Model Context Protocol endpoint over streamable HTTP, no auth required for public data. Tools include rankings.get, products.search, products.find_by_capability, products.find_agent_ready, products.get and categories.list.
https://www.revuo.ai/api/mcp
MCP server card (SEP-1649)
Machine-readable card for the public MCP server: endpoint, transport, capabilities and the tool inventory — discovery without a tools/list round-trip.
https://www.revuo.ai/.well-known/mcp/server-card.json
Protected resource metadata (RFC 9728)
Auth discovery document for the API, also advertised via WWW-Authenticate on every 401 response. Bearer-header credentials; see auth.md for the flows.
https://www.revuo.ai/.well-known/oauth-protected-resource
API catalog (RFC 9727)
Machine-readable linkset describing every Revuo API: anchor URLs with service-desc (OpenAPI), service-doc and status relations for automated discovery.
https://www.revuo.ai/.well-known/api-catalog
OpenAPI spec
The full REST surface as an OpenAPI document, generated from the live controllers. Also served versioned at /api/openapi/v1.json.
https://www.revuo.ai/openapi.json
Error model & rate limits
All errors return RFC 9457 problem+json (typed ProblemDetails schema on every operation in the OpenAPI spec). Responses carry RateLimit-Limit / RateLimit-Remaining / RateLimit-Reset headers; 429s add Retry-After — honor them to self-throttle.
https://www.revuo.ai/openapi.json
Auth model (auth.md)
How authentication works: public read access needs no credentials. Vendor and reviewer sign-in are human flows — agents must not request a magic link.
https://www.revuo.ai/auth.md
llms.txt
Machine-readable guide to Revuo: trust signals, capability taxonomy, recommended MCP tools, when-to-use guidance and citation URL patterns.
https://www.revuo.ai/llms.txt
Ranking methodology (JSON)
The published ranking formula in machine-readable form — ordering basis, inputs and freshness rules behind every "Best {Category}" list.
https://www.revuo.ai/api/methodology
Sitemap
Every indexable page: categories, products, features, comparisons, blog posts and "Best of" lists.
https://www.revuo.ai/sitemap.xml
RSS feed
Editorial articles as they are published.
https://www.revuo.ai/rss.xml
robots.txt + Content Signals
Crawler directives plus Content-Signal preferences (ai-train, search, ai-input — all permitted). All AI crawlers are welcome.
https://www.revuo.ai/robots.txt
Markdown content negotiation
Send an Accept header that prefers markdown and any page returns clean Markdown instead of HTML,
with Vary: Accept set for caches.
curl -s -H "Accept: text/markdown" https://www.revuo.ai/tools
Requests whose Accept header lists only unsupported types receive
406 Not Acceptable.