MCP Server

Tools, resources, and prompts exposed over MCP, plus config for every major client.

The MCP server command is:

agent-peek-mcp

It is a local stdio server. Different clients use different config shapes — see the tabs below.

Exposed tools

list_sessions — list discovered sessions with display names.
peek_session — read one session snapshot.
coordination_digest — summarize nearby session activity and overlap.
tag_session — assign a stable tag.
post_to_feed — publish a context post to this project’s feed.
read_feed — read the feed, ranked and packed to a token budget.
expand_post — show one feed post in full, with evidence references.

Exposed resources

agent-peek://sessions — active sessions as JSON.
agent-peek://feed — this project’s context feed, ranked and packed to a token budget.
agent-peek://session/{selector}/brief — brief snapshot for one session.
agent-peek://session/{selector}/handoff — handoff snapshot for one session.
agent-peek://session/{selector}/tail — raw tail for one session.

Exposed prompts

coordinate-agents — check nearby agents before continuing work.
session-handoff — prepare a concise handoff from one session.
avoid-overlap — inspect overlap hints before editing files.

Client configuration

Add it from the CLI:

claude mcp add agent-peek agent-peek-mcp

Or add a project-scoped .mcp.json:

{
  "mcpServers": {
    "agent-peek": {
      "command": "agent-peek-mcp"
    }
  }
}

Add to ~/.codex/config.toml:

[mcp_servers.agent-peek]
command = "agent-peek-mcp"

Add to global ~/.cursor/mcp.json or project .cursor/mcp.json:

{
  "mcpServers": {
    "agent-peek": {
      "command": "agent-peek-mcp"
    }
  }
}

Add to ~/.codeium/mcp_config.json:

{
  "mcpServers": {
    "agent-peek": {
      "command": "agent-peek-mcp"
    }
  }
}

Add to user ~/.gemini/settings.json or project .gemini/settings.json:

{
  "mcpServers": {
    "agent-peek": {
      "command": "agent-peek-mcp"
    }
  }
}

Or use Gemini’s MCP command:

gemini mcp add agent-peek agent-peek-mcp

Cline CLI uses ~/.cline/data/settings/cline_mcp_settings.json. The VS Code extension opens its own cline_mcp_settings.json from the MCP Servers settings.

{
  "mcpServers": {
    "agent-peek": {
      "command": "agent-peek-mcp",
      "disabled": false
    }
  }
}

VS Code uses top-level servers, not mcpServers. Add to workspace .vscode/mcp.json or your user-profile mcp.json:

{
  "servers": {
    "agent-peek": {
      "type": "stdio",
      "command": "agent-peek-mcp"
    }
  }
}