Skills MCP Reference

Overview

This page covers the Skills MCP tools for direct MCP integration.

Related references: Skill Library, MCP Tools, and Versioning.

publish_skill

Publishes a skill bundle.

Arguments

nametyperequireddescription
filesarray of objects { path: string; content: string }yesBundle files to publish.

Notable behavior

  • Creates a new immutable version.

search_skills

Searches the organization’s skills library.

Arguments

nametyperequireddescription
querystringnoCase-insensitive substring filter on skill names and descriptions.
tagsstring[]noTag filter.

Notable behavior

  • Filters by query and AND-matches tags.

get_skill

Returns a skill bundle.

Arguments

nametyperequireddescription
slugstringyesSkill slug.
versionpositive integernoSpecific skill version.

Notable behavior

  • Returns the latest version when version is omitted.
  • Returns the requested version when version is provided.

install_skill

Returns the host agent’s native install commands for an external marketplace skill.

Arguments

nametyperequireddescription
marketplacestringyesMarketplace id.
agentclaude-code | codexyesHost agent.
slugstringnoSkill slug.
pluginstringnoPlugin name.

Cursor uses the separate local plugin or admin import path described in the installation documentation, not this tool’s native install commands.

Notable behavior

  • Returns the host agent’s native subscribe or install commands for claude-code or codex from a marketplace.
  • The caller must provide either slug or plugin.
  • Returns commands only; it does not return skill files.

list_marketplaces

Lists the organization’s external skill marketplace subscriptions.

Arguments

nametyperequireddescription
None—noThis tool takes no arguments.

Notable behavior

  • Lists the organization’s external skill marketplace subscriptions.

list_skill_versions

Lists published versions for a skill.

Arguments

nametyperequireddescription
slugstringyesSkill slug.

Notable behavior

  • Lists published versions newest first.