{
  "$schema": "https://freshdentalsolutions.com/ai.json",
  "generated": "Fresh Dental Solutions agent discovery graph — see ai.md for the human-readable guide",
  "site": {
    "name": "Fresh Dental Solutions",
    "tagline": "Family-owned dental care in Portland, OR",
    "url": "https://freshdentalsolutions.com/",
    "locale": "en-US",
    "contact": {
      "phone": "(503) 555-FRESH",
      "email": "info@freshdentalsolutions.com",
      "address": "Portland, Oregon",
      "hours": "Mon–Fri: 8am–6pm · Sat: 9am–2pm"
    }
  },
  "content": {
    "markdown": {
      "index": "https://freshdentalsolutions.com/llms.txt",
      "guide": "https://freshdentalsolutions.com/ai.md",
      "pages": [
        {
          "id": "home",
          "html": "https://freshdentalsolutions.com/index.html",
          "markdown": "https://freshdentalsolutions.com/index.md"
        },
        {
          "id": "about",
          "html": "https://freshdentalsolutions.com/about.html",
          "markdown": "https://freshdentalsolutions.com/about.md"
        },
        {
          "id": "services",
          "html": "https://freshdentalsolutions.com/services.html",
          "markdown": "https://freshdentalsolutions.com/services.md"
        },
        {
          "id": "contact",
          "html": "https://freshdentalsolutions.com/contact.html",
          "markdown": "https://freshdentalsolutions.com/contact.md"
        }
      ]
    },
    "knowledgeBase": {
      "description": "Canonical markdown at kb/<slug>.md; the HTML pages render from those files.",
      "index": "https://freshdentalsolutions.com/kb/index.html",
      "catalog": "data/kb.js",
      "articleCount": 26,
      "articles": [
        {
          "slug": "brushing-and-flossing",
          "title": "Brushing and Flossing, Done Properly",
          "category": "prevention",
          "topics": [
            "general"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/brushing-and-flossing.md",
          "html": "https://freshdentalsolutions.com/kb/brushing-and-flossing.html"
        },
        {
          "slug": "diet-and-your-teeth",
          "title": "How Food and Drink Shape Your Teeth",
          "category": "prevention",
          "topics": [
            "general",
            "pediatric"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/diet-and-your-teeth.md",
          "html": "https://freshdentalsolutions.com/kb/diet-and-your-teeth.html"
        },
        {
          "slug": "dental-checkups",
          "title": "What Happens at a Dental Checkup",
          "category": "prevention",
          "topics": [
            "general",
            "cost"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/dental-checkups.md",
          "html": "https://freshdentalsolutions.com/kb/dental-checkups.html"
        },
        {
          "slug": "fluoride-explained",
          "title": "Fluoride, Explained",
          "category": "prevention",
          "topics": [
            "general",
            "pediatric"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/fluoride-explained.md",
          "html": "https://freshdentalsolutions.com/kb/fluoride-explained.html"
        },
        {
          "slug": "cavities-and-fillings",
          "title": "Cavities and Fillings: From First Twinge to Fixed Tooth",
          "category": "treatments",
          "topics": [
            "general",
            "restorative"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/cavities-and-fillings.md",
          "html": "https://freshdentalsolutions.com/kb/cavities-and-fillings.html"
        },
        {
          "slug": "root-canal-treatment",
          "title": "Root Canal Treatment, Demystified",
          "category": "treatments",
          "topics": [
            "restorative"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/root-canal-treatment.md",
          "html": "https://freshdentalsolutions.com/kb/root-canal-treatment.html"
        },
        {
          "slug": "teeth-whitening",
          "title": "Teeth Whitening: What Works and What’s Safe",
          "category": "treatments",
          "topics": [
            "cosmetic"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/teeth-whitening.md",
          "html": "https://freshdentalsolutions.com/kb/teeth-whitening.html"
        },
        {
          "slug": "replacing-missing-teeth",
          "title": "Implants, Bridges, and Dentures: Replacing a Missing Tooth",
          "category": "treatments",
          "topics": [
            "restorative",
            "cost"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/replacing-missing-teeth.md",
          "html": "https://freshdentalsolutions.com/kb/replacing-missing-teeth.html"
        },
        {
          "slug": "wisdom-teeth",
          "title": "Wisdom Teeth: Keep Them or Remove Them?",
          "category": "treatments",
          "topics": [
            "general"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/wisdom-teeth.md",
          "html": "https://freshdentalsolutions.com/kb/wisdom-teeth.html"
        },
        {
          "slug": "childs-first-visit",
          "title": "Your Child’s First Dental Visit",
          "category": "kids",
          "topics": [
            "pediatric"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/childs-first-visit.md",
          "html": "https://freshdentalsolutions.com/kb/childs-first-visit.html"
        },
        {
          "slug": "sealants-for-kids",
          "title": "Dental Sealants: A Raincoat for Growing Teeth",
          "category": "kids",
          "topics": [
            "pediatric"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/sealants-for-kids.md",
          "html": "https://freshdentalsolutions.com/kb/sealants-for-kids.html"
        },
        {
          "slug": "dental-emergencies",
          "title": "Dental Emergencies: What To Do Right Now",
          "category": "concerns",
          "topics": [
            "emergency"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/dental-emergencies.md",
          "html": "https://freshdentalsolutions.com/kb/dental-emergencies.html"
        },
        {
          "slug": "tooth-sensitivity",
          "title": "Why Teeth Get Sensitive (and What Helps)",
          "category": "concerns",
          "topics": [
            "general",
            "restorative"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/tooth-sensitivity.md",
          "html": "https://freshdentalsolutions.com/kb/tooth-sensitivity.html"
        },
        {
          "slug": "gum-disease",
          "title": "Bleeding Gums, Gingivitis, and Gum Disease",
          "category": "concerns",
          "topics": [
            "general"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/gum-disease.md",
          "html": "https://freshdentalsolutions.com/kb/gum-disease.html"
        },
        {
          "slug": "dental-anxiety",
          "title": "Dental Anxiety Is Real — Here’s How We Work With It",
          "category": "concerns",
          "topics": [
            "general",
            "pediatric"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/dental-anxiety.md",
          "html": "https://freshdentalsolutions.com/kb/dental-anxiety.html"
        },
        {
          "slug": "how-cavities-form",
          "title": "How a Cavity Actually Forms",
          "category": "caries",
          "topics": [
            "general",
            "restorative"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/how-cavities-form.md",
          "html": "https://freshdentalsolutions.com/kb/how-cavities-form.html"
        },
        {
          "slug": "gingivitis",
          "title": "Gingivitis: The Stage You Can Still Undo",
          "category": "gums",
          "topics": [
            "general"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/gingivitis.md",
          "html": "https://freshdentalsolutions.com/kb/gingivitis.html"
        },
        {
          "slug": "a-knocked-out-tooth",
          "title": "A Knocked-Out Tooth: What To Do in the Next Ten Minutes",
          "category": "concerns",
          "topics": [
            "emergency",
            "pediatric"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/a-knocked-out-tooth.md",
          "html": "https://freshdentalsolutions.com/kb/a-knocked-out-tooth.html"
        },
        {
          "slug": "dry-mouth",
          "title": "Dry Mouth Is a Dental Problem, Not Just a Nuisance",
          "category": "concerns",
          "topics": [
            "general"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/dry-mouth.md",
          "html": "https://freshdentalsolutions.com/kb/dry-mouth.html"
        },
        {
          "slug": "bad-breath",
          "title": "Bad Breath: Finding the Actual Cause",
          "category": "concerns",
          "topics": [
            "general"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/bad-breath.md",
          "html": "https://freshdentalsolutions.com/kb/bad-breath.html"
        },
        {
          "slug": "living-with-dentures",
          "title": "Living With Dentures: The Practical Guide",
          "category": "treatments",
          "topics": [
            "restorative"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/living-with-dentures.md",
          "html": "https://freshdentalsolutions.com/kb/living-with-dentures.html"
        },
        {
          "slug": "diabetes-and-your-mouth",
          "title": "Diabetes and Your Mouth: A Two-Way Street",
          "category": "systemic",
          "topics": [
            "general"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/diabetes-and-your-mouth.md",
          "html": "https://freshdentalsolutions.com/kb/diabetes-and-your-mouth.html"
        },
        {
          "slug": "pregnancy-and-oral-health",
          "title": "Pregnancy and Your Teeth: Yes, You Should Still Go to the Dentist",
          "category": "systemic",
          "topics": [
            "general",
            "pediatric"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/pregnancy-and-oral-health.md",
          "html": "https://freshdentalsolutions.com/kb/pregnancy-and-oral-health.html"
        },
        {
          "slug": "chemotherapy-and-your-mouth",
          "title": "Cancer Treatment and Your Mouth: What to Expect and What Helps",
          "category": "systemic",
          "topics": [
            "general"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/chemotherapy-and-your-mouth.md",
          "html": "https://freshdentalsolutions.com/kb/chemotherapy-and-your-mouth.html"
        },
        {
          "slug": "what-is-in-toothpaste",
          "title": "What Is Actually in Your Toothpaste",
          "category": "products",
          "topics": [
            "general",
            "cosmetic"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/what-is-in-toothpaste.md",
          "html": "https://freshdentalsolutions.com/kb/what-is-in-toothpaste.html"
        },
        {
          "slug": "why-prevention-saves-money",
          "title": "Why Prevention Is the Cheapest Dentistry You Will Ever Buy",
          "category": "practical",
          "topics": [
            "cost",
            "general"
          ],
          "markdown": "https://freshdentalsolutions.com/kb/why-prevention-saves-money.md",
          "html": "https://freshdentalsolutions.com/kb/why-prevention-saves-money.html"
        }
      ]
    }
  },
  "data": {
    "description": "Curated public dental datasets as static, versioned JSON. GET-only, no keys, CORS-open.",
    "catalog": "https://freshdentalsolutions.com/api/index.json",
    "datasetCount": 9,
    "datasets": [
      {
        "id": "tooth-notation",
        "title": "Tooth notation systems (Universal · FDI · Palmer)",
        "endpoint": "https://freshdentalsolutions.com/api/datasets/tooth-notation.json",
        "recordCount": 52
      },
      {
        "id": "tooth-eruption",
        "title": "Tooth eruption chronology",
        "endpoint": "https://freshdentalsolutions.com/api/datasets/tooth-eruption.json",
        "recordCount": 26
      },
      {
        "id": "oral-health-indicators",
        "title": "Headline global oral health indicators",
        "endpoint": "https://freshdentalsolutions.com/api/datasets/oral-health-indicators.json",
        "recordCount": 4
      },
      {
        "id": "kb-sources",
        "title": "Knowledge base source registry",
        "endpoint": "https://freshdentalsolutions.com/api/datasets/kb-sources.json",
        "recordCount": 123
      },
      {
        "id": "kb-articles",
        "title": "Knowledge base article catalog",
        "endpoint": "https://freshdentalsolutions.com/api/datasets/kb-articles.json",
        "recordCount": 26
      },
      {
        "id": "icd10cm-dental",
        "title": "Dental and oral ICD-10-CM diagnosis codes",
        "endpoint": "https://freshdentalsolutions.com/api/datasets/icd10cm-dental.json",
        "recordCount": 674
      },
      {
        "id": "oral-health-surveillance",
        "title": "US oral health status — NHANES surveillance estimates",
        "endpoint": "https://freshdentalsolutions.com/api/datasets/oral-health-surveillance.json",
        "recordCount": 2345
      },
      {
        "id": "water-fluoridation",
        "title": "Community water fluoridation coverage, by state and county",
        "endpoint": "https://freshdentalsolutions.com/api/datasets/water-fluoridation.json",
        "recordCount": 2249
      },
      {
        "id": "oral-cancer-rates",
        "title": "Oral and pharyngeal cancer incidence and mortality, United States",
        "endpoint": "https://freshdentalsolutions.com/api/datasets/oral-cancer-rates.json",
        "recordCount": 6464
      }
    ],
    "mcp": {
      "description": "Zero-dependency stdio MCP server wrapping the datasets above.",
      "server": "https://freshdentalsolutions.com/mcp/fresh-datasets.js",
      "readme": "https://freshdentalsolutions.com/mcp/README.md",
      "hosted": "planned — docs/REDESIGN.md Phase 1"
    }
  },
  "capabilities": {
    "webmcp": {
      "description": "navigator.modelContext tools registered on every page; republishes on composition/mode change.",
      "tools": "describe_site, set_intent, set_mode, plus one fresh_* tool per capability below"
    },
    "mcpApp": {
      "description": "MCP Apps UI artifact for chat clients (client-side contract only; no hosted server yet).",
      "manifest": "https://freshdentalsolutions.com/mcp-app/manifest.json"
    },
    "actions": [
      {
        "id": "book",
        "label": "Schedule Appointment",
        "kind": "navigate",
        "target": "https://freshdentalsolutions.com/contact.html"
      },
      {
        "id": "view-services",
        "label": "Our Services",
        "kind": "navigate",
        "target": "https://freshdentalsolutions.com/services.html"
      },
      {
        "id": "call",
        "label": "Call (503) 555-FRESH",
        "kind": "tel",
        "target": "tel:5035553737"
      },
      {
        "id": "emergency-help",
        "label": "Emergency — call us now",
        "kind": "emergency"
      },
      {
        "id": "learn-about",
        "label": "Learn More About Us",
        "kind": "navigate",
        "target": "https://freshdentalsolutions.com/about.html"
      },
      {
        "id": "read-kb",
        "label": "Browse the Knowledge Base",
        "kind": "navigate",
        "target": "https://freshdentalsolutions.com/kb/index.html"
      },
      {
        "id": "submit-appointment",
        "label": "Request Appointment",
        "kind": "submit"
      }
    ]
  },
  "interaction": {
    "modes": [
      {
        "id": "browse",
        "label": "Browse",
        "kind": "page",
        "description": "The morphic page: sections reorder and re-emphasize themselves around what you seem to need."
      },
      {
        "id": "chat",
        "label": "Chat",
        "kind": "conversation",
        "description": "The whole site becomes a conversation. Ask in plain words; answers are drawn from this practice’s own content and knowledge base, with the matching buttons attached."
      },
      {
        "id": "voice",
        "label": "Voice",
        "kind": "conversation",
        "description": "Hands-free. Speak a question, hear the answer, and act on it without touching the screen. Uses the browser’s own speech engine — no audio reaches Fresh."
      },
      {
        "id": "mcp",
        "label": "MCP",
        "kind": "handover",
        "description": "Hand the site to your own AI instead: the live WebMCP toolset in this tab, plus the zero-dependency stdio server for the Open Data API."
      }
    ],
    "modeParam": "?mode=<id> selects a mode on load; window.FreshOutlet.setMode(id) switches at runtime",
    "plugContract": "window.FreshOutlet.connect(plug) or window.FRESH_BYO_PLUG — see AI_FIRST.md",
    "agui": {
      "subscribe": "window.FreshAGUI.subscribe(cb)",
      "version": "3.0"
    },
    "portableTree": {
      "spec": "fresh.ui/v1",
      "sample": "https://freshdentalsolutions.com/examples/portable-tree.sample.json"
    }
  },
  "policies": {
    "booking": "Request-only. Submitting the appointment capability files a request; a human confirms every appointment. Never represent one as confirmed.",
    "clinical": "The knowledge base is education, not diagnosis. Route symptom questions to a visit.",
    "emergency": "Never auto-dial from a detected intent — emergency-help is offered as a button; dialing is a human click.",
    "domScraping": "Not needed: everything renderable and doable is in this graph, the markdown twins, and the data catalog."
  },
  "docs": {
    "integrationGuide": "https://freshdentalsolutions.com/ai.html",
    "integrationGuideMarkdown": "https://freshdentalsolutions.com/ai.md",
    "architecture": "https://freshdentalsolutions.com/AI_FIRST.md",
    "redesignPlan": "https://freshdentalsolutions.com/docs/REDESIGN.md"
  }
}