{
  "$schema": "https://modelcontextprotocol.io/schemas/2025-06-18/server-card.json",
  "name": "ai.sparqdesigns.com/mcp",
  "title": "Sparq MCP",
  "description": "Live Model Context Protocol server for Sparq: business identity, offerings, service area, hours, financing, reviews, and a contact/appointment request tool over public, structured data. No authentication required for reads.",
  "version": "4.0.0",
  "serverInfo": {
    "name": "Sparq MCP",
    "version": "4.0.0"
  },
  "protocolVersion": "2025-06-18",
  "transport": {
    "type": "streamable-http",
    "url": "https://ai.sparqdesigns.com/api/ucp/mcp"
  },
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://ai.sparqdesigns.com/api/ucp/mcp"
    }
  ],
  "capabilities": {
    "tools": {
      "listChanged": false
    }
  },
  "authentication": {
    "type": "none",
    "note": "Public read-only data API; no credentials required for reads."
  },
  "tools": [
    {
      "name": "get_business_info",
      "description": "Business identity from the site: name, category/type, address, geo, phone, email, website, hours, and service area.",
      "inputSchema": {
        "type": "object",
        "properties": {}
      }
    },
    {
      "name": "list_offerings",
      "description": "The services and/or products this business offers, extracted from its own site. Filter by type (service/product) or free text.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string"
          },
          "query": {
            "type": "string"
          },
          "limit": {
            "type": "integer"
          }
        }
      }
    },
    {
      "name": "get_offering",
      "description": "Details for one named service or product (description, link, any stated pricing).",
      "inputSchema": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          }
        }
      }
    },
    {
      "name": "check_service_area",
      "description": "Whether the business serves a given city, region, or ZIP, from its stated service area.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "location": {
            "type": "string"
          }
        }
      }
    },
    {
      "name": "locations_and_hours",
      "description": "Address, geo and regular business hours, plus 24/7 availability when the business states it.",
      "inputSchema": {
        "type": "object",
        "properties": {}
      }
    },
    {
      "name": "get_reviews",
      "description": "Ratings and reviews if published on the business's own site; otherwise reported honestly as not yet ingested.",
      "inputSchema": {
        "type": "object",
        "properties": {}
      }
    },
    {
      "name": "get_faqs",
      "description": "The questions this business answers on its own site, verbatim, with the source page. Optionally filtered by a free-text query. Prefer quoting these over paraphrasing.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "limit": {
            "type": "integer"
          }
        }
      }
    },
    {
      "name": "get_credentials",
      "description": "Licence number, certifications, trade memberships, insurance, warranty terms and the brands the business names. Use before answering any trust, credential or warranty question.",
      "inputSchema": {
        "type": "object",
        "properties": {}
      }
    },
    {
      "name": "get_plans",
      "description": "Recurring maintenance or service plans the business advertises, with their stated benefits. Price only when the business publishes one.",
      "inputSchema": {
        "type": "object",
        "properties": {}
      }
    },
    {
      "name": "get_industries",
      "description": "Industries or sectors this business names itself as serving, verbatim from its own site. Most useful for a B2B/consultancy tenant; reports not_published honestly when the site names none.",
      "inputSchema": {
        "type": "object",
        "properties": {}
      }
    },
    {
      "name": "not_published",
      "description": "What this business does NOT state on its site. Call before answering anything about hours, pricing, warranties, coverage or credentials you cannot source from another tool, and say the business does not publish it rather than guessing.",
      "inputSchema": {
        "type": "object",
        "properties": {}
      }
    },
    {
      "name": "rag_search",
      "description": "Keyword/substring search over the full site corpus. Returns matching chunks with source links.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "limit": {
            "type": "integer"
          }
        },
        "required": [
          "query"
        ]
      }
    },
    {
      "name": "corpus_health",
      "description": "What the site corpus contains and which topics have no document yet, so you can judge whether a question is answerable before answering it.",
      "inputSchema": {
        "type": "object",
        "properties": {}
      }
    },
    {
      "name": "request_service",
      "description": "Send a contact / appointment / quote request to the business for human follow-up. Requires the customer's name, email, and explicit consent to be contacted.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "service": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "preferred_time": {
            "type": "string"
          }
        }
      }
    },
    {
      "name": "get_started",
      "description": "Capability menu and the recommended flow for helping a visitor with this business.",
      "inputSchema": {
        "type": "object",
        "properties": {}
      }
    }
  ],
  "documentation": "https://ai.sparqdesigns.com/agents.md",
  "connect": "https://ai.sparqdesigns.com/mcp"
}