SnippKit MCP Server Integration
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.mdbundles 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.
- Navigate to Developer Settings (
/settings/developer). - Click Generate New API Key and copy your
sk_live_...key. - 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 includingSKILL.mdguidelines.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