MCP Queue Doctor
Diagnoses pg-boss and graphile-worker job queues: retry storms, stuck workers, missed schedules.
Connector by ethanasm · GitHub account verified by the MCP Registry
Chalk Labs
Need help deploying MCP Queue Doctor?
Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/ethanasm-mcp-queue-doctor
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 8 read · 0 write · 0 deleteRead-only
- Secrets
- None asked for
- Install scripts
- Not scanned yet
- Runs as
- Node.js package
Tools by what they do 8
Read from the source code; the running server may list different tools.
Read 8 · Look things up without changing anything.
diagnosefailed_jobsjob_detailmissed_schedulesqueue_overviewschedule_statusserver_infostuck_jobs
Tools (8)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
diagnoseDiagnoseread-onlyRun the whole diagnosis catalog and return ranked findings — retry storms, expiry overruns, stuck or abandoned workers, missed schedules, duplicate cron registration, retention-window confusion, and idle queues. Each finding carries the evidence it was drawn from and recovery steps ordered safest-first. This is the tool to reach for when the question is "what is wrong?".
failed_jobsFailed jobsread-onlyJobs that failed within the window, newest first, with the error message pulled from each job's output. Bounded on when the job finished — not on the row merely being in the failed state — so results reflect what broke recently rather than everything still inside the queue's retention period.
job_detailJob detailread-onlyOne job's full record: state, timestamps, retry counters, configured expiry and dead-letter queue, computed duration, and its payload and output. Use this to read the actual error behind a failure surfaced by another tool.
missed_schedulesMissed schedulesread-onlyOnly the cron schedules whose most recent firing is older than their expression implies. Schedules registered more recently than their last expected tick are excluded, since they cannot have missed it.
queue_overviewQueue overviewread-onlyPer-queue health snapshot: job counts by state, jobs stuck active, completions and failures in the window, and each queue's configured expiry, retention and retry limit. Failed counts are reported both within the window and all-time, because the two disagreeing is itself diagnostic.
schedule_statusSchedule statusread-onlyEvery cron schedule pg-boss has registered, with its expression, timezone, last observed firing, and the previous and next firings the expression implies. Expectations are derived from the schedule table itself, so no configuration is needed.
server_infoServer inforead-onlyReport queue-doctor's configuration, database connectivity, and the detected pg-boss schema — including which dialect matched, whether that schema version has been verified, and any reduced capabilities. Call this first whenever another tool returns an unexpected or empty result.
stuck_jobsStuck jobsread-onlyJobs that have been active longer than a threshold, with age, configured expiry, and — where the schema supports heartbeats — how long since the worker last checked in. A stale heartbeat distinguishes an abandoned job from a merely slow one.
Signals
- Stars
- 0
- Forks
- 0
- Open issues
- 0
- Last commit
- Aug 7, 2026 (2 months ago)
- Last release
- Aug 7, 2026 (2 months ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.ethanasm/mcp-queue-doctor- Version
- 0.2.2
- Auth
- No auth
- Packages
- npm mcp-queue-doctor
- License
- MIT
- Repository
- github.com/ethanasm/mcp-queue-doctor
- First seen
- Oct 24, 2026
- Last checked
- Oct 25, 2026
Done for you
Rather not set it up yourself?
Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.
See how we build AI agents →Read the case studies
Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.
- launches shipped
- 50+
- launches shipped
- media placements
- 500+
- media placements
- founders on every account
- 2
- founders on every account
Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block
Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.
Get MCP Queue Doctor running in your business
Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.
Cite this page
MCP Queue Doctor. Agent Mart. https://agentmart.dev/connectors/ethanasm-mcp-queue-doctor (last updated 2026-10-25)