mcp-skills-as-context

an mcp server that searches playbooks.com and fetches full skill file contents. gives your coding agent access to thousands of structured skill files — instructions, templates, reference materials — as rich context for any task. no api tokens required.

what it does

two tools:

search-skills

searches playbooks.com by keyword. returns a compact tsv list of skill names, ids, stars, and descriptions. supports filtering by language, sort order, and official status. use the returned ids with get-skill-details to fetch the actual files.

parameters:

• query (required) — search keyword
• limit (optional, 1-500, default 50) — max results
• language (optional) — filter by language (e.g. "Python", "TypeScript")
• sort (optional) — sort order (e.g. "stars")
• official (optional) — filter to official/verified skills only

output format: tab-separated values (tsv) — one line per skill, minimal token overhead.

Skills for "playwright" (showing 50 of 3 pages)
id	name	stars	official	description
microsoft/playwright/playwright-cli	Playwright CLI	78.0k	yes	browser automation and testing
...

get-skill-details

takes skill ids (in owner/repo/skillId format) and fetches the complete skill contents — SKILL.md plus all reference files. returns concatenated markdown with each file under its own heading.

how it works

• scrapes playbooks.com search pages and parses skill cards from structured html
• extracts SKILL.md content directly from next.js rsc stream data on detail pages
• fetches reference files from raw.githubusercontent.com (public repos, no token needed)
• all pages fetched in parallel for fast multi-page searches
• available as both http server (via mcp-use framework) and stdio transport (via @modelcontextprotocol/sdk)

data source: all skill data comes from playbooks.com and raw.githubusercontent.com. no api tokens required.

two transports

• stdio — runs via npx mcp-skills-as-context. this is the default for local agent integrations.
• http — runs a hono-based server on a configurable port. used for remote deployments.

install

add to your mcp config:

{
  "mcpServers": {
    "skills-as-context": {
      "command": "npx",
      "args": ["-y", "mcp-skills-as-context"]
    }
  }
}

environment variables

license

mit