Skip to main content

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

Release files for agentskills-modelcontextprotocol 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agentskills-modelcontextprotocol 0.1.0
File Size Uploaded
agentskills_modelcontextprotocol-0.1.0.tar.gz 4.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for agentskills-modelcontextprotocol 0.1.0
File Interpreter ABI Platform
agentskills_modelcontextprotocol-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 9.5 kB

Release files / agentskills_modelcontextprotocol-0.1.0.tar.gz

Download URL agentskills_modelcontextprotocol-0.1.0.tar.gz
Size 4.1 kB
Tags Source
SHA-256 checksum
How to use checksums
32f4b59f5291e188359dcea55e05aaf879c2f0efdc0f5985f55704a7c7c5cb3a
BLAKE2b-256 checksum
How to use checksums
4437325a1a82253afe33460e7791720d636901cb4a878f22172869732c2402be
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.3.1 CPython/3.13.9 Windows/11

Release files / agentskills_modelcontextprotocol-0.1.0-py3-none-any.whl

Download URL agentskills_modelcontextprotocol-0.1.0-py3-none-any.whl
Size 5.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
87c5afc46c2321b05b3c18652a20ca54911b8513af53c85c4343c7beb839c2ef
BLAKE2b-256 checksum
How to use checksums
9c4acaa673b48ccdaa5e44cb1928ea8dbd9e6601dd1a74f89072de4bde9f6b31
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.3.1 CPython/3.13.9 Windows/11

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page