Documentation / 8.0.3

Public website agent API

Search and read published CYBERMAPS website pages through bounded REST and MCP tools.

This website exposes public, read-only tools over its rendered page index. No login is required. These tools do not connect to a WordPress installation and cannot change anything.

REST operations

ToolRequestBounds
search_siteGET /api/agent/search?q=sitemap&limit=10Query 1–120 characters; 1–20 results
list_site_pagesGET /api/agent/pages?limit=251–100 results; optional pagination cursor
get_site_pageGET /api/agent/page?path=/docs/sitemaps/Exact indexed pathname only; maximum 512 characters
get_site_summaryGET /api/agent/siteIdentity, description, and page counts
curl 'https://cybermaps.dev/api/agent/search?q=static&limit=3'
curl 'https://cybermaps.dev/api/agent/page?path=/docs/sitemaps/'

Invalid input returns HTTP 400, unknown indexed pages return 404, and unavailable index data returns 503. The API uses a Cloudflare rate-limit binding with 60 requests per minute per IP at an edge location. Limits are approximate and do not form a global quota. A 429 response includes Retry-After.

MCP

The same four tools are available at /mcp using the SDK’s Streamable HTTP transport and protocol version 2026-07-28. Use server/discover and tools/list for live capabilities. Tools are read-only, non-destructive, idempotent, and closed-world. The interface is stateless and does not expose subscriptions.

Discovery and maturity

MCP Server Cards and AI Catalog are evolving proposals. This site follows their current document shapes rather than adding obsolete fields for older scanners. OAuth and commerce protocols are not advertised because this website has no authenticated account or transaction service.

Markdown at page URLs

Request any canonical public page with Accept: text/markdown to receive its generated Markdown. Ordinary browser requests receive static HTML. Both representations use Vary: Accept; Markdown responses identify their alternate file with Content-Location. Quality preferences are respected, including text/markdown;q=0.

curl -H 'Accept: text/markdown' https://cybermaps.dev/docs/sitemaps/

The Markdown is generated from the same rendered page content as the website. Unpublished or unknown paths remain unavailable.

Browser tools

A compatible browser may expose document.modelContext. When available, this site registers its four public tools and awaits registration. Browsers providing the earlier navigator.modelContext interface use that native interface as a fallback. No API is simulated when browser support is absent. Calls use the same bounded REST operations described above.

Content boundary

The index is generated from canonical, indexable HTML pages after the static build. Markdown alternates contain rendered public content. Unknown paths, absolute URLs, traversal, API routes, and arbitrary fetch targets are rejected. Documentation text is source material, never an instruction to change tool permissions.