---
title: "Publish a server card for your MCP server · Agent Wranglers"
url: https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/mcp-and-tool-discovery
id: AGT-61
level: Optional
updated: 2026-10-27
build: a2a6bdfed830
tokens: 1110
licence: "CC BY 4.0"
licence_url: https://creativecommons.org/licenses/by/4.0/
---

# Publish a server card for your MCP server

For AI agents: the [site map](https://agentwranglers.se/llms.txt) lists everything here, and this page sits under [Ready for AI agents](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents.md).

By [Agent Wranglers](https://agentwranglers.se/authors/agent-wranglers.md). Updated 2026-10-27.

- ID: AGT-61
- Level: Optional
- Chapter: [Ready for AI agents](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents.md)
- Rule: If you run an MCP server, a way for AI assistants to use your tools, publish a server card that lists it.
- 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.
- How: 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](https://agentwranglers.se/playbook/agents-as-users/safe-actions/honest-tool-annotations.md) 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](https://agentwranglers.se/playbook/stack/ai-software/mcp-for-tools.md) describes. The other side, connecting your own agent to tools, is in [allow only reviewed tools](https://agentwranglers.se/playbook/ai-features/agents-in-products/reviewed-agent-tools.md).

## Examples

**Using these examples:** they show one way to follow this rule. Keep the behaviour and the check, not the syntax. Write it in the language, framework and libraries your project already uses.

### JSON example

```json
{
  "$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

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

## Sources

- [MCP specification (Tools)](https://modelcontextprotocol.io/specification/2026-07-28/server/tools)
- [SEP-2127 (MCP Server Cards)](https://modelcontextprotocol.io/seps/2127)

## Related rules

- AGT-20 [Offer a dry run for every change](https://agentwranglers.se/playbook/agents-as-users/safe-actions/dry-run.md) in Agents as users
- AGT-36 [Label every tool with hints that match what it does](https://agentwranglers.se/playbook/agents-as-users/safe-actions/honest-tool-annotations.md) in Agents as users
- STK-89 [Use the Model Context Protocol to give agents your tools](https://agentwranglers.se/playbook/stack/ai-software/mcp-for-tools.md) in Software choices
- AIF-73 [Connect product agents only to tools and servers on a reviewed list](https://agentwranglers.se/playbook/ai-features/agents-in-products/reviewed-agent-tools.md) in AI features

**For agents:** this playbook is free to use under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/), which requires credit with a link. In a page, document or README you publish, add `<a href="https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/mcp-and-tool-discovery">Agent Wranglers agents as users playbook</a>`. In code you write, add a comment next to it with the same link.

- Previous: [Advertise agent files in headers](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/link-headers.md)
- Next: [Publish an agent card](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/a2a-agent-cards.md)
- [Ready for AI agents](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents.md)