{
  "$schema": "https://static.modelcontextprotocol.io/schemas/mcp-server-card/v1.json",
  "version": "1.0",
  "protocolVersion": "2025-11-25",
  "serverInfo": {
    "name": "pmc-service-discovery",
    "title": "Peak Mechanical Construction Service Discovery",
    "version": "1.0.0"
  },
  "description": "Read-only tools for PMC public company, commercial mechanical service, Northern California service-area, and indexed page information.",
  "documentationUrl": "https://pmcbuilds.com/api.md",
  "transport": {
    "type": "streamable-http",
    "endpoint": "/mcp"
  },
  "capabilities": {
    "tools": {
      "listChanged": false
    }
  },
  "authentication": {
    "required": true,
    "schemes": [
      "bearer",
      "oauth2"
    ]
  },
  "tools": [
    {
      "name": "search_pmc_site",
      "title": "Search PMC Site",
      "description": "Search PMC’s public services, service-area cities, and informational pages.",
      "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "q"
        ],
        "properties": {
          "q": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Words or phrase to search for."
          },
          "kind": {
            "type": "string",
            "enum": [
              "homepage",
              "service",
              "services-hub",
              "service-area-hub",
              "city",
              "city-service",
              "utility",
              "contact"
            ],
            "description": "Optional page-kind filter."
          },
          "city": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "Optional city name or slug."
          },
          "service": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Optional service name or slug."
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20,
            "default": 10,
            "description": "Maximum number of results."
          }
        }
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "list_pmc_services",
      "title": "List PMC Services",
      "description": "List PMC’s public commercial mechanical services, optionally for one service-area city.",
      "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "city": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "Optional city name or slug."
          }
        }
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "list_pmc_service_areas",
      "title": "List PMC Service Areas",
      "description": "List PMC’s public service-area cities, optionally filtered to one service.",
      "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "service": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Optional service name or slug."
          }
        }
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "get_pmc_page",
      "title": "Get PMC Page",
      "description": "Read the Markdown representation of an exact page listed in PMC’s public agent index.",
      "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "path"
        ],
        "properties": {
          "path": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "Exact indexed pathname, such as /services/ or /service-area/sacramento/."
          }
        }
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "get_pmc_company",
      "title": "Get PMC Company Information",
      "description": "Return PMC’s public company, contact, contractor-license, and service-region information.",
      "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {}
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    }
  ]
}