FieldRoutes MCP Server for Claude

Connects Claude to your FieldRoutes account so you can look up customers, check routes, view appointments, pull service history, and more — directly in conversation.

Tools included

Tool	What it does
`search_customers`	Find a customer by name, phone, email, or address
`get_customer`	Full details for a customer by ID
`get_service_history`	Past and open service tickets for a customer
`get_ticket`	Full details on a single service ticket
`get_appointments`	Scheduled appointments by date, customer, route, or tech
`get_routes`	Routes running on a specific date
`get_route_details`	All stops on a specific route
`get_subscriptions`	Recurring service plans for a customer
`get_employees`	Employee/technician list and IDs
`get_invoices`	Invoices and balances for a customer

Setup

1. Copy this project and install dependencies

npm install

2. Configure your credentials

cp .env.example .env

Open .env and fill in:

FR_AUTH_KEY — from FieldRoutes: Admin → API → Manage Keys
FR_AUTH_TOKEN — same location
FR_SUBDOMAIN — the part before .pestroutes.com in your URL (e.g. crownpest)

3. Build and run locally to test

npm run build
npm start

You should see:

FieldRoutes MCP server running on port 3000
MCP endpoint: http://localhost:3000/mcp

Deploy to Railway (recommended — free tier available)

Go to railway.app and sign up (free)
Click New Project → Deploy from GitHub repo
Connect your GitHub account and push this code to a new repo
Railway will detect Node.js and deploy automatically
In Railway, go to your project → Variables and add:
- FR_AUTH_KEY
- FR_AUTH_TOKEN
- FR_SUBDOMAIN
Railway will give you a public URL like https://fieldroutes-mcp-production.up.railway.app

Deploy to Render (alternative — also free)

Go to render.com and sign up
Click New → Web Service
Connect your GitHub repo
Set Build Command: npm install && npm run build
Set Start Command: npm start
Under Environment, add FR_AUTH_KEY, FR_AUTH_TOKEN, FR_SUBDOMAIN
Deploy — Render gives you a URL like https://fieldroutes-mcp.onrender.com

Connect to Claude

In the Claude desktop app, go to Settings → Connectors
Click Add custom connector
Enter your deployed URL + /mcp:
```
https://your-app.up.railway.app/mcp
```
Save — Claude can now use all 10 FieldRoutes tools

Verify endpoints against your FieldRoutes docs

The API paths in this server (customer/search, appointment/search, etc.) follow the standard FieldRoutes REST pattern. If any return a 404, check your tenant-specific API docs at:

https://YOUR_SUBDOMAIN.pestroutes.com/api/docs

or contact FieldRoutes support to confirm the exact path for your account tier.

Security notes

Your API credentials are stored only in environment variables — never committed to code
The server does not require its own authentication (Claude is the only caller)
For extra security, you can add an API_SECRET env var and validate it as a bearer token on incoming requests

FieldRoutes MCP Server