@quikrun/mcp

A Model Context Protocol server for QuikRun. It lets an AI agent (Claude Desktop, Cursor, and other MCP clients) manage your QuikRun snippets — list, read, create, edit, run, deploy, duplicate, and delete — by wrapping the QuikRun REST API.

Requirements

• Node.js 20 or newer

• A QuikRun account and API token

Getting a token

1. Sign in at quik.run.

2. Go to Dashboard → Tokens.

3. Mint a new token. It looks like quik_<keyId>_<secret>.

4. Copy it — you will paste it into your MCP client config as QUIKRUN_TOKEN.

Claude Desktop setup

Add this to your claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "quikrun": {
      "command": "npx",
      "args": ["-y", "@quikrun/mcp"],
      "env": {
        "QUIKRUN_TOKEN": "quik_yourKeyId_yourSecret"
      }
    }
  }
}

Restart Claude Desktop. The QuikRun tools appear in the tools menu.

Optional: self-hosted API

Point the server at a different QuikRun API host with QUIKRUN_API_URL (defaults to https://api.quik.run):

"env": {
  "QUIKRUN_TOKEN": "quik_yourKeyId_yourSecret",
  "QUIKRUN_API_URL": "https://api.quik.run"
}

Tools

Development

npm install
npm run typecheck   # type-check without emitting
npm run build       # compile to dist/
npm run dev         # run from source with tsx

License

MIT