Skip to content

fieldops-mcp

A Model Context Protocol server that exposes a small-business field-services dispatcher workflow as six agent tools. This page is a tour of real captured exchanges — what Claude actually sees and writes back when these tools are exposed.

github.com/midimurphdesigns/fieldops-mcpRead the blog post

list_open_jobs

Read

Read the queue, optionally filtered, sorted urgent-first.

Returns a typed list pre-sorted by priority then age. The agent does no sorting work — the tool is opinionated about ordering so the model's prompt budget is spent on judgment, not on collation.

  1. list_open_jobsrequest
    {
  "priority": "urgent"
}
    response
    {
  "jobs": [
    {
      "id": "J-2001",
      "description": "Rooftop AC unit not cooling, multiple tenant complaints",
      "required_skill": "hvac",
      "priority": "urgent",
      "status": "open",
      "customer_id": "C-103",
      "estimated_minutes": 120
    },
    {
      "id": "J-2004",
      "description": "Walk-in cooler temperature drifting above safe threshold",
      "required_skill": "hvac",
      "priority": "urgent",
      "status": "open",
      "customer_id": "C-107",
      "estimated_minutes": 90
    },
    {
      "id": "J-2002",
      "description": "Front-of-house outlet sparking when load applied",
      "required_skill": "electrical",
      "priority": "urgent",
      "status": "open",
      "customer_id": "C-104",
      "estimated_minutes": 60
    }
  ]
}

Run it yourself

Two minutes from clone to Claude Desktop

The showcase replays captured exchanges. To run the actual MCP server inside Claude Desktop and drive it with your own prompts, clone the repo and wire it up.

01 — Clone & smoke

git clone https://github.com/midimurphdesigns/fieldops-mcp.git
cd fieldops-mcp
bun install
bun run smoke              # deterministic smoke run, no API key
ANTHROPIC_API_KEY=… bun run smoke   # live Claude session

02 — RegisterAdd an entry to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "fieldops": {
      "command": "bun",
      "args": ["run", "/absolute/path/to/fieldops-mcp/src/server.ts"]
    }
  }
}

03 — RestartClaude Desktop reloads and the six tools appear in the tool picker. Now your prompts drive them, not mine.