Documentation · Install guide

Install in seconds.

LoopSkill works two ways: as an MCP server your agent connects to, or as a plain Markdown meta-skill any agent can read. Free skills install with no API key. The MCP server itself requires an API key for every call, including free-tier lookups — see the note below.

Fastest · one paste

Just tell your agent

Copy this into any AI agent (Claude Code, Cursor, Hermes, Codex, OpenClaw…). It fetches the LoopSkill meta-skill and wires everything up — no config files on your side. Signed in? Your library generates this phrase with your API key already in it.

Install the loopskill skill from https://app.loopskill.io/skill and use the API key YOUR_KEY_FROM_LIBRARY as LOOPSKILL_API_KEY.

No key yet? Free skills install with no key at all — tell your agent “Install the loopskill skill from https://app.loopskill.io/skill” and start with the free catalog.

Recommended · MCP server (StreamableHTTP)

Connect your agent in one config block

Cursor, Claude Desktop, Cline, Continue.dev, Zed — every MCP-aware client wires up the same way. Your agent gets loopskill_search, loopskill_install, and loopskill_recall as tools it can call mid-conversation.

MCP server requires an API key for all operations — including free-tier skill lookups. If you want a truly keyless path, use the meta-skill or raw REST paths below instead.

Claude Desktop / Cursor / Cline

{
  "mcpServers": {
    "loopskill": {
      "url": "https://app.loopskill.io/api/mcp/http/",
      "headers": { "x-api-key": "rec_live_…" }
    }
  }
}

Get your key from your library — free signup gives you a free-tier key immediately.

Client only supports a local stdio process, not a raw StreamableHTTP URL? Run uvx loopskill-mcp instead — a published PyPI bridge that proxies to the same hosted endpoint. See MCP setup for the config block.

Full MCP setup (Continue.dev, Zed, custom clients) →

Alternative · Meta-skill (Markdown file)

For Claude Code, Codex, Hermes, OpenClaw

Any agent that can read files and call HTTP can use LoopSkill. Drop the meta-skill into your skills directory and tell your agent to follow it.

Claude Code

mkdir -p ~/.claude/skills/loopskill
curl -sL https://app.loopskill.io/skill -o ~/.claude/skills/loopskill/SKILL.md

Hermes / Codex / OpenClaw

mkdir -p ~/.hermes/skills/loopskill  # or ~/.codex/skills, ~/.openclaw/skills
curl -sL https://app.loopskill.io/skill -o ~/.hermes/skills/loopskill/SKILL.md

Then in any session ask: "read the loopskill skill and follow it. List free skills." Your agent will hit the public catalog endpoints — no key needed.

For scripts · Raw HTTP

curl works too

Browse free skills (no auth)

curl -sS "https://app.loopskill.io/api/skills/search?tier=free&page_size=50"

Install a free skill (no auth)

curl -sS "https://app.loopskill.io/api/skills/install?slug=super-memory"

Install with a key (bundle-scoped or private skills)

curl -sS -H "x-api-key: $LOOPSKILL_API_KEY" \
  "https://app.loopskill.io/api/skills/install?slug=super-memory"

The catalog carries no paid-tier skills today, so no free skill actually needs this header — pass a key when installing from a private or bundle-scoped catalog instead.

Verify the install

curl https://app.loopskill.io/api/healthz

Should return {"status":"ok"}. If your agent connected via MCP, ask it: "call loopskill_search with query=test and show me the top 3 results."