Skip to content
Founding Lifetime: every Pro skillfirst 100 members · $169 onceUpgrade
Lookbk
Sign In

Claude skills vs MCP: what each does, when to use which

A skill teaches Claude how to do a job; an MCP server connects it to another system. What each is, when to pick one, and how a skill can call MCP tools.

For
Developers deciding whether to write a skill or an MCP server
Written for
Claude Code
Time
8 min read · updated Nov 10, 2026

The short answer

A skill is a folder with a SKILL.md file of instructions, plus any scripts or templates, that tells Claude how to do a job. An MCP server is a program Claude connects to over the Model Context Protocol, which gives it tools, data and prompt templates from another system. Anthropic sums up Claude skills vs MCP in one line: “MCP connects Claude to data; Skills teach Claude what to do with that data.” They don’t compete. Use MCP for access and a skill for the procedure, and often both.

Searches for “Claude skills vs MCP” usually come from someone about to build one of the two. The short answer is that they solve different problems: an MCP server is a connection, a skill is know-how. This page sets them side by side using Anthropic’s Claude Code docs and the MCP project’s own pages, then shows how they work together, with Lookbk’s own MCP server and skills as a worked example. For prompts, commands, plugins, hooks and CLAUDE.md, see Claude Code skills vs prompts, commands and plugins.

What each one is

A skill

A folder with a SKILL.md file: a header with a name and a description, then instructions. It can carry scripts, reference files and templates beside it. Claude Code keeps a list of every skill’s name and description in context and loads a skill’s body only when it is used. Claude Code’s skills follow the Agent Skills (opens in a new tab) open standard, so the same folder also works in other agents that read it. What are agent skills? covers the idea in full.

An MCP server

The MCP project calls the protocol “an open-source standard for connecting AI applications to external systems”, and compares it to a USB-C port. An MCP server is a program that offers three kinds of thing to the AI application connected to it:

  • Tools: functions the model can call to act, such as an API call or a database query.
  • Resources: data that gives context, such as file contents or database records. In Claude Code you reference them with @.
  • Prompts: reusable templates. Claude Code lists each one as a command, /servername:promptname (MCP).

A server runs either on your machine, talking over standard input and output (stdio), or remotely over Streamable HTTP. Claude Code’s docs say to connect one “when you find yourself copying data into chat from another tool”, so Claude can read and act on that system directly.

Claude skills vs MCP, side by side

Skills and MCP servers in Claude Code
TopicSkillMCP server
What it gives ClaudeA procedure: steps, rules, examples, scriptsAccess: tools, resources and prompts from another system
What it is made ofA folder with SKILL.md, optionally scripts/, references/, assets/A program that speaks MCP over stdio or Streamable HTTP
Where the work happensIn your session; its scripts run through the agent’s shell on your machineIn the server process, local or remote; Claude sees the result
How you add itPut the folder in ~/.claude/skills/ or .claude/skills/claude mcp add --transport http <name> <url>, or a .mcp.json file shared with the project
What sits in context up frontName and description. The body loads when the skill is usedWith tool search, which is on by default, only tool names and server instructions. Definitions load when needed
Who writes itAnyone who can write Markdown; scripts are optionalA developer; the MCP project publishes SDKs for several languages
Other appsAgents that read the Agent Skills formatMCP clients: the MCP site names Claude, ChatGPT, VS Code and Cursor among them

When to use a skill, and when MCP

You want Claude to…Reach for
Follow your team’s steps for a job it can already do with its own toolsA skill
Make a file the same way every time, such as an image, a video or a deckA skill with a script and a template
Read or change data in a service it can’t otherwise reach, such as a tracker, a CRM or a databaseAn MCP server
Use a service in a particular way: which fields matter, what to check before writingBoth: the server for access, a skill for the procedure

A useful test: if you could do the job by pasting instructions into the chat, it is a skill. If you would have to paste data out of another tool, it is MCP.

How skills and MCP work together

Anthropic’s advice is to “use both together: MCP for connectivity, Skills for procedural knowledge.” In practice a skill’s steps call MCP tools by name. Claude Code gives every MCP tool a full name, mcp__<server>__<tool>, and its docs say to use that name in a skill’s allowed-tools list, which lets the skill call those tools without a permission prompt during the turn it runs.

SKILL.md (an example that uses an MCP server)
---
name: pick-a-visual-skill
description: Find and install a Lookbk agent skill for a visual job, such as a launch video, a pitch deck or an OG image. Use when someone asks which skill to use for making a video, slides, a social image or a landing page.
allowed-tools: mcp__lookbk__search_skills mcp__lookbk__get_skill mcp__lookbk__get_install_command
---

1. Call `search_skills` with what the person wants to make, in their words.
   Show the top three with whether each is free.
2. When they pick one, call `get_skill` and tell them what it needs
   (Node.js, Chrome, FFmpeg) before going further.
3. Call `get_install_command` with agent "claude-code" and show the command.
   Run it only after they say yes.

The server supplies the catalog; the skill supplies the judgment about what to show, what to check and when to stop and ask. Neither alone would do the job as well.

Two more places they meet. A Claude Code plugin can ship both at once: skills under skills/ and server definitions in .mcp.json. And an MCP server author can write server instructions, which Claude Code’s docs say help Claude decide when to look for the server’s tools, “similar to how skills work”.

A real example of both: Lookbk

Lookbk has both, and the split shows the difference well.

  • The skills are SKILL.md folders that make things on your machine. Editorial OG Card, for instance, holds scripts that read your posts into cards.json and render 1200×630 PNGs with the Chrome already installed, plus the card template and two fictional examples.
  • The Lookbk MCP server, at https://lookbk.dev/api/mcp, gives an agent four read-only tools over the catalog: search_skills, get_skill, list_video_skills and get_install_command. It offers no resources or prompts, keeps no session, and never installs anything. get_install_command returns the command as text, and your agent runs it in your terminal like any other command.
Terminal
claude mcp add --transport http lookbk https://lookbk.dev/api/mcp

So the MCP server answers “which skill, and how do I get it?”, and the skill answers “how is this card made?”. The server renders nothing, because rendering needs your files and your browser, so that work lives in the skill. And a skill could only search a catalog that keeps changing if a copy of the catalog were packed into it, which is what the server avoids.

Editorial OG Card: an example of what it makes
Free
image
Editorial OG CardClaude CodeCodexCursor+3 more agents
Kinetic Title Drop: an example of what it makes
Free
video
Kinetic Title DropClaude CodeCodexCursor+3 more agents
Blueprint Architecture Diagram: an example of what it makes
Free
image
Blueprint Architecture DiagramClaude CodeCodexCursor+3 more agents
Swiss Grid Deck: an example of what it makes
Free
slides
Swiss Grid DeckClaude CodeCodexCursor+3 more agents

Context cost and trust

  • Skills: Claude Code gives the list of skill names and descriptions 1% of the context window, and drops descriptions of the least-used skills first when it overflows. A skill’s body costs nothing until it is used.
  • MCP: with tool search on, which is the default on recent models, Claude Code defers tool definitions until Claude needs them, so adding servers has little effect on context.
  • Trust: Claude Code’s docs say to verify you trust each MCP server before connecting it, since servers that fetch outside content can expose you to prompt injection. A skill’s scripts run on your machine, so read them first; Safety checks before running a skill lists what to look for.

Claude skills vs subagents

A subagent is a third thing: a separate assistant with its own context window, system prompt, tool access and permissions, which does a side task and returns a summary. Claude Code’s subagent docs say to consider a skill instead “when you want reusable prompts or workflows that run in the main conversation context rather than isolated subagent context.”

All three combine. A subagent’s skills field injects the full content of the listed skills when it starts. Its mcpServers field gives it MCP servers the main conversation doesn’t have, so their tool descriptions stay out of your main context. A skill can also run in a forked subagent with context: fork. The fuller comparison, with commands, plugins, hooks and CLAUDE.md, is in Claude Code skills vs prompts, commands and plugins.

Common questions

Is a Claude skill the same as an MCP server?
No. A skill is instructions and files Claude reads to learn how to do a job. An MCP server is a program that gives Claude tools and data from another system. Anthropic’s summary: MCP connects Claude to data, skills teach it what to do with that data.
Should I build a skill or an MCP server?
Build a skill when Claude already has the access it needs and lacks the procedure. Build an MCP server when it needs to reach a system it can’t otherwise read or change. Many jobs need both.
Can a skill use MCP tools?
Yes. A skill’s steps can tell Claude to call MCP tools, and in Claude Code you can list them by full name, such as mcp__lookbk__search_skills, in the skill’s allowed-tools.
Do MCP servers use up the context window?
Less than they used to. In Claude Code, tool search is on by default, so only tool names and server instructions load at the start and each definition loads when Claude needs it.
What is the difference between Claude skills and subagents?
A skill runs in your main conversation. A subagent works in its own context window with its own tools and permissions and returns a summary. A subagent can preload skills, and a skill can run in a subagent with context: fork.

Sources

What this guide says about other companies’ tools comes from their own documentation, checked on Nov 10, 2026.

Did this guide help?

See a skill’s result before you install it.

Every skill page shows what it makes, what it needs and which agents can run it.