Skip to main content

What is the manifest?

The WebMCP manifest is a JSON file published at /.well-known/webmcp.json on every OpenHermit-enabled website. It’s the machine-readable equivalent of a phone book — it tells AI agents exactly what your website can do and how to do it. AI agents (and any HTTP client) can fetch it directly:

Manifest structure


How agents find the manifest

OpenHermit makes your manifest discoverable in four ways: 1. Standard path/.well-known/webmcp.json (the canonical location any agent can check) 2. Meta tag — injected into every page’s <head>:
3. Link tag — also in <head>:
4. Response header — on every page response:

View your manifest

You can view your manifest anytime from the website detail page in the dashboard, or directly at:

Disabled actions

Only actions marked as Active in your dashboard appear in the manifest. Disabled actions are hidden from agents entirely. Use this to temporarily remove an action without deleting it.

The agent_instructions field

The site.agent_instructions string is a plain-text summary generated automatically from your active actions. Agents that read this first get a high-level understanding of what’s available before parsing individual actions. You can see and customise this in the website detail page (coming soon).