{
  "name": "oruk",
  "version": "1.0.0",
  "description": "Find, verify, stream, and cite corroborated live news events from radio, TV, social, and structured sources.",
  "provider": {
    "organization": "oruk",
    "url": "https://oruk.ai/",
    "contactEmail": "support@oruk.ai"
  },
  "interfaces": {
    "docs": "https://oruk.ai/docs",
    "llms": "https://oruk.ai/llms.txt",
    "fullContext": "https://oruk.ai/llms-full.txt",
    "rest": "https://api.oruk.ai",
    "publicFeed": "https://api.oruk.ai/v1/stories/feed",
    "mcp": {
      "package": "oruk-mcp",
      "command": "npx -y oruk-mcp",
      "transport": "stdio",
      "readOnly": true
    }
  },
  "skills": [
    {
      "id": "get-latest-stories",
      "name": "Get latest stories",
      "description": "Fetch the freshest public Oruk stories, optionally sorted by recency or impact.",
      "examples": [
        "What is breaking right now?",
        "Show the latest high-impact stories from the last two hours."
      ]
    },
    {
      "id": "search-news",
      "name": "Search and filter news",
      "description": "Search authenticated Oruk story data by keyword, category, region, country, urgency, impact, confidence, or topic.",
      "requiresAuth": true,
      "examples": [
        "Find conflict stories in Europe with impact above 7.",
        "Search for tariff news since yesterday."
      ]
    },
    {
      "id": "verify-story",
      "name": "Verify a story",
      "description": "Retrieve corroboration count, source names, source details, quotes, and timeline for a story id.",
      "requiresAuth": true,
      "examples": [
        "Verify evt_8f3a2b and show every confirming source.",
        "Summarize this story only from details Oruk has direct access to."
      ]
    },
    {
      "id": "stream-news",
      "name": "Stream live updates",
      "description": "Subscribe to Server-Sent Events for story, corroboration, and heartbeat events in real time (Developer, Trader, Enterprise tiers).",
      "requiresAuth": true
    }
  ],
  "usage": {
    "citation": "Use https://oruk.ai/story/{evt_id}. Include corroboration.count and at least one source name.",
    "confidence": "For automated summaries, prefer corroboration.count >= 3 and confidence >= 0.85.",
    "sourcePreference": "Broadcast and structured feeds are strongest for facts; social feeds are useful context and should be corroborated.",
    "paywall": "Public homepage wire and /v1/stories/feed are free and real-time. Authenticated /v1/stories lags ~5 min on Free tier; Pro+ is real-time. SSE (/v1/stream) requires Developer, Trader, or Enterprise. Full search, story detail, sources, stats, and webhooks need an API key."
  },
  "boundaries": [
    "Do not scrape dashboards, admin pages, login flows, audit logs, or private API routes.",
    "Treat Oruk as live intelligence, not an official emergency alert system.",
    "Do not infer facts beyond story fields, corroboration details, source quotes, and timestamps returned by Oruk."
  ],
  "payment": {
    "current": "API key plus Stripe subscription tiers.",
    "machinePayments": "HTTP 402/x402 and Stripe Machine Payments Protocol are planned but not active production billing paths."
  }
}