Skip to main content
skill CX Codex

agent-ready-webmcp — Claude Code skill: what it does, how to install

agent-ready-webmcp wires a site's actions into the WebMCP API so browser-based AI agents can find and call them.

Apache-2.0 ★ 141 updated 2026-10-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add fabricioctelles/skills --skill agent-ready-webmcp -a claude-code
Open on GitHub

What agent-ready-webmcp does

The skill walks through calling document.modelContext.registerTool() for each action an agent should reach, such as search, navigation or data lookups. Every tool needs a name, description, a JSON Schema inputSchema, and an execute callback, and the registration call returns a Promise.

Existing HTML forms can skip the JS call entirely: adding toolname and tooldescription attributes to the <form> tag, plus toolparamdescription on its inputs, exposes them declaratively. An AbortController signal passed in the options lets tools be unregistered later. Older Chrome builds put the API on navigator.modelContext instead, so code should check document.modelContext first and fall back if it's missing.

Browsers detect the API only while loading the page, so the registration script has to run on page load. To check the result, send POST https://isitagentready.com/api/scan with {"url": "https://YOUR-SITE.com"} and look for checks.discovery.webMcp.status set to "pass".

What it helps with

  • expose a site's actions to browser-based AI agents
  • register search and navigation tools through WebMCP
  • turn existing HTML forms into declarative agent tools
  • unregister tools with an AbortController signal
  • confirm WebMCP support with the isitagentready.com scanner

Example prompts for the agent

  • Register a search tool with document.modelContext.registerTool
  • Expose this form to agents using toolname and tooldescription attributes
  • Run a scan to check if the site passes the WebMCP discovery check

How to install agent-ready-webmcp

1Skills CLI (Vercel)

npx skills add fabricioctelles/skills --skill agent-ready-webmcp -a claude-code

2Manually: put the files in place

~/.claude/skills/webmcp/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/webmcp/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about agent-ready-webmcp

How do I install agent-ready-webmcp in Claude Code?

Run npx skills add fabricioctelles/skills --skill webmcp -a claude-code; the skill lands in ~/.claude/skills/webmcp/SKILL.md.

What does agent-ready-webmcp do?

It guides exposing a site's key actions to AI agents through the WebMCP API, registering each tool with a schema and an execute function the agent can call.

How do I confirm WebMCP works after setting it up?

Send POST https://isitagentready.com/api/scan with {"url": "https://YOUR-SITE.com"} and check that checks.discovery.webMcp.status returns "pass".

Source text

SKILL.md · Apache-2.0
---
name: agent-ready-webmcp
description: >
  Sub-skill de agent-ready-cloudflare: Implement WebMCP
---
# Implement WebMCP

Expose site tools to AI agents via the browser using the
[WebMCP API](https://webmachinelearning.github.io/webmcp/)
([Chrome blog](https://developer.chrome.com/blog/webmcp-epp),
[declarative API](https://github.com/webmachinelearning/webmcp/blob/main/declarative-api-explainer.md)).

## Requirements

- Call `document.modelContext.registerTool()` for each tool you want to expose; it returns a Promise
- Each tool needs `name`, `description`, `inputSchema` (JSON Schema), and an `execute` callback
- Tools should expose your site's key actions (search, navigation, data retrieval)
- Pass an `AbortController` signal in the options to unregister tools when no longer needed
- For existing HTML forms, add `toolname` and `tooldescription` to the `<form>` and `toolparamdescription` to its inputs to expose them declaratively
- Older Chrome builds expose the API on `navigator.modelContext`; feature-detect `document.modelContext` first and fall back to it if needed
- The API is detected by loading the page in a browser — ensure the script runs on page load

## Validate

```
POST https://isitagentready.com/api/scan
Content-Type: application/json

{"url": "https://YOUR-SITE.com"}
```

Check that `checks.discovery.webMcp.status` is `"pass"`.

© fabricioctelles · Apache-2.0 · fabricioctelles/skills

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set46

The whole set →
agent-ready-agent-skills agent-ready-agent-skills publishes an agent skills discovery index matching the RFC v0.2.0 specification. Useful when exposing local agent tools to external crawlers. CX Codex +1 ★ 141repo stars agent-ready-oauth-protected-resource agent-ready-oauth-protected-resource publishes OAuth Protected Resource Metadata so agents can discover how to authenticate. It fits Cloudflare setups that expose a protected resource. CX Codex +1 ★ 141repo stars agent-ready-link-headers agent-ready-link-headers is a Claude Code skill that adds Link response headers to a site's homepage so AI agents can discover its API and documentation automatically. CX Codex +1 ★ 141repo stars agent-ready-markdown-negotiation agent-ready-markdown-negotiation implements Accept: text/markdown content negotiation so AI agents receive clean Markdown representations instead of raw HTML. CX Codex +1 ★ 141repo stars agent-ready-ai-rules agent-ready-ai-rules is a skill that adds RFC 9309 rules for AI search and training crawlers to robots.txt, controlling page visibility in AI answers and use for model training. CX Codex +1 ★ 141repo stars agent-ready-mpp agent-ready-mpp teaches AI agents to configure Machine Payment Protocol (MPP) discovery in OpenAPI schemas by adding x-payment-info tags to payable endpoints. CX Codex +1 ★ 141repo stars agent-ready-dns-aid The agent-ready-dns-aid skill guides DNS-AID records that let agents locate endpoints through DNS. Use it when publishing SVCB or HTTPS records under _agents. CX Codex +1 ★ 141repo stars agent-ready-personal-agent-protocol agent-ready-personal-agent-protocol publishes Personal Agent Protocol (Poppy) draft 0.1 discovery metadata at /.well-known/poppy.json and validates OAuth issuer binding. CX Codex +1 ★ 141repo stars

Project sponsors

Companies that keep this analytics open