mcp-server-sites

One Model Context Protocol server for the whole jueewo ventures family. AI assistants connect once and search across jueewo.ventures, aipokit.com, and yawninghero.com — structured passages with links, not scraped HTML guesses.

Live at mcp-sites.yawninghero.com. Part of Agent Experience Optimization (AXO) — the agent-era complement to SEO. We built and dogfooded it before writing about it; see From SEO to AXO.

What it does

Each family site publishes an agent index at build time (/api/agent-index.json). This Bun service fetches those indexes on a schedule, merges them, and exposes four MCP tools:

Tool	Purpose
search	Keyword, semantic, or hybrid search across one site or the whole family
list_sites	Indexed origins with document counts
get_page	Full text of one page or article by URL
get_related	Topically nearest entries — powers in-site “you might also be interested” blocks

The server also serves POST /chat (SSE-streamed, tool-using answers for the on-site chat widget) and GET /api/related.json (precomputed neighbours consumed at Astro build time).

Try it

Point any MCP client at https://mcp-sites.yawninghero.com/mcp and ask something that spans sites — e.g. “Search for BPMN agents and summarise the connection.” The journal post reproduces a real multi-site synthesis from that workflow.

Stack

• Runtime: Bun
• Embeddings: paraphrase-multilingual-MiniLM-L12-v2 (local, cached on disk)
• Owned by: YawningHero (family web/agent infrastructure)

Source repo: mcp-server-sites in the AppKask workspace beside the family websites.