agent-skills-mcp - Load Agent Skills for your agents

[!WARNING] This Python implementation is deprecated. Please use the Rust implementation instead: https://github.com/DiscreteTom/agent-skills-mcp-rs

Usage

Full CLI Usage

<details>

<summary><code>uvx agent-skills-mcp --help</code></summary>

 Usage: agent-skills-mcp [OPTIONS]

 Agent Skills MCP - Load Agent Skills for your agents

╭─ Options ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --skill-folder  TEXT                  Path to folder containing skill markdown files [env var: SKILL_FOLDER] [default: skills] │
│ --mode          [tool|system_prompt]  Operating mode [env var: MODE] [default: tool]                                           │
│ --version                             Show version and exit                                                                    │
│ --help                                Show this message and exit.                                                              │
╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

</details>

Setup

First, put your skills in ~/skills, e.g.

git clone https://github.com/anthropics/skills.git ~/skills

The server recursively searches for SKILL.md files and follows symlinks, allowing flexible skill organization.

Then, add this to your MCP client configuration:

{
  "mcpServers": {
    "skills": {
      "command": "uvx",
      "args": ["agent-skills-mcp"],
      "env": {
        "SKILL_FOLDER": "~/skills"
      }
    }
  }
}

Modes

• system_prompt: Include skill information in MCP instructions (recommended if your agent regards MCP server instructions)
• tool: Register skills as MCP tools (fallback mode since many agents ignore MCP server instructions)

CHANGELOG