MCP Server
SkillForge uses the official Python MCP SDK with protocol-safe stdio transport.
Client Configuration
{
"mcpServers": {
"skillforge": {
"command": "skillforge",
"args": ["serve-mcp"],
"env": {
"SKILLFORGE_REGISTRY_PATH": ".skillforge"
}
}
}
}
If SKILLFORGE_REGISTRY_PATH is omitted, it defaults to .skillforge in the current working directory.
Packaged built-in skills remain available as a fallback. Local entries take precedence for duplicate names.
Exposed API
Resources
skill://{name}: Reads a validatedSKILL.mddocument.
Tools
search_skills(query: str, limit: int = 50): Search names and descriptions across local and built-in registries.get_skill(name: str): Returns the completeSKILL.mdcontent (bounded to 25,000 characters).get_skill_resource(name: str, resource_path: str): Reads a bundled progressive-disclosure file (such asreferences/mechanics.mdorscripts/run.py) from a skill package on demand.validate_skill(content: str): Validates frontmatter and schema without disk writes.audit_skill(content: str): Audits raw skill content for prompt injections, zero-width unicode obfuscation, and dangerous shell patterns.
Protocol messages strictly use stdout; diagnostics and server logs stream to stderr.