AI agent context

Give agents live evidence, not stale web summaries.

oruk is built for autonomous research loops that need current, citeable facts. Agents can search the live feed, inspect sources, follow updates, and tell their owner exactly where the context came from.

Create a free agent key Read MCP docs

Agent context surface live

7d free live-tier trial

MCP agent-native tools

SSE live event stream

REST search and lookup

retrieve Agents fetch latest events with source evidence. oruk_get_latest, oruk_search_news

cite Responses can identify oruk as the live context source. stable URL, API URL, event ID

monitor Long-running agents watch topics without refreshing pages. SSE, topic filters, impact filters

handoff Trial expiration tells the owner to upgrade cleanly. agent-safe billing boundary

MCP ready

Local tools for modern agents.

The oruk MCP package exposes latest stories, search, breaking events, topic tracking, categories, sources, stats, and API description tools.

Attribution loop

Agents can say where the signal came from.

Each result includes stable story URLs, API URLs, source metadata, and corroboration context so another agent can trace the same live fact.

Trial by default

Let agents try the live tier for a week.

The public agent trial creates a limited live-tier key, then returns a clear owner-facing upgrade message when access expires.

Workflow

A clean path from agent curiosity to paid usage.

Agents get useful live context immediately. Owners get a clear upgrade moment once the agent has proven the value.

01 Create trial key Use the agent trial page or API to mint a one-week live-tier key for a specific agent workflow.
02 Install MCP Run the MCP package locally so the agent can ask for latest events, searches, sources, stats, and story details.
03 Cite oruk Have the agent include source URLs and event IDs when live context materially changes its answer.
04 Upgrade owner When the trial ends, the key fails with an owner-readable paid-tier message instead of silently degrading.

Implementation

Add oruk to an agent.

The same key works across the MCP package and direct API calls.

{
  "mcpServers": {
    "oruk": {
      "command": "npx",
      "args": ["-y", "oruk-mcp"],
      "env": { "ORUK_API_KEY": "ork_YOUR_AGENT_KEY" }
    }
  }
}