Publish a server card for your MCP server

How to do it

Serve the card at your MCP address plus /server-card, as application/mcp-server-card+json, and list it in your AI catalog. Give it $schema, a namespaced name, version, description and remotes. Server cards are an MCP extension (SEP-2127), accepted in August 2026. Its reference code still lives in an experimental repository. Label every tool with hints that match what it does, as Label every tool with hints that match what it does says. Add outputSchema to tools that return structuredContent. Clients treat these hints as untrusted, so enforce every limit on the server too. If the server answers in plain JSON, also serve clients that send only Accept: application/json. Some SDKs refuse them by default, and simple agents send nothing else. Pick an SDK as Use the Model Context Protocol to give agents your tools describes. The other side, connecting your own agent to tools, is in allow only reviewed tools.

Examples

JSON example

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json",
  "name": "com.example/bookings",
  "version": "1.2.0",
  "description": "Check free slots and book a call with Example Co.",
  "websiteUrl": "https://example.com",
  "remotes": [
    { "type": "streamable-http", "url": "https://example.com/mcp", "supportedProtocolVersions": ["2026-07-28", "2025-11-25"] }
  ]
}

JSON example 2

{
  "name": "list_slots",
  "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false }
}

How to check

The card validates against its JSON schema. An MCP inspector connects and lists every tool. A tools/list POST with only Accept: application/json gets the tool list.

Sources

• MCP specification (Tools)
• SEP-2127 (MCP Server Cards)

Related rules

• AGT-20 Offer a dry run for every change in Agents as users
• AGT-36 Label every tool with hints that match what it does in Agents as users
• STK-89 Use the Model Context Protocol to give agents your tools in Software choices
• AIF-73 Connect product agents only to tools and servers on a reviewed list in AI features