Read the shelf from code.

The REST surface is designed for discovery, not bulk mirroring. Responses are JSON, public reads are cached, and list sizes are capped. The published OpenAPI document is the contract for query parameters and response fields.

Version 1.0.0 is public beta. Compatible fields may be added to responses. Breaking contract changes will use a new major version, and a scheduled retirement will be documented before it happens.

GET /api/tools

Search, filter, sort, and page through published tools.

GET /api/tools/by-slugs

Resolve a bounded comma-separated list of Toolshelf slugs.

GET /api/command-index

Search the compact catalog index and active sources.

GET /api/tools/stack-recommendations

Find source-backed relationships for a small set of tools.

Connect an MCP client to https://www.toolshelf.space/mcp using Streamable HTTP. The server supports current MCP discovery and a stateless compatibility path for 2025 clients. It exposes three read-only tools: search_tools, get_tool, and catalog_overview.

Tool results include canonical Toolshelf detail URLs so an agent can cite the page and inspect its evidence links. A missing fact means it has not been verified. It must not be turned into a negative claim about the product.

Supported agent browsers can search the shelf, open a tool, or compare two tools while sharing the page with a person. The registered tools are search_toolshelf, open_toolshelf_tool, and compare_toolshelf_tools.

All three tools are read-only. WebMCP is progressive enhancement, so the site keeps working normally when document.modelContext is unavailable.

These interfaces are public beta and read-only. Cache headers are part of the response and clients should respect them. Do not poll the catalog to detect every change. Use the RSS feed or sitemap for discovery, then fetch only the records you need.

Automated clients can discover the same interfaces through the ARD manifest, RFC 9727 API Catalog, and Agent Skills index. The site root is also available as Markdown.

Toolshelf links back to public evidence, but it is not the official source for current pricing, legal terms, security guarantees, or product availability. Verify those claims on the product's official site before acting on them.