{
  "name": "eservices.com",
  "version": "2.0.0",
  "protocol_version": "2024-11-05",
  "description": "MCP server for the eServices vertical brand gateway. Free tools for discovery, x402-gated for lead submission (Phase E).",
  "tools": [
    {
      "name": "vertical.list_categories",
      "description": "List the 10 eServices vertical categories with provider counts. Mirrors ServiceDirectory.com's category set.",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "required": []
      }
    },
    {
      "name": "directory.search",
      "description": "Hand off a semantic search query to ServiceDirectory.com. Returns a 302-style result link the caller can follow, plus matched-category hints.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Free-text search, e.g. 'plumber near 33101'"
          },
          "category": {
            "type": "string",
            "description": "Optional category slug"
          },
          "geo_zip": {
            "type": "string",
            "pattern": "^[0-9]{5}$",
            "description": "Optional US 5-digit ZIP"
          }
        },
        "required": [
          "query"
        ]
      }
    },
    {
      "name": "lead.submit",
      "description": "Programmatic lead submission on behalf of an end user. Writes to eservices-directory-db.leads. Lead Engine routing arrives in Phase B (returns status='pending_lead_engine' until then).",
      "inputSchema": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "email": {
            "type": "string",
            "format": "email"
          },
          "phone": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "category": {
            "type": "string",
            "description": "Stored as service_type in the leads table"
          },
          "zip": {
            "type": "string"
          },
          "urgency": {
            "type": "string",
            "enum": [
              "asap",
              "this_week",
              "this_month",
              "exploring"
            ]
          },
          "source": {
            "type": "string",
            "description": "Origin agent / referrer identifier (stored as referral_code)"
          }
        },
        "required": [
          "name",
          "email",
          "description"
        ]
      },
      "pricing": {
        "note": "Free during Phase A. Will require x402 USDC proof in Phase E.",
        "current": "free"
      }
    },
    {
      "name": "vertical.status",
      "description": "Return the vertical's health summary: total nodes, green-percentage, last D1 write, heartbeat freshness.",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "required": []
      }
    }
  ],
  "transport": "http",
  "invoke_endpoint": "https://eservices.com/mcp/invoke"
}