SnippKit MCP Server Integration

@snippkit/mcp-server
•v...•... Tools
The official SnippKit Model Context Protocol (MCP) Server (@snippkit/mcp-server) connects AI coding agents—including Cursor, Google Antigravity, Claude Code, and Windsurf—directly to your procedural skills registry and private code vault.
Instead of relying on outdated training cutoffs or manual copy-pasting, AI agents equipped with SnippKit can search, pull, and execute verified design guidelines, architectural rules (SKILL.md), and reusable code snippets in real-time.

Overview

The Model Context Protocol (MCP) is an open industry standard that enables large language models (LLMs) to securely interact with external tools, repositories, and context providers over a lightweight stdio JSON-RPC transport.
With @snippkit/mcp-server, your AI coding companion gains:
  • Procedural Skills Access: Dynamically pull authoritative SKILL.md bundles containing domain rules, tokens, and templates without context bloat.
  • Two-Way Skill Creation: Instruct your agent to refine an architectural pattern and save it directly to SnippKit as a reusable skill.
  • Private Snippet Vault: Search and retrieve encrypted team code snippets on demand.
  • Shell Playbooks: Query validated multi-step DevOps and terminal command sequences.
  • Zero-Setup Stdio Transport: No background ports, webhooks, or open daemons required. Pure Node.js stdio communication.
Interactive Service Showcase
Want to see live simulations of agent tool invocations? Explore the animated MCP Showcase Page (/services/mcp).

Installation & Quick Start

The server requires Node.js 18.0.0+ and runs seamlessly via npx without needing global pre-installation:
BASH
npx -y @snippkit/mcp-server

Stdio Transport Protocol

When launched by an AI agent client, SnippKit MCP Server starts in standard I/O mode:
  • stdin / stdout: Exclusively reserved for JSON-RPC 2.0 messages exchanged between the client editor and the server.
  • stderr: Reserved for human diagnostic logs, connection banners, and masked authentication warnings.

Authentication & API Keys

While public skills can be discovered and read without authentication, full access to your private encrypted skills, private snippets, and the ability to save/publish skills requires your SnippKit API Key.
  1. Navigate to Developer Settings (/settings/developer).
  2. Click Generate New API Key and copy your sk_live_... key.
  3. Pass your API key into your client's environment variables under SNIPPKIT_API_KEY.
Key Masking & Security
Your API key is never printed or logged to stdout. When initializing, the server prints a safely masked preview (e.g. sk_live_••••••••••••3a1f) to stderr only.

Client Configuration Guides

Select your preferred AI editor or agent below to configure the MCP server:

1. Cursor Composer

Open or create your Cursor MCP configuration file:
  • Global: ~/.cursor/mcp.json
  • Project Specific: .cursor/mcp.json (inside your project root)
JSON
{
  "mcpServers": {
    "snippkit": {
      "command": "npx",
      "args": [
        "-y",
        "@snippkit/mcp-server"
      ],
      "env": {
        "SNIPPKIT_API_KEY": "YOUR_SNIPPKIT_API_KEY"
      }
    }
  }
}

2. Claude Desktop

Add SnippKit to your Claude Desktop configuration file:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
JSON
{
  "mcpServers": {
    "snippkit": {
      "command": "npx",
      "args": [
        "-y",
        "@snippkit/mcp-server"
      ],
      "env": {
        "SNIPPKIT_API_KEY": "YOUR_SNIPPKIT_API_KEY"
      }
    }
  }
}

3. Claude Code CLI

Claude Code supports direct 1-command registration via terminal:
BASH
claude mcp add snippkit npx -y @snippkit/mcp-server
To include your private API key:
BASH
claude mcp add snippkit -e SNIPPKIT_API_KEY=YOUR_SNIPPKIT_API_KEY npx -y @snippkit/mcp-server

4. Google Antigravity

Add the server definition inside your Antigravity MCP directory (~/.gemini/antigravity/mcp/snippkit.json):
JSON
{
  "snippkit": {
    "command": "npx",
    "args": [
      "-y",
      "@snippkit/mcp-server"
    ],
    "env": {
      "SNIPPKIT_API_KEY": "YOUR_SNIPPKIT_API_KEY"
    }
  }
}

5. Windsurf Cascade

Add to ~/.codeium/windsurf/mcp_config.json:
JSON
{
  "mcpServers": {
    "snippkit": {
      "command": "npx",
      "args": [
        "-y",
        "@snippkit/mcp-server"
      ],
      "env": {
        "SNIPPKIT_API_KEY": "YOUR_SNIPPKIT_API_KEY"
      }
    }
  }
}

Available MCP Tools Reference

@snippkit/mcp-server registers 9 specialized tools for AI agents:

1. snippkit_search_skills

  • Purpose: Search the public registry or your private skills catalog by keyword.
  • Parameters:
    • query (string, required): Keyword, theme name, or capability (e.g. "theme", "docker", "auth").
    • limit (number, optional): Maximum items to return (default: 10).
  • Example Agent Usage:
    JSON
    {
      "query": "tailwind design system"
    }

2. snippkit_get_skill

  • Purpose: Retrieve full procedural instructions, YAML frontmatter, rules, and file paths for any skill.
  • Parameters:
    • slug (string, required): Skill slug or @username/slug (e.g. "red-white-theme-palette").
  • Example Agent Usage:
    JSON
    {
      "slug": "red-white-theme-palette"
    }

3. snippkit_save_skill

  • Purpose: Author and publish a new agent skill directly from the agent conversation.
  • Parameters:
    • title (string, required): Clear title for the skill.
    • content (string, required): Markdown content including SKILL.md guidelines.
    • slug (string, optional): Custom URL slug.
    • is_public (boolean, optional, default: true): Public marketplace vs private encrypted.
    • tags (array of strings, optional): Indexing tags.
    • compatibility (array of strings, optional): Supported platforms (antigravity, cursor, claude-code, windsurf).
    • version (string, optional, default: "1.0.0"): Semver string.

4. snippkit_search_snippets

  • Purpose: Search your code vault for reusable functions, algorithms, and configs.
  • Parameters:
    • query (string, required): Search query.
    • language (string, optional): Filter by language (e.g. "python", "typescript").

5. snippkit_get_snippet

  • Purpose: Pull the raw source code of a snippet by slug or ID.
  • Parameters:
    • id (string, required): Slug or unique identifier.

6. snippkit_save_snippet

  • Purpose: Save a new code snippet directly to your SnippKit library.
  • Parameters:
    • title (string, required): Snippet title.
    • code (string, required): Source code.
    • language (string, required): Language identifier.
    • is_public (boolean, optional): Visibility.

7. snippkit_search_commands

  • Purpose: Query shell playbooks and terminal command sets.
  • Parameters:
    • query (string, required): Command description or search string.

8. snippkit_get_command

  • Purpose: Fetch executable command sequences and step-by-step instructions.
  • Parameters:
    • id (string, required): Playbook slug or UUID.

9. snippkit_save_command

  • Purpose: Persist a shell script, terminal runbook, or multi-step command sequence directly into your SnippKit library.
  • Parameters:
    • title (string, required): Descriptive title for the command runbook.
    • commands (array of strings or string, required): The command string or array of sequential shell commands.
    • language (string, optional, default: "bash"): Shell language ("bash", "sh", "zsh", "powershell").
    • tags (array of strings, optional): Tags for searching and categorization.
    • is_public (boolean, optional, default: false): Public vs encrypted private runbook.
    • slug (string, optional): Custom URL slug.
  • Example Agent Usage:
    JSON
    {
      "title": "Docker Clean & Prune",
      "commands": [
        "docker stop $(docker ps -a -q)",
        "docker system prune -a --volumes -f"
      ],
      "tags": [
        "docker",
        "devops",
        "cleanup"
      ]
    }

Natural Language Agent Prompts

Once configured, you can talk to your agent naturally in your editor. Here are prompt examples that automatically trigger SnippKit MCP tools:
  • "Check SnippKit for skills related to Next.js Tailwind themes and apply them to my project."
  • "Fetch the procedural guidelines for @unhuman/red-white-theme-palette from SnippKit and build a cardless modal."
  • "Search my SnippKit private snippets for our standard RSA JWT verify function."
  • "Take the component architecture we just designed and publish it as a reusable skill named 'minimal-pricing-table' to my SnippKit account."

Troubleshooting

1. Cannot find module '@snippkit/mcp-server'

Ensure you have npx working and Node.js v18 or newer installed:
BASH
node --version
npx --version

2. Agent Cannot See Private Skills

Verify that your SNIPPKIT_API_KEY is specified in your client config JSON and that the key is active in your Developer Settings.

3. Restarting the MCP Connection

After updating your configuration file (mcp.json or claude_desktop_config.json), completely restart your editor or terminal to reload the stdio process.
Copyright © 2026 SnippKitUp to date