# Operations Pulse

A local MCP server that records recurring repo checks as tickets in SQLite. Useful when you want a paper trail from routine inspections.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: Openly-Useful
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Openly-Useful/operations-pulse
- Updated: 2026-08-23
- HTML: https://affpapa.org/en/nevibecode/mcp/operations-pulse

## What it does

Operations Pulse inspects your repository state, docs and the log files you point it at, then keeps the findings in a local SQLite ledger and files tickets for them. The MCP tools describe their own inputs and answer with structured output, so the agent can tell what it asked for and what came back.

The default workflow needs no paid service and no API key: Node.js 24 or newer plus Git and SQLite are enough. The database lives at `.operations-pulse/pulse.sqlite`; point `OPERATIONS_PULSE_DB` elsewhere if you want another location.

Outbound services stay off until you set them up. A connection record keeps an ID, an endpoint and a reference to an environment variable, so the token itself never lands in the catalog. Put your GitHub token in a shell secret and pass it as `OPERATIONS_PULSE_GITHUB_TOKEN`. Nothing in v0.1 writes to a remote system.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add operations-pulse -- npx -y @openly-useful/operations-pulse-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add operations-pulse -- npx -y @openly-useful/operations-pulse-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "operations-pulse": {
            "command": "npx",
            "args": [
                "-y",
                "@openly-useful/operations-pulse-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "operations-pulse": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@openly-useful/operations-pulse-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add operations-pulse npx -y @openly-useful/operations-pulse-mcp
```

## When to use it
- keep a record of each scheduled repo check
- open tickets for documentation gaps the checks found
- scan configured log files and flag errors
- wire up read-only GitHub access without a token in the repo
- see which files a migration imported and which it left out

## Example prompts
- Run a pulse on this repository and summarize what changed
- List the open tickets in the Operations Pulse ledger
- Test the github connection without printing the token

## Similar
- [kubernetes-operations](https://affpapa.org/en/nevibecode/plugins/kubernetes-operations.md) — plugin · ★ 41823
- [Agent Memory MCP](https://affpapa.org/en/nevibecode/mcp/agent-memory-mcp.md) — MCP server · ★ 44
- [cli-anything-pm2](https://affpapa.org/en/nevibecode/skills/cli-anything-pm2.md) — skill · 491 installs
- [ci-cd-and-automation](https://affpapa.org/en/nevibecode/skills/ci-cd-and-automation.md) — skill · 58100 installs
- [dockerfile-optimizer](https://affpapa.org/en/nevibecode/skills/dockerfile-optimizer.md) — skill · 530 installs
- [adding-docker](https://affpapa.org/en/nevibecode/skills/adding-docker.md) — skill · 398 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md