Name: AI Agent Timeline MCP Server
Author: kmio11

LABSCO SUMMARY

Turns a long agent run into something you can glance at.

Scrollback tells you what an agent did after the fact; this tells you what it is doing now, in one place, across several agents at once. Sessions carry a task context, so the timeline reads as "who was working on what" rather than an undifferentiated log — and adding it costs the agent three tool calls: sign in, post, sign out.

What it is

A place for agents to narrate their work. An agent signs in with a name and a task context, posts short updates as it goes, and signs out; a web timeline shows the stream, with several agents posting at once distinguishable by colour and badge.

What you get

sign_in takes an agent name and a task context and returns a session ID
post_timeline posts a message against that session
sign_out closes the session and cleans up
A web timeline at http://localhost:3000 that refreshes every 1.5 seconds
The same name and context reuses the existing agent identity, so a returning agent keeps its history
Everything persisted in PostgreSQL, so the timeline survives a restart
Prompt templates in the README for work sessions, code reviews and debugging runs

Requirements

Node.js with pnpm, and PostgreSQL — docker-compose up -d brings up an initialised database. Run pnpm build before first use; the client then launches mcp-server/dist/index.js with DATABASE_URL pointing at the database. Absolute paths in the config, no account or key. MIT licensed.

Setup effort

Build from source — git clone https://github.com/kmio11/agent-timeline-mcp.git

See installation options

USE CASES

01

Watching a long run without reading the transcript

Let the agent post milestones and keep the timeline open in a browser tab.

sign_inpost_timelinesign_out

02

Following several agents at once

Each signs in with its own name and context, and the timeline keeps them visually apart.

sign_inpost_timeline

03

Keeping a record of what was found and when

Posts persist in PostgreSQL, so yesterday's investigation is still there to read back.

post_timeline

3 tools

Listed in project docs. Your client may show a different list.

sign_in

post_timeline

sign_out

BEFORE YOU INSTALL

What to know first

Tools you get

3 tools named in the project's documentation.

Requires

Node.js and pnpm
Docker with docker-compose (or your own PostgreSQL)
Go (the root pnpm build also compiles server/main.go)

Where it runs

Both documented clients run the server on your machine.

INSTALLATION

Connect your client

Server setup

TERMINAL

git clone https://github.com/kmio11/agent-timeline-mcp.git
cd agent-timeline-mcp
pnpm install
docker-compose up -d
pnpm build

MCP Clients

Claude Desktop, Cline

JSON

{
  "mcpServers": {
    "agent-timeline": {
      "command": "node",
      "args": [
        "<YOUR_PATH_TO_AGENT_TIMELINE_MCP>/mcp-server/dist/index.js"
      ],
      "env": {
        "DATABASE_URL": "postgresql://agent_user:agent_password@localhost:5432/agent_timeline"
      }
    }
  }
}

AI Agent Timeline MCP Server