agentskills-modelcontextprotocol 0.1.0

MCP server integration for the Agent Skills format — expose skills as MCP tools and resources (https://agentskills.io)

agentskills-modelcontextprotocol

MCP server integration for the Agent Skills SDK — expose a skill registry as an MCP server.

Creates a Model Context Protocol server from a SkillRegistry, exposing skills as MCP tools and resources. Works with any MCP-compatible client (Claude Desktop, VS Code, custom clients, etc.).

Installation

pip install agentskills-modelcontextprotocol

Requires Python 3.12+. Installs agentskills-core and mcp as dependencies.

Usage

from pathlib import Path
from agentskills_core import SkillRegistry
from agentskills_fs import LocalFileSystemSkillProvider
from agentskills_mcp import create_mcp_server

provider = LocalFileSystemSkillProvider(Path("./skills"))
registry = SkillRegistry()
await registry.register("incident-response", provider)

server = create_mcp_server(registry, name="My Skills Server")
server.run()  # stdio by default

For HTTP transport:

server.run(transport="streamable-http")

Tools

The server exposes tools that let the LLM agent access skill content:

Tool	Parameters	Description
get_skill_metadata	skill_id	Read frontmatter (name, description, etc.)
get_skill_body	skill_id	Load full skill instructions
get_skill_reference	skill_id, name	Read a reference document
get_skill_script	skill_id, name	Read a script
get_skill_asset	skill_id, name	Read an asset

Resources

The server provides resources for system-prompt context:

URI	Description
skills://catalog/xml	XML catalog of all registered skills
skills://catalog/markdown	Markdown catalog of all registered skills
skills://tools-usage-instructions	Workflow instructions for using the tools

The MCP client reads these resources and injects them into the system prompt, giving the agent both what skills exist and how to interact with them.

API

create_mcp_server(registry, *, name, instructions=None) -> FastMCP

Parameter	Type	Description
registry	SkillRegistry	The registry whose skills are exposed
name	str	Display name for the MCP server (required)
instructions	str | None	Optional server-level instructions sent to clients

Returns a configured FastMCP instance ready for server.run().

License

MIT