`fastmcp.utilities.skills`

Client utilities for discovering and downloading skills from MCP servers.

Functions

`list_skills`

list_skills(client: Client) -> list[SkillSummary]

List all available skills from an MCP server. Discovers skills by finding resources with URIs matching the skill://{name}/SKILL.md pattern. Args:

client: Connected FastMCP client

Returns:

List of SkillSummary objects with name, description, and URI

`get_skill_manifest`

get_skill_manifest(client: Client, skill_name: str) -> SkillManifest

Get the manifest for a specific skill. Args:

client: Connected FastMCP client
skill_name: Name of the skill

Returns:

SkillManifest with file listing

Raises:

ValueError: If manifest cannot be read or parsed

`download_skill`

download_skill(client: Client, skill_name: str, target_dir: str | Path) -> Path

Download a skill and all its files to a local directory. Creates a subdirectory named after the skill containing all files. Args:

client: Connected FastMCP client
skill_name: Name of the skill to download
target_dir: Directory where skill folder will be created
overwrite: If True, overwrite existing skill directory. If False (default), raise FileExistsError if directory exists.

Returns:

Path to the downloaded skill directory

Raises:

ValueError: If skill cannot be found or downloaded
FileExistsError: If skill directory exists and overwrite=False

`sync_skills`

sync_skills(client: Client, target_dir: str | Path) -> list[Path]

Download all available skills from a server. Args:

client: Connected FastMCP client
target_dir: Directory where skill folders will be created
overwrite: If True, overwrite existing files

Returns:

List of paths to downloaded skill directories

Classes

`SkillSummary`

Summary information about a skill available on a server.

`SkillFile`

Information about a file within a skill.

`SkillManifest`

Full manifest of a skill including all files.

fastmcp.apps

fastmcp.experimental