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, an A2A agent, Content Signals inrobots.txt, and an agent-skills index.

API Catalog

RFC 9727 linkset document that advertises the public site API, MCP and A2A 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

MCP Endpoint

Live 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.

/mcp

A2A Agent Card

A2A 1.0 agent card for the Heym Site Agent, with its JSON-RPC interface and skills.

/.well-known/agent-card.json

A2A Endpoint

Live 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.

/a2a

ARD Manifest

Agentic 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.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: detailed site summary, site-wide keyword search across pages, templates, playground demos, blog posts, and docs, plus the release changelog, recent blog posts, template search, and blog post lookup
  • WebMCP tools: route navigation, homepage section jumps, and high-level site overview

A2A

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.

  • Send a text part to search the site, or a data part with a skill name and arguments
  • Each SendMessage gets its answer right away, as a message from the agent
  • Heym itself serves the Heym Agent over A2A on every MCP server, with streaming tasks; see theA2A docs
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"}]}}}'

robots.txt and Content Signals

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

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