# AgentPulse MCP server

> Lets an AI client observe, search, launch, and steer Claude Code and Codex CLI sessions across a self-hosted fleet dashboard.

- Repository: https://github.com/jstuart0/agentpulse
- Page: https://hostedmcp.org/servers/jstuart0/agentpulse
- Transport: stdio
- Stars: 34
- License: MIT

## Install

### Claude Code

```sh
claude mcp add agentpulse -- npx -y @craze0/agentpulse-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "agentpulse": {
      "command": "npx",
      "args": [
        "-y",
        "@craze0/agentpulse-mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "agentpulse": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@craze0/agentpulse-mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"agentpulse","type":"stdio","command":"npx","args":["-y","@craze0/agentpulse-mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "agentpulse": {
      "command": "npx",
      "args": [
        "-y",
        "@craze0/agentpulse-mcp"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add agentpulse -- npx -y @craze0/agentpulse-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.agentpulse]
command = "npx"
args = ["-y", "@craze0/agentpulse-mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user agentpulse npx -- -y @craze0/agentpulse-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "agentpulse": {
      "command": "npx",
      "args": [
        "-y",
        "@craze0/agentpulse-mcp"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `AGENTPULSE_AI_ENABLED` | no | no |  |
| `AGENTPULSE_OTEL_ENDPOINT` | no | no |  |
| `AGENTPULSE_SECRETS_KEY` | no | no |  |
| `API_TOKEN` | no | no |  |
| `TELEGRAM_BOT_TOKEN` | no | no |  |
| `TELEGRAM_WEBHOOK_SECRET` | no | no |  |

## FAQ

### What can an AI agent do with the AgentPulse MCP server?

It can list and inspect sessions, search history, launch new agent sessions, steer live ones, and decide inbox items through the MCP server.

### How do I install the AgentPulse MCP server without a checkout?

Use the standalone @craze0/agentpulse-mcp npm package; a checkout alternative is the agentpulse mcp serve command.

### Which coding agents does AgentPulse support?

It supports Claude Code, Codex CLI, GitHub Copilot CLI, and OpenCode, though Copilot CLI and OpenCode are observation only.

### Can AgentPulse run self-hosted?

Yes, it can be self-hosted via Docker or Kubernetes with SQLite or PostgreSQL, optionally behind an auth proxy.

### Does AgentPulse show updates in real time?

Yes, sessions and events update live over WebSocket without refreshing the page.
