Fieldproxy

Fieldproxy MCP server

The official Model Context Protocol server for Fieldproxy field service management: connect Claude, ChatGPT, Copilot, Cursor or any MCP client to jobs, dispatch, invoices and quotes, with a person confirming every change.

The server is hosted by Fieldproxy (streamable HTTP). This repository holds the docs, client configs, runnable examples and a small stdio bridge for clients that cannot speak HTTP.

• Overview: https://www.fieldproxy.ai/mcp
• Developer docs: https://www.fieldproxy.ai/developers
• Sandbox page: https://www.fieldproxy.ai/developers/sandbox

Try it in 60 seconds

There is a public, read-only sandbox you can connect to right now. It is a sample HVAC company, Summit Heating & Air, with made-up data: about 2,076 jobs, 435 customers in New York, 12 technicians, invoices, estimates, equipment and service agreements.

The key is public on purpose. It can only read the sample data.

Claude Code

claude mcp add --transport http fieldproxy-sandbox https://api-uk.fieldproxy.ai/mcp \

--header "Authorization: Bearer fpmcp.eleqia.pZWm5OR4qsYqP1Wb0DKsxm9bfs_vdI-DCHL5JJMPlxc"

Cursor (.cursor/mcp.json), or a project .mcp.json

{

"mcpServers": { "fieldproxy-sandbox": { "url": "https://api-uk.fieldproxy.ai/mcp", "headers": { "Authorization": "Bearer fpmcp.eleqia.pZWm5OR4qsYqP1Wb0DKsxm9bfs_vdI-DCHL5JJMPlxc" } } } }

Any MCP client that speaks streamable HTTP

{

"type": "http", "url": "https://api-uk.fieldproxy.ai/mcp", "headers": { "Authorization": "Bearer fpmcp.eleqia.pZWm5OR4qsYqP1Wb0DKsxm9bfs_vdI-DCHL5JJMPlxc" } }

Clients that only run local (stdio) servers, such as Claude Desktop

Use mcp-remote as a bridge:

npx -y mcp-remote https://api-uk.fieldproxy.ai/mcp \

--header "Authorization: Bearer fpmcp.eleqia.pZWm5OR4qsYqP1Wb0DKsxm9bfs_vdI-DCHL5JJMPlxc"

In claude_desktop_config.json see examples/claude_desktop_config.json (the key goes in env so the space in the header survives on Windows).

Or use this repository's own bridge, published as @fieldproxy/mcp. With no settings it connects to the sandbox:

{

"mcpServers": { "fieldproxy": { "command": "npx", "args": ["-y", "@fieldproxy/mcp"] } } }

No client at all

Run one of the examples. They call initialize, then run_sql, and print the rows. No packages needed.

node examples/run_sql.mjs          # Node.js 18+

python3 examples/run_sql.py # Python 3.8+ python3 examples/run_sql.py "SELECT name, role FROM st_technicians WHERE active"

Or with curl:

curl -s https://api-uk.fieldproxy.ai/mcp \

-H "Authorization: Bearer fpmcp.eleqia.pZWm5OR4qsYqP1Wb0DKsxm9bfs_vdI-DCHL5JJMPlxc" \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"run_sql","arguments":{"sql":"SELECT status, count(*) FROM st_jobs GROUP BY status"}}}'

Things to ask

• "Call describe_schema, then tell me how many jobs are in each status."
• "Which job types do we run most often?"
• "List the scheduled jobs in Glen Cove with the customer's phone number."
• "Which technicians ran the most visits in the last 90 days?"
• "Which open estimates have had no follow-up for 30 days or more?"
• "Which customers own equipment more than 12 years old? Group it by customer."
• "How long is the drive from Garden City to Glen Cove?"
• "Plan the best route through tomorrow's scheduled visits."
• "Export every pending invoice to CSV."

The sandbox key is limited to the sample tables, so run_sql refuses SQL functions that could read other tables, such as sum() and avg(). count(), max(), GROUP BY, joins and date filters work. A key on your own workspace does not need that limit.

Sandbox REST API

The same company is also open on the REST API, read only:

curl -X POST https://api-uk.fieldproxy.ai/api/read \

-H "x-api-key: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyaWQiOiJ0ZXN0IiwiZW1haWwiOiJ0ZXN0QGV4YW1wbGUuY29tIiwidGVuYW50X2lkIjoiZWxlcWlhIiwidHlwZSI6ImFwaV9rZXkiLCJqdGkiOiI0YzliYjgwZi0yY2U2LTQ4ODYtYjk2NS1kMjA2YWU4ODczMWEiLCJpYXQiOjE3OTM5NTU3NTEsImV4cCI6MTgyNTQ5MTc1MX0.SgIxGkXEqMPbikAoX4D7H4coOUvnlrsJYb-uA8_ixNA" \ -H "content-type: application/json" \ -d '{"tableName": "st_customers", "condition": {"id": 1}}'

Sandbox tools

The sandbox key exposes 21 tools (read live from tools/list on 6 November 2026). The tool list is built per key, so the tools you see depend on the key's scopes and limits.

The server also offers seven ready-made prompts: daily_ops_briefing, plan_the_schedule, triage_my_inbox, why_did_this_automation_fail, customer_360, build_an_app, build_a_dashboard.

Connect your own workspace

A full workspace key has 170+ built-in tools, plus any SQL tools the workspace saves for its AI.

Addresses

Each workspace lives in one region. Your address is shown in Settings, AI assistant.

AI assistant access is off by default. Fieldproxy switches it on per workspace. Ask your Fieldproxy contact, or book a demo.

OAuth or a key

• OAuth (sign in). Claude, ChatGPT and Microsoft Copilot Studio connect with OAuth and dynamic client registration: add the address, sign in with workspace ID, email and password, and tick the scopes. The sign-in lasts 1 hour and renews itself for 30 days. Guides: Claude, ChatGPT, Microsoft 365 Copilot and Teams.
• Key. Make one in the web app under Settings, AI assistant, New key. Keys start with fpmcp. and are shown once. Send it as Authorization: Bearer fpmcp.…. An administrator can set up a key for someone else; that person claims it once from their own screen, so the administrator never sees it.

Client setup with a key

Claude Code:

claude mcp add --transport http fieldproxy https://api-us-east-1.fieldproxy.ai/mcp \

--header "Authorization: Bearer fpmcp.YOUR_KEY"

OpenAI Codex:

export FIELDPROXY_MCP_KEY="fpmcp.YOUR_KEY"

codex mcp add fieldproxy --url https://api-us-east-1.fieldproxy.ai/mcp --bearer-token-env-var FIELDPROXY_MCP_KEY

To sign in instead of using a key, add the server without --bearer-token-env-var, then run codex mcp login fieldproxy.

Stdio bridge:

FIELDPROXY_MCP_URL=https://api-us-east-1.fieldproxy.ai/mcp \

FIELDPROXY_MCP_KEY=fpmcp.YOUR_KEY \ npx -y @fieldproxy/mcp

The bridge sends a key; for OAuth over stdio use npx -y mcp-remote without a header and it opens the sign-in page.

Config files for each client are in examples/:

Scopes

| build | An administrator, plus Allow build switched on for