MCP Server API
The MCP (Model Context Protocol) Server provides AI assistant integration for Bootspring, enabling AI tools like Claude to interact with your project through standardized tools and resources.
Overview#
Bootspring's MCP server exposes:
- Tools: Actions that can be performed (invoking agents, running quality checks, etc.)
- Resources: Read-only data about your project (context, todos, workflows)
Starting the MCP Server#
Claude Desktop Configuration#
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
Available Tools#
bootspring_assist#
The primary "magic" tool for natural language assistance.
bootspring_context#
Manage project context and configuration.
bootspring_agent#
Work with specialized AI agents.
bootspring_todo#
Manage project todos.
bootspring_skill#
Search and retrieve code patterns.
bootspring_quality#
Run quality gates.
bootspring_orchestrator#
Intelligent agent coordination and workflow management.
bootspring_loop#
Autonomous development loop management.
bootspring_memory#
Git-based memory and learnings.
bootspring_generate#
Generate or regenerate CLAUDE.md context.
bootspring_dashboard#
Launch real-time dashboard.
bootspring_capabilities#
Get available Bootspring capabilities.
bootspring_telemetry#
Manage telemetry settings.
bootspring_plugin#
Manage plugins.
bootspring_seed#
Project seeding and scaffolding.
bootspring_mvp#
MVP import and analysis.
bootspring_prd#
PRD ingestion and todo creation.
Available Resources#
bootspring://context/project#
Current project context and configuration.
bootspring://context/claude.md#
Generated AI context file content.
bootspring://context/todo.md#
Project todo list.
bootspring://agents/list#
Available specialized agents.
bootspring://workflow/status#
Current workflow status.
bootspring://skills/catalog#
Available skills catalog.
bootspring://memory/recent#
Recent decisions and learning insights.
Tool Response Format#
All tools return responses in the MCP content format:
Success Response#
Error Response#
Dependencies#
The MCP server requires:
These are included when installing Bootspring globally:
Error Handling#
Missing Dependencies#
Bootspring MCP Server - Startup Failed
Missing dependencies:
- @modelcontextprotocol/sdk is not installed
To fix, run:
npm install @modelcontextprotocol/sdk zod
Unknown Tool#
Tool Execution Error#
Best Practices#
- Use assist for natural language: The
bootspring_assisttool handles natural language and routes to appropriate tools - Check capabilities first: Use
bootspring_capabilitiesto see what's available - Combine tools: Use tool chaining for complex operations
- Handle errors gracefully: Always check for
isErrorin responses - Use resources for read-only data: Prefer resources over tools for fetching project state