@shipit-dev/mcp

MCP (Model Context Protocol) server for Shipit. Exposes the public Shipit API as MCP tools so AI agents (Claude Desktop, Claude Code, Cursor, Codex, etc.) can read and manage projects, issues, and releases.

Configure

The server needs an API key from your Shipit account. Set it via the SHIPIT_API_KEY env var (and optionally SHIPIT_BASE_URL, defaults to https://api.shipit.dev).

Use with Claude Desktop / Claude Code

Add to your MCP config (~/Library/Application Support/Claude/claude_desktop_config.json for Claude Desktop, or .claude/settings.json for Claude Code):

{
  "mcpServers": {
    "shipit": {
      "command": "npx",
      "args": ["-y", "@shipit-dev/mcp"],
      "env": {
        "SHIPIT_API_KEY": "sk_..."
      }
    }
  }
}

Use with Cursor

In ~/.cursor/mcp.json:

{
  "mcpServers": {
    "shipit": {
      "command": "npx",
      "args": ["-y", "@shipit-dev/mcp"],
      "env": { "SHIPIT_API_KEY": "sk_..." }
    }
  }
}

Tools

| Tool | Description | | ---------------- | ---------------------------------------------------------------------------- | | list_projects | List all projects accessible with the current API key. | | get_project | Fetch a single project by id. | | list_issues | List issues in a project, optionally filtered by status. | | get_issue | Fetch a single issue by id. | | create_issue | Create a new issue (inserted at the top of the list). | | update_issue | Update an existing issue (partial fields). | | delete_issue | Delete an issue by id. | | list_releases | List releases for a project (most recent first). | | get_release | Fetch a release by id, including its issues. | | create_release | Create a release; attaches all done issues at the current project version. |

Dev

pnpm install
pnpm dev        # rebuild on change
pnpm typecheck

To test the server manually over stdio:

SHIPIT_API_KEY=sk_... pnpm start