← Back to Documentation

MCP Tools Reference

All tools exposed by the SkillSea MCP server for AI assistants.

Neo4j Database

get_neo4j_schemaread-only

Returns the graph schema including node labels, properties, relationships, and their types. Uses APOC's apoc.meta.schema() procedure.

ParameterTypeDefaultDescription
sample_sizeint1000Number of nodes to sample for schema inference
read_neo4j_cypherread-only

Execute a read-only Cypher query. Only MATCH statements are allowed. Results are returned as JSON.

ParameterTypeDefaultDescription
querystringCypher query (MATCH only)
paramsobject{}Query parameters
write_neo4j_cypherwrite

Execute a write Cypher query (CREATE, MERGE, SET, DELETE). Disabled when server runs with --read-only.

ParameterTypeDefaultDescription
querystringCypher write query
paramsobject{}Query parameters

Skill Management

sync_skills

Search Neo4j for skills matching a natural language query and sync them to the local .claude/skills/skillsea/ folder. Removes stale skills not matching the current query.

ParameterTypeDefaultDescription
querystringNatural language query to find relevant skills
limitint25Maximum number of skills to sync
search_skills

Preview skills matching a query without syncing them. Use this to see what would be synced before committing.

ParameterTypeDefaultDescription
querystringNatural language query
limitint10Maximum results
list_active_skills

List all currently synced skills in the skills folder, with their names and last sync time.

clear_skills

Remove all synced skills from the skills folder. Protected skills (with .protected marker) are kept.

protect_skill

Mark a skill as protected so it won't be removed during sync or clear. Creates a .protected marker file.

ParameterTypeDefaultDescription
skill_namestringName of the skill folder to protect
unprotect_skill

Remove protection from a skill, allowing it to be removed during sync or clear.

ParameterTypeDefaultDescription
skill_namestringName of the skill folder to unprotect
list_protected_skills

List all protected skills that won't be removed during sync or clear operations.

Semantic Search

index_skills

Generate embeddings for skills in Neo4j to enable semantic search. Creates vector representations using the all-MiniLM-L6-v2 model.

ParameterTypeDefaultDescription
limitint100Max skills to index (-1 for all)
forceboolfalseRe-index skills that already have embeddings
semantic_search

Search skills using vector similarity. Finds skills by meaning, not just keywords. Requires embeddings to be indexed first.

ParameterTypeDefaultDescription
querystringNatural language query
limitint10Maximum results
warmup_semantic

Pre-load the embedding model into memory for faster subsequent searches. Reports model status and dimensions.

Hooks

install_hook

Install the UserPromptSubmit hook for automatic skill syncing and SessionStart hook for update notifications. Restart Claude Code after installing.

ParameterTypeDefaultDescription
scopestringlocal'local' for project or 'global' for all projects
project_rootstringcwdProject root directory
uninstall_hook

Remove the UserPromptSubmit hook to disable automatic skill syncing. Restart Claude Code after.

ParameterTypeDefaultDescription
scopestringlocal'local' or 'global'
project_rootstringcwdProject root directory

Search Strategy

set_search_strategy

Change the search strategy used by the automatic skill sync hook. Takes effect on the next prompt.

ParameterTypeDefaultDescription
strategystring'smart', 'semantic', or 'fulltext'
scopestringlocal'local' or 'global'
project_rootstringcwdProject root directory
get_search_strategy

Get the current search strategy configured for the sync hook.

ParameterTypeDefaultDescription
scopestringlocal'local' or 'global'
project_rootstringcwdProject root directory

Security

scan_skill

Run a security scan on a specific skill. Uses Static (YARA/YAML pattern detection) and Behavioral (AST dataflow) analyzers. Returns findings with severity, rule ID, description, and remediation.

ParameterTypeDefaultDescription
skill_namestringName of the skill to scan

License

license_activate

Activate a license key to unlock premium features. Shows tier and unlocked features on success.

ParameterTypeDefaultDescription
license_keystringYour license key
license_status

Show current license status, tier, machine fingerprint, and available features.

license_deactivate

Deactivate the current license and release the machine slot. Reverts to trial mode.

license_features

List all features available on the current license tier.

Updates

check_updatesread-only

Check if a newer version of the SkillSea binary is available. Returns current version, latest version, and install instructions.

Related