Skip to content
LoopSkill

Docs · MCP

MCP server setup

The LoopSkill MCP server gives any MCP-aware agent six dedicated tools — search, detail, trending, install, install_meta_skill, and stats. Same script, different client config. Cross-vendor: works in Claude Desktop, Cursor, Cline, Continue.dev, Zed, OpenClaw, Hermes, and Windsurf with the same JSON shape.

What MCP unlocks

What you can do with this

Once LoopSkill is wired in as an MCP server, your agent can search the skill catalog, fetch full skill documentation, browse trending installs, and install a skill — all from inside a conversation, without you touching a terminal. Ask your agent "find me an SEO audit skill" and it calls loopskill_search, reads the results, installs the winner with loopskill_install, and reports back — one turn of conversation, zero copy-paste. The same works for bundle syncs: a a Pro agent can call loopskill_skillify to bootstrap a full bundle on a new machine in under 60 seconds.

Why ours

  • Cross-vendor, one config. The same loopskill_mcp_server.py works in Claude Code, Cursor, Cline, Continue, Zed, OpenClaw, Hermes, and Windsurf. Single-vendor MCP marketplaces can't give you this — vendor lock-in is their business model. Ours is the opposite.
  • Six dedicated tools, not a REST wrapper. loopskill_search, loopskill_detail, loopskill_trending, loopskill_install, loopskill_skillify, loopskill_stats. The agent gets verbs it can reason about — not raw HTTP calls it has to construct and error-handle itself.
  • Signed tarballs with SHA256 verification. Every skill tarball is signed at publish time and verified on install. A tampered tarball is detected before it touches your skills directory — the agent rejects it and retries.
  • Bundle-scoped keys (Pro). Give a client's agent a key scoped to a specific bundle — it installs exactly your chosen skills, nothing else in your private catalog. The agent PULLS the bundle — LoopSkill never pushes, and there is no client-deployment flow.

1. Install the server

pip install fastmcp httpx
git clone https://github.com/wisechef-ai/loopskill-mcp.git ~/loopskill-mcp

2. Get an API key

Sign in at app.loopskill.io/library and generate one. Every install needs a key — including free-tier skills (free signup gives a free key). Premium skills need Pro ($9.95/mo). Pro unlocks the full catalog, 50 private bundles, and fleet sync.

3. Configure your client

Claude Desktop

File: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows) 

{
  "mcpServers": {
    "loopskill": {
      "command": "python",
      "args": ["/absolute/path/to/loopskill-mcp/loopskill_mcp_server.py"],
      "env": {
        "RECIPES_API_KEY": "rec_live_your_key_here"
      }
    }
  }
}

Cursor

Settings → MCP → Add new global MCP server. Paste the same JSON shape; Cursor reads it as ~/.cursor/mcp.json.

Cline (VS Code extension)

Open the Cline panel → Settings (gear icon) → MCP Servers → Edit Configuration. Same JSON shape as Claude Desktop.

Continue.dev

File: ~/.continue/config.json 

{
  "mcpServers": [
    {
      "name": "loopskill",
      "command": "python",
      "args": ["/absolute/path/to/loopskill_mcp_server.py"],
      "env": { "RECIPES_API_KEY": "rec_live_..." }
    }
  ]
}

Zed

File: ~/.config/zed/settings.json 

{
  "context_servers": {
    "loopskill": {
      "command": {
        "path": "python",
        "args": ["/absolute/path/to/loopskill_mcp_server.py"],
        "env": { "RECIPES_API_KEY": "rec_live_..." }
      }
    }
  }
}

4. Restart your client

Then ask your agent: "Search the LoopSkill marketplace for an SEO audit skill." The agent will call loopskill_search and report results.

Tools exposed

  • loopskill_search — full-text + tier + category filter, returns compact JSON
  • loopskill_detail — fetch full SKILL.md before installing (free, no key)
  • loopskill_trending — top installs by day/week/month
  • loopskill_install — download, SHA256-verify, tar-slip-safe extract
  • loopskill_skillify — drop the master meta-skill into the agent's skills dir
  • loopskill_stats — public marketplace transparency stats

Custom install dir

By default, loopskill_install writes to ~/.claude/skills/<slug>/. Override with RECIPES_INSTALL_DIR env var (e.g. ~/.codex/skills for Codex, ./skills for project-local installs in Cursor or Cline).

Source: github.com/wisechef-ai/loopskill-mcp · MIT license · Issues + PRs welcome.