# imqueue MCP server

> Enables AI coding agents to search @imqueue documentation, scaffold typed services and clients, and manage services via the imq CLI.

- Repository: https://github.com/imqueue/mcp
- Page: https://hostedmcp.org/servers/imqueue/mcp
- Transport: stdio, remote
- Stars: 1
- License: GPL-3.0
- Latest version: 3.7.9

## Install

### Claude Code

```sh
claude mcp add mcp -- npx -y @imqueue/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@imqueue/mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@imqueue/mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@imqueue/mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@imqueue/mcp"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add mcp -- npx -y @imqueue/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp]
command = "npx"
args = ["-y", "@imqueue/mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user mcp npx -- -y @imqueue/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@imqueue/mcp"
      ]
    }
  }
}
```

## Tools (14)

- `search_docs`
- `get_doc`
- `list_packages`
- `package_status`
- `scaffold_service`
- `scaffold_client`
- `cli_status`
- `cli_install`
- `cli_help`
- `create_service`
- `generate_client`
- `fleet`
- `config`
- `logs`

## FAQ

### What is the difference between the local and hosted server?

The local server includes all 14 tools, including CLI-backed tools that act on your machine, while the hosted server provides seven read-only tools for documentation and scaffolding.

### Can I use this server without installing it locally?

Yes, if your client supports remote MCP servers, you can use the hosted endpoint for read-only documentation and scaffolding tasks.

### Does the server provide structured data or just text?

Many tools declare an MCP outputSchema and return structuredContent alongside markdown, allowing clients to consume results as data rather than parsing prose.