# temporal-mcp MCP server

Wall-clock awareness for LLM agents. Two tools: elapsed-time-between-turns + day rollover detection.

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-mirrorethic-temporal-mcp
- Repository: https://github.com/MirrorEthic/temporal-mcp
- Website: https://temporal-mcp.dev

## Install
- Command: `uvx temporal-mcp`
- Endpoint: https://temporal-mcp.dev/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Remote header: Authorization (required; secret)
- Package: Pypi temporal-mcp v0.2.0
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://temporal-mcp.dev/mcp
- Header: Authorization

## Tools
- temporal_tick - Advance the temporal clock for a thread and return a snapshot (now / prev / gap / day_rollover / fresh_thread). Call once per user turn. Pass a stable `thread_key` (e.g. the conversation ID) so gap deltas remain meaningful across page reloads. Endpoint: https://temporal-mcp.dev/mcp
- temporal_peek - Read the current temporal snapshot for a thread WITHOUT advancing state. Use this when you want the gap delta but the call is not the canonical per-turn event. Endpoint: https://temporal-mcp.dev/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.MirrorEthic
- Version: 0.2.0
- Runtime: Pypi
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: May 13, 2026
- Source: https://registry.modelcontextprotocol.io