Skip to main content
skill CX Codex

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

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

What 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.json with 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-code

2Manually: put the files in place

~/.claude/skills/mcp-server-card/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/mcp-server-card/

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

Similar skills

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

From the same set46

The whole set →
agent-ready-acp The agent-ready-acp skill guides the publication of an ACP discovery document so AI agents can find an Agentic Commerce Protocol implementation. CX Codex +1 ★ 141repo stars agent-ready-robots-txt The agent-ready-robots-txt skill publishes a standards-compliant robots.txt at your site root per RFC 9309. Use it when agents need to control bot access and reference your sitemap. CX Codex +1 ★ 141repo stars agent-ready-api-catalog agent-ready-api-catalog implements an RFC 9727 API catalog so autonomous agents can discover your endpoints and OpenAPI specifications. CX Codex +1 ★ 141repo stars agent-ready-content-signals The agent-ready-content-signals skill adds Content Signals to robots.txt, letting you set preferences for AI training, search, and AI input. CX Codex +1 ★ 141repo stars agent-ready-a2a-agent-card agent-ready-a2a-agent-card generates an A2A Agent Card file for agent-to-agent discovery. Useful when setting up agent endpoints on Cloudflare Workers. CX Codex +1 ★ 141repo stars agent-ready-web-bot-auth The agent-ready-web-bot-auth skill guides Web Bot Auth setup so receiving sites can verify bot or agent requests. Use it when your site needs to identify its signed outbound traffic. CX Codex +1 ★ 141repo stars 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

Project sponsors

Companies that keep this analytics open