Time Awareness for AI Agents

Give your agent the tools manifest

GET /v1/tools returns an OpenAI or Anthropic function-calling manifest of every API operation your key is entitled to call. Pass it to your model at startup and the agent discovers, selects, and invokes the right temporalBLOCK endpoints on its own — no custom dispatcher required.

// Let your agent discover and call temporalBLOCK tools autonomously.
// Fetch the manifest at agent startup, pass it to the model.

const { tools, baseUrl } = await fetch(
  "https://api.temporalblock.com/api/v1/tools?format=anthropic",
  { headers: { "X-API-Key": process.env.TBLK_API_KEY } }
).then((r) => r.json());

// Pass to your model — it will call the right endpoints itself.
const response = await anthropic.messages.create({
  model: "claude-opus-4-5",
  max_tokens: 1024,
  tools,
  messages: [{ role: "user", content: "Remind me every Friday at 9 AM." }],
});

The same catalog is also available as a native MCP server at POST /api/v1/mcp. Add it to Claude Desktop or Cursor with a single config entry — see below.

Temporal triggers — server-side, always-on

Temporal Skills let an agent create its own timers, alarms, and recurring schedules by POSTing a trigger predicate to /v1/skills. The server evaluates the trigger — the agent's process doesn't need to stay alive. Fires are delivered as signed webhooks with a consistent retry backoff.

// Create a recurring timer that fires a webhook.
// The trigger is a Spiral-coordinate predicate — no raw UTC cron strings.

const { skill, webhookSecret } = await fetch(
  "https://api.temporalblock.com/api/v1/skills",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-API-Key": process.env.TBLK_API_KEY,
    },
    body: JSON.stringify({
      name: "weekly-friday-standup",
      trigger: {
        kind: "recur",
        rung: "wk",
        phase: 4 / 7,   // Friday
      },
      webhookUrl: "https://your-agent.example.com/fire",
    }),
  }
).then((r) => r.json());

// webhookSecret is shown once — verify X-Tblk-Signature on every delivery.
// Fires regardless of device state: screen off, app killed, or offline.

Phase-based triggers fire against θ (theta) — the angular time coordinate of the Temporal Spiral. whenPhaseRecurs fires when θ crosses a configured angle threshold; whenSequenceRecurs fires on a detected motif in the θ trajectory — no UTC cron strings required.

Strict event ordering with Causal Block

When multiple agent steps or distributed nodes write events, wall-clock timestamps collide within the same millisecond. Causal Block issues Hybrid Logical Clock tuples that always strictly increase — even on the same machine in the same millisecond — so your agent's event log has a total order you can replay deterministically.

Add to Claude Desktop or Cursor in 30 seconds

temporalBLOCK ships a native MCP server at POST /api/v1/mcp. Paste the config below, swap in your key, and the host discovers every tool your tier is entitled to automatically — no wrapper code, no custom dispatcher.

// claude_desktop_config.json  (macOS: ~/Library/Application Support/Claude/)
// .cursor/mcp.json            (Cursor: project root or ~/.cursor/)
{
  "mcpServers": {
    "temporalblock": {
      "url": "https://api.temporalblock.com/api/v1/mcp",
      "headers": {
        "X-API-Key": "tblk_live_your_key_here"
      }
    }
  }
}

// No restart needed in Cursor. In Claude Desktop, quit and reopen.
// Ask Claude: "What time is it right now?" — it will call the tool.

Related