Awesome Agent Skills MCP Server

Overview

Awesome Agent Skills MCP Server is an npm-distributed stdio MCP server that provides access to curated AI agent skills from the VoltAgent Awesome Agent Skills repository. It serves skills from organizations and projects such as Anthropic, Vercel, Trail of Bits, Hugging Face, Stripe, Expo, n8n, Sanity, Neon, Remotion, and others.

The server syncs skill metadata/content from a configured Git repository, caches parsed skills locally, optionally loads local skills, and exposes MCP tools for listing, reading, invoking, and refreshing skills.

Installation and transport

Recommended quick start:

npx awesome-agent-skills-mcp

MCP client configuration for Claude Desktop and similar clients:

{
  "mcpServers": {
    "awesome-agent-skills": {
      "command": "npx",
      "args": ["awesome-agent-skills-mcp"]
    }
  }
}

VS Code / GitHub Copilot uses the same command and args in .vscode/mcp.json. OpenCode documents a local command array of ["npx", "awesome-agent-skills-mcp"]. The implementation uses stdio transport; no hosted remote HTTP/SSE endpoint is documented.

Configuration

Environment variables:

• SKILLS_REPO_URL: skills repository URL. Default: https://github.com/VoltAgent/awesome-agent-skills.git.
• SKILLS_REPO_BRANCH: branch to sync. Default: main.
• SKILLS_CACHE_DIR: cache directory path. Default: .cache.
• SKILLS_SYNC_INTERVAL: auto-sync interval in minutes; 0 disables auto-sync. Default: 60.
• SKILLS_LOCAL_PATH: optional local skills path loaded in addition to repository skills.
• LOG_LEVEL: logging level, one of debug, info, warn, error. Default: info.

Tools

• list_skills: list available skills, with optional text filter and source filter (all, repository, or local).
• get_skill: get detailed information and markdown content for a skill by skill_id.
• invoke_skill: invoke a skill by skill_id, optionally substituting parameters into the skill content.
• refresh_skills: manually refresh the skills cache from the configured repository.

Requirements and limitations

Requires Node.js >= 20.0.0 and npm or yarn. Runtime sync requires network access to the configured Git repository and a local cache directory that the process can create/write. The default repository is VoltAgent/awesome-agent-skills. The source repository metadata inspected on June 27, 2026 describes that collection as 1000+ agent skills, while this MCP server README describes 100+ curated skills; the draft records both as source evidence. If repository sync fails, the implementation logs a warning and uses cached skills if available. Skill content availability depends on the upstream repository layout and GitHub/raw content fetches used by the parser.