# @imqueue

Lets your coding agent read the @imqueue docs and generate typed services and clients. Useful when the code has to follow the framework instead of guessing at its API.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: imqueue
- License: GPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/imqueue/mcp
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/at-imqueue

## What it does

A local install exposes 14 tools. Six of them are also on the hosted server: `search_docs` queries the guides, tutorial, CLI manual and API reference, `get_doc` pulls a full page, and `list_packages` plus `package_status` report versions, licences and the minimum Node release for @imqueue packages. Two scaffolders, `scaffold_service` and `scaffold_client`, build an `IMQService` subclass with `@expose()`d methods and show how to produce a fully typed client. None of these write anything.

The other eight tools drive the real `imq` binary, so they change the machine the server runs on. `create_service` is a dry run unless you pass `apply: true`. `generate_client` needs the service already running. Fleet control, CLI config reads and writes, and log dumps round out the set. No `imq` on your PATH? Use `cli_install`, or stay with the offline scaffolders.

Node.js ≥ 18 is required and there is no build step — the server runs from npm as is. Docs are fetched live from imqueue.org and imqueue.com, so package versions do not go stale with the server. The host allowlist lives in `src/docs.ts` and rejects anything else. If you want read-only access and no commands running locally, take the hosted server: seven tools, no side effects.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.imqueue.org/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.imqueue.org/mcp
```

2. **Platform CLI**
```bash
claude mcp add at-imqueue -- npx -y @imqueue/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add at-imqueue --url https://mcp.imqueue.org/mcp
```

2. **Platform CLI**
```bash
codex mcp add at-imqueue -- npx -y @imqueue/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "at-imqueue": {
            "url": "https://mcp.imqueue.org/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "at-imqueue": {
            "command": "npx",
            "args": [
                "-y",
                "@imqueue/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "at-imqueue": {
            "type": "http",
            "url": "https://mcp.imqueue.org/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "at-imqueue": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@imqueue/mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http at-imqueue https://mcp.imqueue.org/mcp
```

2. **Platform CLI**
```bash
gemini mcp add at-imqueue npx -y @imqueue/mcp
```

## When to use it
- find the current @imqueue doc page for a topic
- generate a service stub with typed methods
- get a typed client for a running service
- check a package's version, licence and minimum Node
- start, stop or inspect a fleet of service repos

## Example prompts
- Search the @imqueue docs for how to declare an @expose() method
- Scaffold a service for a notifications queue
- Generate the client for NotificationService

## Similar
- [template-smart-defaults](https://affpapa.org/en/nevibecode/skills/template-smart-defaults.md) — skill · 2800 installs
- [remotion-create](https://affpapa.org/en/nevibecode/skills/remotion-dev-remotion-create.md) — skill · 214000 installs
- [create-slack-app](https://affpapa.org/en/nevibecode/skills/create-slack-app.md) — skill · 446 installs
- [create-voltagent](https://affpapa.org/en/nevibecode/skills/create-voltagent.md) — skill · 615 installs
- [cli-anything-pm2](https://affpapa.org/en/nevibecode/skills/cli-anything-pm2.md) — skill · 491 installs
- [convex-quickstart](https://affpapa.org/en/nevibecode/skills/convex-quickstart.md) — skill · 131400 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md