agent-ready-mcp-server-card — Claude Code skill
agent-ready-mcp-server-card — a skill that publishes an MCP Server Card, a JSON file for agent discovery. Use it when running your own MCP server and want tools like isitagentready.com to find and validate it.
Apache-2.0 ★ 141 updated 2026-10-29
npx skills add fabricioctelles/skills --skill agent-ready-mcp-server-card -a claude-codeWhat agent-ready-mcp-server-card does
The skill implements SEP-1649 by creating an endpoint at /.well-known/mcp/server-card.json. The response contains serverInfo with name and version, a transport endpoint URL (such as /mcp for HTTP), and a list of capabilities—tools, resources, and prompts your server provides.
On Cloudflare, Agents SDK and Workers handle server card support out of the box. Once live, validate your setup by posting to https://isitagentready.com/api/scan with your URL and checking that checks.discovery.mcpServerCard.status returns pass.
What it helps with
- Publish an MCP Server Card on the standard discovery endpoint
- Declare server capabilities (tools, resources, prompts) for agent discovery
- Pass isitagentready.com validation for agent-ready status
- Deploy an MCP server on Cloudflare with discovery support
Example prompts for the agent
- Add the MCP Server Card to my Cloudflare Workers MCP server
- Set up
/.well-known/mcp/server-card.jsonwith my tools and resources - Validate my server against isitagentready.com
How to install agent-ready-mcp-server-card
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-mcp-server-card -a claude-code2Manually: put the files in place
~/.claude/skills/mcp-server-card/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/mcp-server-card/
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-mcp-server-card -a codex2Manually: put the files in place
.agents/skills/mcp-server-card/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-mcp-server-card -a cursor2Manually: put the files in place
.cursor/skills/mcp-server-card/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install fabricioctelles/skills skills/agent-ready-cloudflare/mcp-server-card2Manually: put the files in place
.github/skills/mcp-server-card/SKILL.md1Skills CLI (Vercel)
npx skills add fabricioctelles/skills --skill agent-ready-mcp-server-card -a gemini-cli2Platform CLI
gemini skills install https://github.com/fabricioctelles/skills --path skills/agent-ready-cloudflare/mcp-server-cardManually: put the files in place
.devin/skills/mcp-server-card/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about agent-ready-mcp-server-card
How do I install agent-ready-mcp-server-card in Claude Code?
Run npx skills add fabricioctelles/skills --skill mcp-server-card -a claude-code, then open ~/.claude/skills/mcp-server-card/SKILL.md and follow the setup.
What does agent-ready-mcp-server-card do?
It adds the /.well-known/mcp/server-card.json endpoint to your MCP server, publishing metadata for agent discovery. The card includes server info, transport endpoint, and supported capabilities.
Which platforms does this skill support?
Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and Windsurf (Devin Desktop). Claude.ai has no install option through this method.
Source text
SKILL.md · Apache-2.0
---
name: agent-ready-mcp-server-card
description: >
Sub-skill de agent-ready-cloudflare: Implement MCP Server Card
---
# Implement MCP Server Card
Publish an MCP Server Card for agent discovery per
[SEP-1649](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2127).
## Requirements
- Serve JSON at `/.well-known/mcp/server-card.json` with HTTP 200
- Include `serverInfo` with `name` and `version`
- Include a transport `endpoint` URL (e.g., `/mcp` for Streamable HTTP)
- List `capabilities` (tools, resources, prompts) the server supports
## Cloudflare
[Agents SDK](https://developers.cloudflare.com/agents/) and
[Workers](https://developers.cloudflare.com/workers/) make it straightforward
to build and deploy MCP servers with server card support.
## Validate
```
POST https://isitagentready.com/api/scan
Content-Type: application/json
{"url": "https://YOUR-SITE.com"}
```
Check that `checks.discovery.mcpServerCard.status` is `"pass"`.
© fabricioctelles · Apache-2.0 · fabricioctelles/skills