# PatrolTech

Connects an AI agent to a PatrolTech account: security patrol routes, checkpoints, missed rounds, scans and incident logs.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: PatrolTech
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/PatrolTech/mcp-server
- Updated: 2026-10-28
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/patroltech

## What it does

A remote MCP server for the PatrolTech guard tour platform. The agent reads and modifies patrol routes, checkpoints, scans, incidents and guard data through OAuth: the user's token is verified by the API and exchanged for a 15-minute session. Tools split into reads (`patroltech_<area>_<read>`) and batched writes via `propose` → `confirm`.

The server is stateless; Redis is required for coordination. Proposal locks and rate limits (60 calls per minute for reads, 20 for writes) live in Redis; without it the server only runs in `development`. Every call writes an `mcp.tool_call` audit entry with a hash of the arguments.

Writes need the `write` scope: without it the server answers `403 insufficient_scope`. Proposals live in the PatrolTech API for up to 30 minutes or 10 operations per batch, any worker can serve the request. The `patroltech_locations_get_qr_sheet` tool returns a signed link to a location's printable QR sheet, valid for one hour.

## Requirements
- Remote server: `https://mcp.patroltech.online/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http patroltech https://mcp.patroltech.online/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add patroltech --url https://mcp.patroltech.online/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "patroltech": {
            "url": "https://mcp.patroltech.online/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "patroltech": {
            "type": "http",
            "url": "https://mcp.patroltech.online/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http patroltech https://mcp.patroltech.online/mcp
```

## When to use it
- check missed patrol rounds for a shift
- list incidents at a location
- set up new route checkpoints
- rank guards by scan activity
- print checkpoint QR codes

## Example prompts
- Show missed rounds in the last 24 hours at the head office
- Add three checkpoints to the warehouse route: receiving, dispatch, perimeter
- Pull suspicious scans from yesterday's shift

## Similar
- [security-patterns](https://affpapa.org/en/nevibecode/skills/cloudai-x-security-patterns.md) — skill · ★ 1424 repo stars
- [API Rate Limiting taste](https://affpapa.org/en/nevibecode/prompts/api-rate-limiting-taste.md) — prompt · ★ 178201 repo stars
- [unauthorized-access-common-services](https://affpapa.org/en/nevibecode/skills/unauthorized-access-common-services.md) — skill · 3800 installs
- [nosql-injection](https://affpapa.org/en/nevibecode/skills/nosql-injection.md) — skill · 3800 installs
- [redis-security](https://affpapa.org/en/nevibecode/skills/redis-security.md) — skill · 2700 installs
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24580 repo stars

---
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
