{
  "$schema": "https://static.modelcontextprotocol.io/schemas/mcp-server-card/v1.json",
  "version": "1.1",
  "protocolVersion": "2025-11-25",
  "name": "fieldrobin-mcp",
  "serverUrl": "https://fieldrobin.com/api/v1/mcp",
  "serverInfo": {
    "name": "fieldrobin-mcp",
    "title": "FieldRobin MCP Server",
    "version": "1.2.1"
  },
  "description": "Authenticated FieldRobin workspace tools for AI agents, including scope-authorized customer and job creation.",
  "fieldrobin": {
    "catalog_revision": 3,
    "server_version": "1.2.1"
  },
  "documentationUrl": "https://fieldrobin.com/developers",
  "transport": {
    "type": "streamable-http",
    "endpoint": "https://fieldrobin.com/api/v1/mcp"
  },
  "capabilities": {
    "tools": {
      "listChanged": false
    },
    "resources": {
      "listChanged": false
    }
  },
  "authentication": {
    "required": true,
    "schemes": [
      "bearer",
      "oauth2"
    ]
  },
  "instructions": "Discover the authenticated FieldRobin tool catalog for each new session. New connections should request mcp:read mcp:customers:write mcp:jobs:write so the user can choose granular direct write permissions during OAuth; use mcp:read only when the user intentionally wants a read-only connection. The broad mcp:write scope remains a compatibility option, and the legacy mcp:use scope remains read-only compatible. If an operation needs more permission, present the client's authorization flow instead of claiming FieldRobin cannot perform it. Scope-authorized write tools persist directly and return an authoritative verified result.",
  "resources": [
    "dynamic"
  ],
  "tools": [
    {
      "name": "create-customer",
      "description": "Scope-authorized create-customer tool. It persists and verifies the record directly when the required OAuth write scope is granted.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "create-job",
      "description": "Scope-authorized create-job tool. It persists and verifies the record directly when the required OAuth write scope is granted.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "get-workspace-summary",
      "description": "Read-only get-workspace-summary tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "search-locations",
      "description": "Read-only search-locations tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "get-location",
      "description": "Read-only get-location tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "search-customers",
      "description": "Read-only search-customers tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "search-jobs",
      "description": "Read-only search-jobs tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "get-customer",
      "description": "Read-only get-customer tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "get-job",
      "description": "Read-only get-job tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "search-leads",
      "description": "Read-only search-leads tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "jobs-today",
      "description": "Read-only jobs-today tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "get-lead",
      "description": "Read-only get-lead tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "search-quotes",
      "description": "Read-only search-quotes tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "get-quote",
      "description": "Read-only get-quote tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "preview-quote",
      "description": "Read-only preview-quote tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "search-invoices",
      "description": "Read-only search-invoices tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "get-invoice",
      "description": "Read-only get-invoice tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "preview-invoice",
      "description": "Read-only preview-invoice tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "schedule-availability",
      "description": "Read-only schedule-availability tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "pipeline-next-actions",
      "description": "Read-only pipeline-next-actions tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "pipeline-recommendations",
      "description": "Read-only pipeline-recommendations tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "customer-service-requests",
      "description": "Read-only customer-service-requests tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "search-service-requests",
      "description": "Read-only search-service-requests tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "get-service-request",
      "description": "Read-only get-service-request tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "get-invoice-payment-status",
      "description": "Read-only get-invoice-payment-status tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "preview-review-requests",
      "description": "Read-only preview-review-requests tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "search-reviews",
      "description": "Read-only search-reviews tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "draft-review-reply",
      "description": "Read-only draft-review-reply tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "search-referral-campaigns",
      "description": "Read-only search-referral-campaigns tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "get-referral-campaign-attribution",
      "description": "Read-only get-referral-campaign-attribution tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "preview-referral-campaign",
      "description": "Read-only preview-referral-campaign tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "search-reactivation-campaigns",
      "description": "Read-only search-reactivation-campaigns tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "preview-reactivation-campaign",
      "description": "Read-only preview-reactivation-campaign tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "search-broadcast-campaigns",
      "description": "Read-only search-broadcast-campaigns tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "preview-broadcast-campaign",
      "description": "Read-only preview-broadcast-campaign tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "search-social-drafts",
      "description": "Read-only search-social-drafts tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "preview-social-draft",
      "description": "Read-only preview-social-draft tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "list-job-photos",
      "description": "Read-only list-job-photos tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "search-inventory",
      "description": "Read-only search-inventory tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "search-pricebook",
      "description": "Read-only search-pricebook tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "complaint-recall-risk",
      "description": "Read-only complaint-recall-risk tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "routing-driving-risk",
      "description": "Read-only routing-driving-risk tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "operations-parts",
      "description": "Read-only operations-parts tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "operations-scorecards",
      "description": "Read-only operations-scorecards tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "reports-overview",
      "description": "Read-only reports-overview tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "reports-by-location",
      "description": "Read-only reports-by-location tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "reports-customer-revenue-rank",
      "description": "Read-only reports-customer-revenue-rank tool for authenticated FieldRobin workspaces.",
      "inputSchema": {
        "type": "object"
      }
    }
  ]
}