@limeadelabs/launchpad-mcp

LaunchPad MCP server for Claude Code — manage tasks, pull project context, and track work directly from your coding environment.

Quick Start

# Install via Claude Code CLI
claude mcp add launchpad -- npx @limeadelabs/launchpad-mcp

Or add manually to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "launchpad": {
      "command": "npx",
      "args": ["@limeadelabs/launchpad-mcp"],
      "env": {
        "LAUNCHPAD_API_KEY": "your-api-key",
        "LAUNCHPAD_URL": "https://launchpad.limeadelabs.co"
      }
    }
  }
}

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | LAUNCHPAD_API_KEY | Yes | — | API key from LaunchPad workspace settings | | LAUNCHPAD_URL | No | https://launchpad.limeadelabs.co | LaunchPad instance URL | | LAUNCHPAD_TIMEOUT_MS | No | 10000 | Request timeout in milliseconds |

Tools

| Tool | Description | |------|-------------| | lp_bootstrap | One-call onboarding — workspace, projects, tasks, conventions | | lp_list_projects | List projects with optional stage filter | | lp_get_project | Get project details + agent_instructions | | lp_list_tasks | List tasks with filters (project, status, priority, label, assignee) | | lp_get_task | Get full task context — description, comments, links | | lp_create_task | Create a new task | | lp_update_task | Update task status/fields (enforces workflow transitions) | | lp_claim_task | Claim a task before working on it | | lp_release_task | Release a claimed task | | lp_heartbeat | Keep a claim alive (expires after 30 min without heartbeat) | | lp_add_comment | Post a comment on a task | | lp_log_time | Track time spent on a task | | lp_generate_prompt | Generate a build-ready spec for a task | | lp_list_pages | List spec/doc pages for a project | | lp_get_page | Get a page's full content | | lp_get_workflow | Get valid workflow states and transitions | | lp_context_list | List context entries with optional filters (project, type, search) | | lp_context_get | Fetch a context entry's full content by slug or ID | | lp_context_package | Get assembled context package for a task (org + project entries, specs, comments) | | lp_context_update | Update a context entry's content (requires write access) |

Resources

• launchpad://project/{id}/context — Project instructions, conventions, and page summaries
• launchpad://task/{id}/spec — Full generated task spec
• context://entries — Browse all active context entries
• context://entries/{slug} — Read a specific context entry

Resources vs Tools

Resources are for passive browsing in the Claude Code resource panel. Tools are for active agent invocation during conversation. Both access the same underlying context registry API.

Prompts

• lp_start_task — Guided workflow: find → claim → get spec → start building
• lp_submit_task — Guided workflow: comment → update status → release claim

Example Usage

In Claude Code:

• "List my LaunchPad tasks"
• "Claim task #500 and show me the spec"
• "What's the status of the LaunchPad project?"

Troubleshooting

"LAUNCHPAD_API_KEY environment variable is required" Set your API key in the MCP server config. Get one from LaunchPad workspace settings.

"Invalid LAUNCHPAD_API_KEY" Your API key is expired or incorrect. Generate a new one from LaunchPad.

"Cannot reach LaunchPad" Check your LAUNCHPAD_URL and network connectivity.

"Request timed out" LaunchPad may be slow. Increase LAUNCHPAD_TIMEOUT_MS or try again.

Development

npm install
npm run build
npm test

License

MIT