Skip to main content
Glama
tommypj

mcp-job-queue

by tommypj

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
JOBQ_DB_PATHNoSQLite (WAL) queue file~/.mcp-job-queue/queue.db
JOBQ_LOG_LEVELNodebug / info / warn / errorinfo
JOBQ_ARTIFACT_DIRNoWhere result artifacts are written~/.mcp-job-queue/artifacts
JOBQ_MAX_TIMEOUT_MSNoHard ceiling for a per-job timeout600000
JOBQ_MAX_CONCURRENCYNoMax jobs a worker runs at once (backpressure)4
JOBQ_POLL_INTERVAL_MSNoIdle poll interval250
JOBQ_DEFAULT_TIMEOUT_MSNoDefault per-job timeout30000
JOBQ_RETRY_BASE_DELAY_MSNoBase delay for exponential backoff500
JOBQ_DEFAULT_MAX_ATTEMPTSNoDefault attempts incl. the first3
JOBQ_MAX_ATTEMPTS_CEILINGNoHard ceiling for attempts10

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
submit_jobA

Enqueue a job for asynchronous execution by the worker. Returns the created job (status 'queued'). Valid type values are the registered handlers: echo, wait, hash, fibonacci, fail. The job runs in an isolated process under a timeout, with automatic retries.

get_jobA

Fetch a single job by id, including its status, result, and artifact path.

list_jobsA

List recent jobs (newest first), optionally filtered by status.

cancel_jobA

Cancel a job that is still queued. Running or already-finished jobs cannot be cancelled and return a NOT_CANCELLABLE error.

get_statsA

Return queue health: job counts by status, total, age of the oldest queued job, and the active configuration. No sensitive data.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.2/5.0

Scored across 5 tools

Disambiguation5/5

Each tool has a distinct and clear purpose: submitting, getting, listing, canceling jobs, and fetching queue statistics. No overlap or ambiguity.

Naming Consistency5/5

All tool names follow the verb_noun pattern (cancel_job, get_job, get_stats, list_jobs, submit_job) with consistent snake_case styling.

Tool Count5/5

With 5 tools covering essential job queue operations, the count is well-scoped and not excessive or insufficient.

Completeness5/5

The tool set covers all fundamental CRUD-like operations for a job queue: submit, get, list, cancel, and health statistics. No obvious gaps.

Maintenance

ActivityInactive
ResponsivenessNo issues