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