{
  "id": "mcp-builder",
  "handle": "mcp-builder",
  "canonicalUrl": "https://bestskillsforclaude.com/en/skills/mcp-builder",
  "language": "en",
  "alternates": {
    "en": "https://bestskillsforclaude.com/en/skills/mcp-builder",
    "es": "https://bestskillsforclaude.com/es/skills/mcp-builder",
    "pt-BR": "https://bestskillsforclaude.com/pt-br/skills/mcp-builder",
    "ja": "https://bestskillsforclaude.com/ja/skills/mcp-builder"
  },
  "category": {
    "id": "extend-claude",
    "name": "Extend Claude"
  },
  "publisher": {
    "name": "Anthropic",
    "url": "https://github.com/anthropics"
  },
  "source": "https://github.com/anthropics/skills/tree/main/skills/mcp-builder",
  "documentation": null,
  "licenseAsStated": "Apache 2.0",
  "runtime": "Claude apps and Claude Code",
  "lastReviewed": "2026-08-05",
  "headline": "When should you build an MCP server instead of a skill?",
  "summary": "When the agent needs to do something, not to know something.",
  "verdict": "The mcp-builder skill helps you design and implement Model Context Protocol servers, which is how an agent gets real capabilities such as querying your database or calling your internal API. Choose a server when the agent needs to act on a system, and a skill when it needs to follow a procedure.",
  "bestFor": "Exposing internal systems, APIs and data sources to agents in a controlled way.",
  "skipIf": "What you need is procedural guidance, which is a skill and far cheaper to maintain.",
  "keyTakeaways": [
    "Tool design is the whole game. A poorly named tool is an unused tool.",
    "Fewer, well scoped tools beat many overlapping ones.",
    "Error messages are part of the interface, because the agent reads them and decides what to do next.",
    "Servers grant capability, and capability needs authorisation boundaries."
  ],
  "quickStart": [
    "Install it from anthropics/skills under Apache 2.0.",
    "Design the tool surface first: few tools, clear names, obvious arguments.",
    "Test with the vaguest realistic request, because that is what exposes bad tool boundaries."
  ],
  "sections": [
    {
      "heading": "What it changes in practice",
      "paragraphs": [
        "The difficulty in MCP work is not the protocol, it is the interface design. An agent picks tools from names and descriptions, so a tool called process that takes an options object will be misused constantly.",
        "Building with explicit guidance keeps the surface small and legible, which is what makes the difference between a server the agent uses correctly and one it avoids or misapplies."
      ]
    },
    {
      "heading": "Where it disappoints",
      "paragraphs": [
        "It does not decide your security model. What the agent may read, write and delete is a decision that belongs to you and needs enforcing on the server side.",
        "Protocol details also move. Check the current specification rather than assuming the skill's snapshot is up to date."
      ]
    }
  ],
  "faq": [
    {
      "question": "Skill or MCP server?",
      "answer": "Skill for procedure and conventions. Server for capability, meaning access to a system the agent cannot otherwise reach."
    },
    {
      "question": "What is the most common design mistake?",
      "answer": "Too many overlapping tools with vague names, which makes selection unreliable."
    },
    {
      "question": "Do error messages matter?",
      "answer": "Yes. The agent reads them and chooses its next step, so treat them as part of the interface."
    }
  ],
  "sources": [
    {
      "label": "anthropics/skills on GitHub",
      "url": "https://github.com/anthropics/skills",
      "kind": "repository"
    },
    {
      "label": "anthropics/skills, mcp-builder skill directory",
      "url": "https://github.com/anthropics/skills/tree/main/skills/mcp-builder",
      "kind": "documentation"
    }
  ],
  "machineReadable": {
    "markdown": "https://bestskillsforclaude.com/en/skills/mcp-builder/content.md",
    "json": "https://bestskillsforclaude.com/en/skills/mcp-builder/skill.json"
  },
  "disclosure": "Editorial desk review based on the publisher's own repository. Not a security audit, a benchmark or a guarantee of maintenance."
}