rulebook-mcp
MCP server integration for programmatic task and skill management. Use when managing tasks via MCP protocol, enabling/disabling skills programmatically, or integrating Rulebook with AI assistants through Model Context Protocol.
When & Why to Use This Skill
The Rulebook MCP server provides a robust framework for programmatic task and skill management within AI assistant environments. It enables developers and AI agents to dynamically enable, disable, and search for skills while managing complex task lifecycles via the Model Context Protocol (MCP). By providing a standardized interface for skill orchestration, it ensures AI agents operate with the precise tools and context required for specific workflows, enhancing the reliability and control of agentic systems.
Use Cases
- Dynamic Skill Allocation: Automatically enabling or disabling specific AI capabilities (skills) based on the current project context, security protocols, or user permissions.
- Automated Task Lifecycle Management: Empowering AI agents to programmatically create, update, validate, and archive project tasks within a structured rulebook framework to maintain project hygiene.
- IDE Integration for Agentic Workflows: Integrating Rulebook's management functions into MCP-compatible IDEs like Cursor, allowing the AI to manage its own toolset and task list during software development.
- Skill Discovery and Validation: Using programmatic search and validation functions to ensure that the AI assistant has access to the correct version of a skill before execution.
| name | rulebook-mcp |
|---|---|
| description | MCP server integration for programmatic task and skill management. Use when managing tasks via MCP protocol, enabling/disabling skills programmatically, or integrating Rulebook with AI assistants through Model Context Protocol. |
| version | "1.0.0" |
| category | core |
| author | "HiveLLM" |
| tags | ["mcp", "model-context-protocol", "server", "integration"] |
| dependencies | [] |
| conflicts | [] |
Rulebook MCP Server
Setup
rulebook mcp init
Starting the Server
rulebook-mcp
Task Management Functions
// Create task
await mcp.rulebook_task_create({ taskId: "my-task" });
// List tasks
await mcp.rulebook_task_list({});
// Show task
await mcp.rulebook_task_show({ taskId: "my-task" });
// Update task file
await mcp.rulebook_task_update({
taskId: "my-task",
file: "tasks.md",
content: "## Tasks\n- [ ] Item 1"
});
// Validate task
await mcp.rulebook_task_validate({ taskId: "my-task" });
// Archive task
await mcp.rulebook_task_archive({ taskId: "my-task" });
// Delete task
await mcp.rulebook_task_delete({ taskId: "my-task" });
Skill Management Functions
// List skills
await mcp.rulebook_skill_list({});
// Show skill
await mcp.rulebook_skill_show({ skillId: "languages/typescript" });
// Enable skill
await mcp.rulebook_skill_enable({ skillId: "languages/typescript" });
// Disable skill
await mcp.rulebook_skill_disable({ skillId: "languages/typescript" });
// Search skills
await mcp.rulebook_skill_search({ query: "typescript" });
// Validate skills
await mcp.rulebook_skill_validate({});
MCP Configuration
For Cursor (.cursor/mcp.json):
{
"mcpServers": {
"rulebook": {
"command": "rulebook-mcp",
"args": [],
"env": {}
}
}
}