Agent Resources

Discovery metadata for agents and automated clients

The Heym landing page publishes machine-readable discovery endpoints, Markdown negotiation for the homepage, a lightweight MCP endpoint, Content Signals inrobots.txt, and an agent-skills index.

API Catalog

RFC 9727 linkset document that advertises the public site API and MCP resources.

/.well-known/api-catalog

OpenAPI

Machine-readable OpenAPI description for the public site API.

/site-api/openapi.json

MCP Server Card

SEP-1649-style MCP discovery document for the site MCP endpoint.

/.well-known/mcp/server-card.json

Agent Skills Index

Agent Skills Discovery RFC v0.2.0 index for site-specific skill artifacts.

/.well-known/agent-skills/index.json

LLMs Summary

Compact plain-text summary of Heym for LLMs and crawlers.

/llms.txt

Markdown negotiation

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"

MCP and WebMCP

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.

MCP tools: site summary, recent blog posts, template search, and blog post lookup
WebMCP tools: route navigation, homepage section jumps, and high-level site overview

robots.txt and Content Signals

The site publishesContent-Signaldirectives in/robots.txtwith the current policy:

ai-train=yes, search=yes, ai-input=yes