Features

Tools, Resources, and Prompts for managing your code snippets.

Snippets-mcp provides a complete MCP integration for managing code snippets stored as GitHub Gists.

MCP Tools

Five tools for full CRUD operations on your GitHub Gists.

list_snippets

List and search your snippets with powerful filtering.

Parameter	Description
`visibility`	Filter: `all`, `public`, `private`
`language`	Filter by programming language
`search`	Search term in description
`tag`	Filter by hashtag
`limit`	Maximum results (default: 30)
`offset`	Pagination offset

get_snippet

Retrieve full content of a snippet by ID, including all files.

create_snippet

Create new snippets with description, visibility, and multiple files.

update_snippet

Update existing snippets: change description, add/update files, or remove files.

delete_snippet

Permanently delete a snippet (requires confirmation).

MCP Resources

Direct read-only access to snippets via URI patterns.

URI	Description
`snippets://index`	JSON array of all snippet summaries
`snippets://{id}`	Full content of a specific snippet

Resources are cacheable by MCP clients, making them efficient for embedding snippet content in context.

MCP Prompts

Guided workflow templates for common tasks.

save_code

Guides you through saving code as a new snippet:

Suggests appropriate filename based on content
Generates description with relevant hashtags
Asks about visibility preference

Arguments: code (required), language, description

review_snippet

Performs code review on an existing snippet.

Arguments: id (required), focus

Focus options:

all — Comprehensive review
security — Security vulnerabilities
performance — Performance issues
style — Code style and conventions

explain_snippet

Explains what a snippet does at varying levels.

Arguments: id (required), audience

Audience options:

beginner — No prior knowledge assumed
intermediate — Basic programming knowledge
expert — Deep technical dive

Hashtag Tagging

GitHub Gists don’t natively support tags. Snippets-mcp extracts hashtags from descriptions.

Format

API client for GitHub #go #api #http

Rules

Tags start with # followed by a letter
Can contain letters, numbers, underscores, hyphens
Case-insensitive: #Go, #GO, #go are equivalent
Issue references like #123 are ignored

Usage

Filter snippets by tag:

{"tag": "go"}

Security

Token Storage

GitHub tokens can be stored securely in your system keychain:

snippets-mcp --set-credential

The token is validated with GitHub before storage.

Private by Default

New snippets are created as private gists unless explicitly set to public.

No Data Collection

Snippets-mcp communicates only with GitHub’s API. No data is sent elsewhere.

Licensing

Personal & Small Business

Free for:

Personal and educational use
Organizations with less than $1M annual revenue

Includes all features listed above with no restrictions.

Enterprise

For organizations with $1M+ annual revenue:

All features included
Commercial use permitted
Source code access
Priority email support