# Petroleumfix (Pty) Ltd — Full Technical, Catalog & Agentic Commerce Reference (`llms-full.txt`) > Comprehensive machine-readable specification for AI agents, procurement assistants, and LLM crawlers interacting with Petroleumfix (`https://petroleumfix.co.za` and `https://api.petroleumfix.co.za`). --- ## 1. Corporate Identity & Depot Operations - **Registered Name:** Petroleumfix (Pty) Ltd - **Brand Name:** Petroleumfix Fuel Solutions - **Primary Domain:** `https://petroleumfix.co.za` - **API & MCP Gateway:** `https://api.petroleumfix.co.za` - **Headless Checkout Domain:** `https://checkout.petroleumfix.co.za` - **Physical Address:** Off 621, 501 Oase Close, Breed St, Montana Park, Pretoria, Gauteng, 0182, South Africa - **GPS Coordinates:** `-25.6881, 28.2435` - **Phone:** `+27 12 880 1896` - **Email:** `info@petroleumfix.co.za` - **Customer Rating:** 4.6 / 5.0 (Verified Google Reviews, trusted by 800+ South African businesses) - **Service Footprint:** Gauteng (Pretoria, Johannesburg, Midrand, Centurion, East Rand, West Rand) and nationwide across all 9 South African provinces. --- ## 2. Agentic Commerce & Model Context Protocol (MCP) Integration Autonomous AI agents can query live inventory, inspect 15% VAT pricing breakdowns, and generate instant 1-click checkout links using either JSON-RPC 2.0 over HTTP (`/mcp`) or REST endpoints. ### 2.1 Discovery Endpoints - `GET https://petroleumfix.co.za/.well-known/mcp/server-card.json` — SEP-1649 / SEP-2127 MCP Server Card - `GET https://petroleumfix.co.za/.well-known/mcp.json` — MCP Server Card alias - `GET https://petroleumfix.co.za/.well-known/agent-card.json` — A2A Protocol Agent Card - `GET https://petroleumfix.co.za/.well-known/agent.json` — A2A Agent Card alias - `GET https://petroleumfix.co.za/.well-known/skills/index.json` — Agent Skills Index - `GET https://petroleumfix.co.za/.well-known/api-catalog` — RFC 9727 Linkset API Catalog - `GET https://petroleumfix.co.za/.well-known/oauth-protected-resource` — RFC 9728 OAuth Protected Resource Metadata - `GET https://petroleumfix.co.za/.well-known/http-message-signatures-directory` — RFC 9421 Web Bot Auth Ed25519 JWKS - `GET https://petroleumfix.co.za/.well-known/ucp` — Universal Commerce Protocol Manifest - `GET https://petroleumfix.co.za/.well-known/acp.json` — Agentic Commerce Protocol Manifest - `GET https://petroleumfix.co.za/.well-known/x402` — x402 Protocol Manifest ### 2.2 Callable MCP Tools (`POST https://api.petroleumfix.co.za/mcp`) 1. **`search_catalog`** - **Arguments:** `{ "query": "string", "category": "string", "min_price": number, "max_price": number, "in_stock_only": boolean, "limit": integer }` - **Returns:** Matching products with SKU, `variantId`, `price_incl_vat_zar`, `price_excl_vat_zar`, `vat_amount_zar`, `in_stock`, and canonical product URL. 2. **`get_product_details`** - **Arguments:** `{ "handle": "slug-or-sku" }` - **Returns:** Full technical description, SKU, Shopify Variant GID (`variantId`), 15% VAT breakdown, and stock status. 3. **`check_inventory`** - **Arguments:** `{ "handle": "optional-slug-or-sku" }` - **Returns:** Real-time catalog version and stock availability across variants. 4. **`calculate_order_total`** - **Arguments:** `{ "items": [{ "title": "string", "price": number, "quantity": integer }] }` - **Returns:** Total investment in ZAR with 15% VAT breakdown (`total_excl_vat_zar`, `vat_amount_zar`, `total_incl_vat_zar`). 5. **`create_cart_checkout`** - **Arguments:** `{ "items": [{ "variantId": "gid://shopify/ProductVariant/...", "slug": "optional-slug-or-sku", "quantity": 1 }], "companyName": "Optional B2B Company", "vatNumber": "Optional SA VAT No", "orderNote": "Optional note" }` - **Returns:** Live 1-click Shopify checkout URL on `https://checkout.petroleumfix.co.za/...` pre-populated with B2B company & VAT attributes. 6. **`get_industrial_services`** - **Arguments:** `{ "service_slug": "optional-slug" }` - **Returns:** Detailed specifications and booking links for all 6 industrial services. 7. **`get_store_policies`** - **Arguments:** `{}` - **Returns:** Nationwide shipping, 15% SA VAT invoicing, returns/refunds, POPIA compliance, and Pretoria depot contact info. ### 2.3 Direct REST API Endpoints - `GET https://api.petroleumfix.co.za/api/inventory/check?q=&category=&in_stock=true&limit=50` - `GET https://api.petroleumfix.co.za/api/products` - `GET https://api.petroleumfix.co.za/api/product/` - `GET https://api.petroleumfix.co.za/api/collections` - `GET https://api.petroleumfix.co.za/api/collection/` - `POST https://api.petroleumfix.co.za/api/checkout` - `GET https://api.petroleumfix.co.za/api/articles` - `GET https://api.petroleumfix.co.za/api/article/` ### 2.4 Edge Markdown Content Negotiation Append `?format=markdown` or send `Accept: text/markdown` on `/`, `/shop`, `/product/`, `/collection/`, or `/articles/` to receive clean Markdown without HTML boilerplate. --- ## 3. Detailed Industrial Services Portfolio ### 3.1 SANS 342 Fuel Testing Laboratory (`/services/laboratory`) - **Capabilities:** Comprehensive diesel and petrol chemical analysis, water and sediment content verification, flash point testing, density at 20°C, total contamination, microbial growth detection, and cetane index checks. - **Compliance Standard:** South African National Standard SANS 342 (Automotive Diesel Fuel) and SANS 1598 (Unleaded Petrol). - **Use Cases:** Preventing injector failure in heavy commercial fleets, verifying bulk fuel deliveries at depots, investigating generator fuel degradation, and regulatory compliance audits. ### 3.2 Bulk Tank Cleaning & Fuel Polishing (`/services/tank-cleaning-polishing`) - **Capabilities:** Mobile multi-stage kidney-loop fuel polishing, water separation, microbial sludge extraction, confined-space tank cleaning, and waste disposal certification. - **Applications:** Underground forecourt tanks, above-ground bulk diesel bowsers, data-center/hospital backup generator tanks, mining depots, and agricultural storage tanks. ### 3.3 Pump & Flowmeter Calibration & Repairs (`/services/pump-calibration-repairs`) - **Capabilities:** Volumetric proving using certified calibration measures, mechanical and electronic flowmeter adjustment, suction/submersible pump overhauls, nozzle testing, and calibration certificates. ### 3.4 Bulk Fuel System Installations & Upgrades (`/services/installations-upgrades`) - **Capabilities:** Turnkey engineering and installation of bulk fuel depots, self-bunded tanks, high-flow pump skids, filtration manifolds, pipework, and automated fleet fuel management systems. ### 3.5 Preventative Maintenance SLAs (`/services/preventative-maintenance`) - **Capabilities:** Tailored monthly/quarterly inspection contracts covering filter element replacements, water-trap draining, meter calibration verification, hose/nozzle safety checks, and priority breakdown response. ### 3.6 24/7 Emergency Technical Call-Out (`/technical-callout`) - **Capabilities:** Rapid technician dispatch for inoperable dispensers, pump motor burnouts, severe water/sludge contamination, or pipeline leaks. --- ## 4. Live Equipment Catalog & Variant Identifiers | Product Title | SKU | Slug | Variant ID (Shopify GID) | Price (Incl. 15% VAT) | Price (Excl. VAT) | Category | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | **Transfer Pump - High Flow Self-Priming Pump 3.0Kw** | `PUMP107` | `transfer-pump-high-flow-self-priming-pump-30kw` | `gid://shopify/ProductVariant/67701109489709` | R 8,625.00 | R 7,500.00 | Transfer Pumps | | **Blackline Diesel Bi-Pump 12V** | `PUMP002` | `blackline-diesel-bi-pump-12v` | `gid://shopify/ProductVariant/67729737580589` | R 5,500.00 | R 4,782.61 | Transfer Pumps | | **Transfer Pump - High Flow Self-Priming Pump 2.2kw 50mm** | `PUMP106` | `transfer-pump-high-flow-self-priming-pump-22kw-50mm` | `gid://shopify/ProductVariant/67701109522477` | R 5,175.00 | R 4,500.00 | Transfer Pumps | | **K24 Alluminium (Blackline) Flowmeter 1"** | `FLOW036` | `k24-alluminium-blackline-flowmeter-1` | `gid://shopify/ProductVariant/67705666764845` | R 2,500.00 | R 2,173.91 | Flowmeters | | **Blackline - PTFE Liquid Sealant 250ml** | `COMP023` | `blackline-ptfe-liquid-sealant-250ml` | `gid://shopify/ProductVariant/66828919636013` | R 650.00 | R 565.22 | Miscellaneous | --- ## 5. Technical Knowledge Base Articles (`/articles`) - [The Role of On-Site Laboratory Testing in the Petroleum Industry](https://petroleumfix.co.za/articles/the-role-of-on-site-laboratory-testing-in-the-petroleum-industry) - [Why Regular Diesel Fuel Testing Saves You Money and Ensures Compliance](https://petroleumfix.co.za/articles/why-regular-diesel-fuel-testing-saves-you-money-and-ensures-compliance) - [Understanding SANS 342: The Benchmark for Diesel Quality in South Africa](https://petroleumfix.co.za/articles/understanding-sans-342-the-benchmark-for-diesel-quality-in-south-africa) - [Keep Your Diesel Clean for Optimal Fleet Performance: A Guide for Logistics Companies](https://petroleumfix.co.za/articles/keep-your-diesel-clean-for-optimal-fleet-performance-a-guide-for-logistics-companies) - [Why Regular Calibration Is Crucial for the Fuel and Petroleum Industry](https://petroleumfix.co.za/articles/why-regular-calibration-is-crucial-for-the-fuel-and-petroleum-industry) - [Fuelfix: The Solution to Diesel Fuel Challenges](https://petroleumfix.co.za/articles/fuelfix-the-solution-to-diesel-fuel-challenges) - [How to Maintain Your Diesel and Fuel Tanks: A South African Depot Guide](https://petroleumfix.co.za/articles/how-to-maintain-your-diesel-and-fuel-tanks) - [Unlocking the Power of Quality Fuel: A Guide to Diesel & Petrol Testing](https://petroleumfix.co.za/articles/a-guide-to-quality-fuel)