@rac.so/clip-mcp

Model Context Protocol server for clip — an ephemeral URL service. Adds clip_upload, clip_list, clip_get, and clip_delete as native tools in any MCP-speaking LLM client (Claude Desktop, Claude Code, Cursor, Zed, etc.).

This is a thin local stdio server. It just forwards typed tool calls to clip's HTTP API. No remote endpoint, no per-user state.

Install

You need a clip API key. Mint one in 30 seconds via the device flow:

# 1. Ask clip for a code
curl -sX POST https://clip.rac.so/auth/device \
  -H 'Content-Type: application/json' \
  -d '{"agent_label":"claude-desktop"}'
# → { "user_code": "ABCD-EFGH", "verification_uri": "...", ... }

Visit the verification_uri, type the user_code, sign in with GitHub or Google, then poll the token endpoint until you get an access_token. (Full walkthrough: clip.rac.so/api#device-flow.)

Then add this block to your MCP-client config:

Claude Desktop

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

{
  "mcpServers": {
    "clip": {
      "command": "npx",
      "args":    ["-y", "@rac.so/clip-mcp"],
      "env":     { "CLIP_API_KEY": "clip_..." }
    }
  }
}

Restart Claude Desktop. Ask it to "share this snippet with clip" and watch.

Other clients

Any MCP client that runs stdio servers takes the same command + args + env. Adapt to your client's config format.

Tools

| Tool | What it does | |---------------|-----------------------------------------------------------------| | clip_upload | Upload content, return a short URL. Extension-first: set extension (e.g. md, json, png; bin/dat/raw for binary). content_type is an escape hatch for unmapped MIMEs; ttl_minutes sets lifetime. | | clip_list | List your active clips, newest first. | | clip_get | Fetch a clip body by id or URL. | | clip_delete | Delete a clip you own. |

Schemas are self-documenting via the standard MCP tools/list request — your client surfaces them automatically.

Configuration

| Env var | Required | Purpose | |------------------|----------|------------------------------------------| | CLIP_API_KEY | yes | Bearer token (mint via device flow). | | CLIP_BASE_URL | no | Override base URL (default https://clip.rac.so). Useful for self-hosted instances or local dev. |

Develop

npm install
npm run build
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | CLIP_API_KEY=clip_... node dist/index.js

License

MIT.