Documentation / 7.3.4

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

Browser tools

A compatible browser may expose document.modelContext. When available, this site registers its four public tools. This experimental WebMCP bridge adds no authority and is not needed for search or navigation.

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.