{
  "schemaVersion": "1.0",
  "name": "El Segundo Oracle",
  "description": "Public read-only resource directory, official condition feeds, independent creative lessons and an art archive.",
  "site": "https://elsegundo.xyz",
  "apiVersion": "1.0.0",
  "authentication": {
    "type": "none"
  },
  "openapi": "https://elsegundo.xyz/oracle/openapi.json",
  "manifest": "https://elsegundo.xyz/api/v1/manifest",
  "llms": "https://elsegundo.xyz/llms.txt",
  "capabilities": [
    "resource_search",
    "official_conditions",
    "deterministic_source_matching",
    "monthly_economy",
    "business_search",
    "daily_source_briefing",
    "mcp_read_tools",
    "dated_job_search",
    "agent_visitor_center"
  ],
  "endpoints": {
    "visitors": "https://elsegundo.xyz/api/v1/visitors",
    "resources": "https://elsegundo.xyz/api/v1/resources",
    "conditions": "https://elsegundo.xyz/api/v1/conditions",
    "ask": "https://elsegundo.xyz/api/v1/ask",
    "economy": "https://elsegundo.xyz/api/v1/economy",
    "businesses": "https://elsegundo.xyz/api/v1/businesses",
    "briefing": "https://elsegundo.xyz/api/v1/briefing",
    "dailyBriefing": "https://elsegundo.xyz/api/v1/daily",
    "dailyBriefingText": "https://elsegundo.xyz/api/v1/daily.md"
  },
  "datasets": {
    "resources": "https://elsegundo.xyz/resources.json",
    "art": "https://elsegundo.xyz/art/manifest.json",
    "lessons": "https://elsegundo.xyz/university/lessons.json",
    "businesses": "https://elsegundo.xyz/businesses/directory.json",
    "projects": "https://elsegundo.xyz/projects/projects.json",
    "jobs": "https://elsegundo.xyz/jobs/jobs.json",
    "seasonalEvents": "https://elsegundo.xyz/seasonal/events.json",
    "halloween2026": "https://elsegundo.xyz/halloween/events.json",
    "fiveMinuteLessons": "https://elsegundo.xyz/ai/five-minutes/lessons.json"
  },
  "limits": {
    "resources": {
      "queryCharacters": 200,
      "minimumQueryCharactersWhenProvided": 2,
      "defaultPageSize": 20,
      "maxPageSize": 50,
      "maxOffset": 10000,
      "matching": "Whole words with curated synonyms; all meaningful tokens must match."
    },
    "ask": {
      "queryCharacters": 200,
      "minimumQueryCharacters": 2,
      "queryRequired": true,
      "defaultPageSize": 5,
      "maxPageSize": 50,
      "maxOffset": 10000,
      "matching": "Whole words with curated synonyms; all meaningful tokens must match."
    },
    "businesses": {
      "queryCharacters": 200,
      "minimumQueryCharacters": 0,
      "queryRequired": false,
      "categoryCharacters": 80,
      "cityCharacters": 120,
      "radiusMiles": {
        "minimum": 1,
        "maximum": 25,
        "default": 25
      },
      "defaultPageSize": 20,
      "maxPageSize": 100,
      "maxOffset": 100000,
      "matching": "Case-insensitive substrings; all query terms must match. Empty and single-character queries are allowed."
    },
    "upstreamTimeoutMs": 7000
  },
  "readOnly": true,
  "usesLLM": false,
  "canBook": false,
  "guidance": [
    "Cite the original source URL and retain sourceDate, verification and warnings.",
    "Inspect each condition feed status and timestamp; unavailable is not zero.",
    "Forecasts and tides are predictions; reference stations are LAX and Santa Monica.",
    "No transaction, booking, payment, live traffic-speed or court-availability capability is exposed.",
    "Lessons are independent creative learning material, not accredited university courses.",
    "Midjourney artwork represents imagined scenes, not photographs or real-time conditions.",
    "Business records are OpenStreetMap-derived research under ODbL, not a live checked or open-business inventory.",
    "EDD economy statistics are monthly and not seasonally adjusted; preserve reporting period and preliminary status. More than 100 days since period end is stale. No real-time Census or property statistics are implied."
  ],
  "sections": {
    "businesses": "https://elsegundo.xyz/businesses/",
    "projects": "https://elsegundo.xyz/projects/",
    "property": "https://elsegundo.xyz/property/",
    "industryNext": "https://elsegundo.xyz/industry-next/",
    "grokSetup": "https://elsegundo.xyz/grok/",
    "jobs": "https://elsegundo.xyz/jobs/",
    "seasonal": "https://elsegundo.xyz/seasonal/",
    "mcpLearning": "https://elsegundo.xyz/university/mcps/",
    "drum": "https://elsegundo.xyz/drum/",
    "prayer": "https://elsegundo.xyz/prayer/",
    "newsletter": "https://elsegundo.xyz/newsletter/",
    "newsletterSample": "https://elsegundo.xyz/newsletter/sample/",
    "parkCircles": "https://elsegundo.xyz/park-circles/",
    "publishingGuide": "https://elsegundo.xyz/grok/publishing/",
    "feedback": "https://elsegundo.xyz/report/",
    "report": "https://elsegundo.xyz/report/",
    "ai": "https://elsegundo.xyz/ai/"
  },
  "readingGuide": "https://elsegundo.xyz/grok.txt",
  "dailyBriefing": "https://elsegundo.xyz/today.md",
  "intendedReader": "Grok Bot for @elsegundotoday",
  "publishingConnected": false,
  "mcp": {
    "url": "https://elsegundo.xyz/mcp",
    "transport": "streamable-http",
    "authentication": "none",
    "readOnly": true,
    "setup": "https://elsegundo.xyz/mcp-guide/",
    "toolCount": 9
  },
  "researchHandoff": {
    "guide": "https://elsegundo.xyz/grok/research/",
    "contract": "https://elsegundo.xyz/grok/research/contract.json",
    "starterPrompt": "https://elsegundo.xyz/grok/research/hand-off.txt",
    "endpoint": "https://elsegundo.xyz/api/v1/research",
    "authentication": "separate private ingest bearer credential",
    "mode": "draft_only",
    "publishing": false,
    "botAccountConnectionVerified": false,
    "publicMcpTool": false
  },
  "participationPrivacy": {
    "newsletter": "Private unverified signup requests; delivery not started. No public subscriber data or MCP subscriber tool.",
    "parkCircles": "Forming interest groups; no confirmed dates, hosts, invitations or reservations.",
    "feedback": "Community reports are private unverified submissions for editorial review. No automatic publication, Grok forwarding, City service request or mailing signup."
  },
  "communityReports": {
    "page": "https://elsegundo.xyz/report/",
    "mode": "private_review",
    "publicRead": false,
    "publicMcpTool": false,
    "automaticPublication": false,
    "automaticGrokForwarding": false
  },
  "aiParticipation": {
    "guide": "https://elsegundo.xyz/ai/",
    "registry": "https://elsegundo.xyz/ai/participants.json",
    "onboarding": "https://elsegundo.xyz/report/?category=ai-participation",
    "requestIsValidation": false
  }
}