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.

Source: github.com/midimurphdesigns/fieldops-mcp

Why this is a showcase, not a live demo

MCP servers don't have a UI of their own — they speak the MCP protocol over stdio to an LLM host (Claude Desktop, Cursor, Claude Code CLI). The "magic" only happens inside that host, where the model can use the tools.

Every transcript here is real output, captured by bun run smoke (deterministic) or from a live Claude session (regenerable with ANTHROPIC_API_KEY=… bun run smoke). Nothing on this page is fabricated. To run it yourself, follow the install instructions in the repo and add it to Claude Desktop's MCP config.

Read

list_open_jobs

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. → tool call · list_open_jobs
    {
  "priority": "urgent"
}
  2. ← tool result
    {
  "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

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 — ~2 minutes.

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

To register it with Claude Desktop, add 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"]
    }
  }
}

Restart Claude Desktop and the six tools appear in the tool picker. Now your prompts drive them, not mine.