npm package: @limeadelabs/launchpad-mcp
Description: LaunchPad MCP server for Claude Code — AI-native project management integration
Latest version: 1.2.6

# @limeadelabs/launchpad-mcp

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

## Quick Start

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

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

```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

```bash
npm install
npm run build
npm test
```

## License

MIT