MCP server setup · SkillMD

Connect by URL

Paste this URL into any client that supports remote MCP servers. Nothing to install. The local server below also lints skills and installs them straight to disk.

https://api.skillmd.com/mcp

Or run it locallyNode 18 or later

Claude Code

Codex

VS Code

Claude Desktop

Cursor

Windsurf

Run this once.

claude mcp add skillmd -- npx -y skillmds@latest

Adds it for every project. Use --scope project to add it to this repo only.

Run this once.

codex mcp add skillmds -- npx -y skillmds@latest

Run this once.

code --add-mcp '{"name":"skillmds","command":"npx","args":["-y","skillmds@latest"]}'

Also in the Command Palette: MCP: Add Server.

Add this to the config file, then restart Claude Desktop.

{
  "mcpServers": {
    "skillmds": {
      "command": "npx",
      "args": ["-y", "skillmds@latest"]
    }
  }
}

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Add this to the config file, then restart Cursor.

{
  "mcpServers": {
    "skillmds": {
      "command": "npx",
      "args": ["-y", "skillmds@latest"]
    }
  }
}

macOS: ~/.cursor/mcp.json
Windows: %USERPROFILE%\.cursor\mcp.json
Linux: ~/.cursor/mcp.json

Add this to the config file, then restart Windsurf.

{
  "mcpServers": {
    "skillmds": {
      "command": "npx",
      "args": ["-y", "skillmds@latest"]
    }
  }
}

macOS: ~/.codeium/windsurf/mcp_config.json
Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json
Linux: ~/.codeium/windsurf/mcp_config.json

Any other client

The server is a plain stdio process, so any MCP client can run it. Point yours at npx -y skillmds@latest, or paste this into whatever config file it reads:

{
  "mcpServers": {
    "skillmds": {
      "command": "npx",
      "args": ["-y", "skillmds@latest"]
    }
  }
}

It identifies itself as skillmd during the handshake. Pass nothing else: the same package also ships the skillmd CLI, and any argument routes there instead of starting the server.

SKILLMD_TOKEN: Optional. Only skillmd_list_saved needs a signed-in user; everything else works unauthenticated.
SKILLMD_API: Point at a different registry. Defaults to https://api.skillmd.com.

Check it works

Ask the agent for a skill by task. It should come back with registry results.

Find me a skill for reviewing pull requests

Tool reference, token auth and self-hosting: MCP docs. Prefer a terminal? The CLI installs skills without an MCP client.