> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openhermit.com/llms.txt
> Use this file to discover all available pages before exploring further.
# The WebMCP Manifest
> What AI agents see when they discover your website.
## 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:
```bash theme={null}
curl https://yourwebsite.com/.well-known/webmcp.json
```
***
## Manifest structure
```json theme={null}
{
"webmcp_version": "1.0",
"site": {
"name": "Acme Corp",
"domain": "acme.com",
"description": "We build the best widgets in Switzerland.",
"agent_instructions": "This website has 2 agent-ready actions. Use contact_form to reach the team or book_consultation to schedule a call."
},
"actions": [
{
"name": "Contact Form",
"type": "contact_form",
"tool_name": "contact_form",
"description": "Send a message to the Acme Corp team",
"selector": "#contact-form",
"page_url": "https://acme.com/contact",
"enabled": true,
"before_prompt": "Please have the customer's name, email, and question ready.",
"success_prompt": "Message sent. The team responds within 24 hours.",
"failure_prompt": "Try emailing hello@acme.com directly.",
"next_action": {
"url": "https://calendly.com/acme/30min",
"label": "Book a meeting"
},
"fields": [
{ "name": "name", "type": "text", "required": true },
{ "name": "email", "type": "email", "required": true },
{ "name": "message", "type": "textarea", "required": true }
]
}
]
}
```
***
## 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 ``:
```html theme={null}
```
**3. Link tag** — also in ``:
```html theme={null}
```
**4. Response header** — on every page response:
```
X-WebMCP: enabled
```
***
## View your manifest
You can view your manifest anytime from the website detail page in the dashboard, or directly at:
```
https://openhermit.com/api/manifest?key=YOUR_API_KEY
```
***
## 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).