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)
| File | Size | Uploaded | |
|---|---|---|---|
| agentskills_modelcontextprotocol-0.1.0.tar.gz | 4.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|