rulebook-mcp

hivellm's avatarfrom hivellm

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.

⭐5stars🔀0forks📁View on GitHub🕐Updated Dec 10, 2025

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.
namerulebook-mcp
descriptionMCP 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"
categorycore
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": {}
    }
  }
}