API Catalog
RFC 9727 linkset document that advertises the public site API, MCP and A2A resources.
/.well-known/api-catalogAgent Resources
The Heym landing page publishes machine-readable discovery endpoints, Markdown negotiation for the homepage, a lightweight MCP endpoint, an A2A agent, Content Signals inrobots.txt, and an agent-skills index.
RFC 9727 linkset document that advertises the public site API, MCP and A2A resources.
/.well-known/api-catalogMachine-readable OpenAPI description for the public site API.
/site-api/openapi.jsonSEP-1649-style MCP discovery document for the site MCP endpoint.
/.well-known/mcp/server-card.jsonLive JSON-RPC 2.0 MCP endpoint (POST). Streamable HTTP transport, no auth required — call tools/list, then tools/call for site summary, search, templates, changelog, and blog lookup.
/mcpA2A 1.0 agent card for the Heym Site Agent, with its JSON-RPC interface and skills.
/.well-known/agent-card.jsonLive A2A 1.0 JSON-RPC endpoint (POST), open to every agent. Send SendMessage with a text part to search the site, or a data part to call one skill.
/a2aAgentic Resource Discovery manifest listing the MCP server card, the A2A agent card, the OpenAPI description and the site skills, each with sample queries for registries.
/.well-known/ard.jsonAgent Skills Discovery RFC v0.2.0 index for site-specific skill artifacts.
/.well-known/agent-skills/index.jsonCompact plain-text summary of Heym for LLMs and crawlers.
/llms.txt
Requests to the homepage that includeAccept: text/markdownreceive a markdown response withContent-Type: text/markdownand anx-markdown-tokensestimate header.
curl https://heym.run/ \
-H "Accept: text/markdown"The site exposes a lightweight MCP endpoint at/mcp for read-only site discovery, and registers browser-side WebMCP tools on page load for navigation and section discovery.
The site is also an A2A 1.0 agent, the Heym Site Agent. Its agent card is at/.well-known/agent-card.jsonand it answers JSON-RPC at/a2a, with the same skills as the MCP endpoint and open to every agent.
curl https://heym.run/.well-known/agent-card.json
curl https://heym.run/a2a \
-H "Content-Type: application/json" \
-H "A2A-Version: 1.0" \
-d '{"jsonrpc":"2.0","id":1,"method":"SendMessage","params":{"message":{"messageId":"1","role":"ROLE_USER","parts":[{"text":"human in the loop"}]}}}'The site publishesContent-Signaldirectives in/robots.txtwith the current policy:
ai-train=yes, search=yes, ai-input=yes