[ for agents & integrators ]

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

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

Auth model (auth.md)

How authentication works: public read access needs no credentials; vendor magic-link / Google OAuth and reviewer provisioning are documented for integrators.

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.