---
name: site-pages
description: Find and read pages on ace-bl.tech (Ace) as Markdown, via REST or MCP, with no credentials.
version: 2026.09.15
---

# site-pages — Ace

Public, read-only endpoints on https://ace-bl.tech for agents. No registration, no credentials; requests are rate limited per client. Send a descriptive User-Agent and stay under one request per second.

## REST

1. `GET /agent/site.json` — site name, description, sitemap, page count, docs, contact, and links to every discovery document.
2. `GET /agent/search?q=<words>&limit=20` — searches the sitemap for pages whose URL path contains the words. Returns `{"query","count","results":[{"url","score"}]}`.
3. `GET /agent/read?url=<page url on this host>` — returns the page as Markdown when the host negotiates it (`Accept: text/markdown`), otherwise stripped text. Only `https://ace-bl.tech` pages are readable.
4. Any page from the sitemap can also be fetched directly with `Accept: text/markdown`.

## MCP

`POST https://ace-bl.tech/mcp` is an MCP endpoint (Streamable HTTP, JSON-RPC 2.0, no auth). Tools: `site_info`, `search_pages`, `read_page`. Server card: `https://ace-bl.tech/.well-known/mcp/server-card.json`.

## Also on this host

- `/.well-known/api-catalog` — RFC 9727 API catalog.
- `/openapi.json` — OpenAPI 3.1 for the endpoints above.
- `/llms.txt` — human-written summary of the site.
- `/auth.md` — what credentials exist (none for agents) and how to contact the site.