# Fieldproxy MCP server

> Connect AI clients to field service management data including jobs, dispatch, invoices, and quotes with human-in-the-loop confirmation.

- Repository: https://github.com/Fieldproxy/fieldproxy-mcp
- Page: https://hostedmcp.org/servers/fieldproxy/fieldproxy-mcp
- Transport: remote
- Stars: 0
- Latest version: 1.0.0

## Install

### Claude Code

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

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "fieldproxy-mcp": {
      "url": "https://api-us-east-1.fieldproxy.ai/mcp"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "fieldproxy-mcp": {
      "type": "http",
      "url": "https://api-us-east-1.fieldproxy.ai/mcp"
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"fieldproxy-mcp","type":"http","url":"https://api-us-east-1.fieldproxy.ai/mcp"}'
```

### Codex

```sh
codex mcp add fieldproxy-mcp --url https://api-us-east-1.fieldproxy.ai/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.fieldproxy-mcp]
url = "https://api-us-east-1.fieldproxy.ai/mcp"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http fieldproxy-mcp https://api-us-east-1.fieldproxy.ai/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "fieldproxy-mcp": {
      "url": "https://api-us-east-1.fieldproxy.ai/mcp",
      "type": "http"
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `FIELDPROXY_MCP_KEY` | no | no |  |
| `FIELDPROXY_MCP_URL` | no | no |  |

## Tools (21)

- `describe_schema`
- `run_sql`
- `search_freeform`
- `list_distinct_values`
- `explain_change`
- `export_csv`
- `open_record`
- `list_record_files`
- `generate_pdf`
- `list_dashboards`
- `view_dashboard`
- `list_alerts`
- `list_scheduled_reports`
- `workspace_usage`
- `geocode_address`
- `reverse_geocode`
- `drive_time`
- `calculate_route`
- `get_widget_docs`
- `get_automation_docs`
- `log_turn`

## FAQ

### Can the AI make changes to my data automatically?

No, the server requires a person to confirm every change before it is applied.

### Is there a way to test the server without my own data?

Yes, there is a public, read-only sandbox available featuring a sample HVAC company with made-up data.

### What authentication methods are supported?

The server supports both OAuth for signing in and API keys starting with 'fpmcp.' for direct authorization.