> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getskillmd.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP server

> Let your AI agent generate and fetch skills on its own over the Model Context Protocol.

The skillmd **MCP server** exposes generation and retrieval as tools any MCP-aware agent
can call — so Claude Code, Cursor, Claude Desktop, and Windsurf can build their own
context without leaving the editor.

## Install

Most clients run the server on demand with `npx`:

```bash theme={null}
npx -y @getskillmd/mcp
```

You rarely run this yourself — you point your client's MCP config at it.

## Configure your client

<CodeGroup>
  ```json Claude Code (.mcp.json) theme={null}
  {
    "mcpServers": {
      "skillmd": {
        "command": "npx",
        "args": ["-y", "@getskillmd/mcp"]
      }
    }
  }
  ```

  ```json Cursor (~/.cursor/mcp.json) theme={null}
  {
    "mcpServers": {
      "skillmd": {
        "command": "npx",
        "args": ["-y", "@getskillmd/mcp"]
      }
    }
  }
  ```

  ```json Claude Desktop theme={null}
  {
    "mcpServers": {
      "skillmd": {
        "command": "npx",
        "args": ["-y", "@getskillmd/mcp"]
      }
    }
  }
  ```

  ```json Windsurf theme={null}
  {
    "mcpServers": {
      "skillmd": {
        "command": "npx",
        "args": ["-y", "@getskillmd/mcp"]
      }
    }
  }
  ```
</CodeGroup>

<Steps>
  <Step title="Add the config">
    Paste the snippet into your client's MCP configuration.
  </Step>

  <Step title="Restart the client">
    The `skillmd` tools appear in the available tool list.
  </Step>

  <Step title="Ask in natural language">
    *"Generate a skill for the Linear API and use it to draft an integration."*
  </Step>
</Steps>

## Available tools

| Tool                   | What it does                                   |
| ---------------------- | ---------------------------------------------- |
| `generate_skill`       | Generate a new `skill.md` from a URL           |
| `get_skill`            | Fetch the full content of an existing skill    |
| `list_skills`          | List available skills                          |
| `get_skill_screenshot` | Get a screenshot captured for a skill's source |
| `get_skill_asset`      | Retrieve an asset extracted during generation  |
| `verify_design`        | Check an implementation against a design skill |
| `find_inspiration`     | Surface related skills and references          |

<Tip>
  Pair `generate_skill` with `verify_design` to build UI from a design skill and then
  check your implementation against it — all inside the agent loop.
</Tip>

<Card title="Use with Claude Code" icon="terminal" href="/docs/guides/claude-code">
  A focused walkthrough for Claude Code.
</Card>