{
  "$schema": "https://static.modelcontextprotocol.io/schemas/mcp-server-card/v1.json",
  "name": "Petroleumfix Remote MCP Server",
  "version": "2.0.0",
  "protocol": "json-rpc-2.0",
  "description": "Autonomous B2B & industrial petroleum equipment MCP server for Petroleumfix (Pty) Ltd: search live fuel transfer pumps, flowmeters, nozzles, filtration, and tank hardware, verify stock & 15% SA VAT pricing, generate 1-click Shopify checkout sessions, and query SANS 342 laboratory & field services.",
  "homepage": "https://petroleumfix.co.za",
  "documentationUrl": "https://petroleumfix.co.za/llms.txt",
  "transport": {
    "type": "http",
    "endpoint": "https://api.petroleumfix.co.za/mcp"
  },
  "endpoints": {
    "streamable_http": "https://api.petroleumfix.co.za/mcp",
    "sse": "https://api.petroleumfix.co.za/sse"
  },
  "capabilities": {
    "tools": true,
    "resources": true,
    "prompts": false,
    "sampling": false
  },
  "auth": {
    "type": "none"
  },
  "authentication": {
    "type": "none",
    "note": "Public catalog browsing, product specs, inventory checks, and checkout session generation are open to autonomous AI agents."
  },
  "tools": [
    {
      "name": "search_catalog",
      "title": "Search Petroleum Equipment Catalog",
      "description": "Search live Petroleumfix industrial fuel handling equipment inventory by keyword, category (Transfer Pumps, Flowmeters, Dispensers, Nozzles, Filtering, Tanks, Bowsers, Hoses And Reels, Valves, Compliance), price range in ZAR, or stock availability.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Search keyword (e.g. 'Transfer Pump', 'Flowmeter', 'Blackline', '12V', 'Sealant', 'Nozzle')"
          },
          "category": {
            "type": "string",
            "description": "Product category filter (e.g. 'Transfer Pumps', 'Flowmeters', 'Miscellaneous')"
          },
          "min_price": {
            "type": "number",
            "description": "Minimum VAT-inclusive price in ZAR"
          },
          "max_price": {
            "type": "number",
            "description": "Maximum VAT-inclusive price in ZAR"
          },
          "in_stock_only": {
            "type": "boolean",
            "description": "When true, only returns products currently available in stock"
          },
          "limit": {
            "type": "integer",
            "description": "Maximum number of products to return (default 20, max 100)"
          }
        }
      }
    },
    {
      "name": "get_product_details",
      "title": "Get Product Technical Details & Pricing",
      "description": "Retrieve complete specifications, SKU, Shopify Variant GID (variantId), 15% South African VAT breakdown, stock status, and direct product URL for a specific product slug, handle, or SKU.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "handle": {
            "type": "string",
            "description": "Product URL slug/handle (e.g. 'transfer-pump-high-flow-self-priming-pump-30kw') or SKU (e.g. 'PUMP107')"
          }
        },
        "required": [
          "handle"
        ]
      }
    },
    {
      "name": "check_inventory",
      "title": "Check Live Inventory & Stock",
      "description": "Verify real-time stock availability, SKU, and VAT-inclusive/exclusive pricing across the Petroleumfix catalog or for a specific product handle/SKU.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "handle": {
            "type": "string",
            "description": "Optional product slug or SKU to check specific item stock"
          }
        }
      }
    },
    {
      "name": "calculate_order_total",
      "title": "Calculate B2B Order Total & 15% SA VAT Breakdown",
      "description": "Calculate the complete order investment in South African Rand (ZAR) including 15% South African VAT breakdown (excl. VAT, VAT amount, and incl. VAT total).",
      "inputSchema": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "description": "Line items with price (ZAR incl. VAT) and quantity",
            "items": {
              "type": "object",
              "properties": {
                "title": {
                  "type": "string"
                },
                "price": {
                  "type": "number",
                  "description": "Unit price in ZAR (VAT inclusive)"
                },
                "quantity": {
                  "type": "integer",
                  "description": "Quantity (minimum 1)"
                }
              },
              "required": [
                "price",
                "quantity"
              ]
            }
          }
        },
        "required": [
          "items"
        ]
      }
    },
    {
      "name": "create_cart_checkout",
      "title": "Create Instant 1-Click Checkout Session",
      "description": "Generate a live 1-click checkout session URL on checkout.petroleumfix.co.za for purchasing fuel handling equipment, with optional B2B company name and VAT registration number.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "description": "Items to purchase by variantId, slug, or SKU",
            "items": {
              "type": "object",
              "properties": {
                "variantId": {
                  "type": "string",
                  "description": "Shopify Variant GID (gid://shopify/ProductVariant/...) or product slug/SKU"
                },
                "slug": {
                  "type": "string",
                  "description": "Product slug or SKU if variantId is not provided"
                },
                "quantity": {
                  "type": "integer",
                  "description": "Quantity to order (default 1)"
                }
              }
            }
          },
          "companyName": {
            "type": "string",
            "description": "Optional B2B company name for tax invoice"
          },
          "vatNumber": {
            "type": "string",
            "description": "Optional South African VAT registration number for B2B tax invoice"
          },
          "orderNote": {
            "type": "string",
            "description": "Optional delivery or technical order note"
          }
        },
        "required": [
          "items"
        ]
      }
    },
    {
      "name": "get_industrial_services",
      "title": "List Industrial Petroleum & Lab Services",
      "description": "Retrieve Petroleumfix's specialized field and laboratory services: SANS 342 diesel testing, bulk tank cleaning & fuel polishing, pump/flowmeter calibration, turnkey installations, preventative maintenance SLAs, and 24/7 technical call-outs.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "service_slug": {
            "type": "string",
            "description": "Optional service slug filter (laboratory, tank-cleaning-polishing, pump-calibration-repairs, installations-upgrades, preventative-maintenance, technical-callout)"
          }
        }
      }
    },
    {
      "name": "get_store_policies",
      "title": "Get Store Policies, VAT Invoicing & Depot Info",
      "description": "Return Petroleumfix's nationwide delivery policy, 15% SA VAT invoicing details, warranty & returns policy, Montana Park Pretoria depot address, operating hours, and contact channels.",
      "inputSchema": {
        "type": "object",
        "properties": {}
      }
    }
  ]
}