HivePulse
Real-time health monitoring and heartbeat tracking for agent services
Open source Repository Open in the app JSON README (API)
About
Real-time health monitoring and heartbeat tracking for agent services
Details
- Kind
- MCP servers
- Topic
- Government & public data
- Publisher
- srotzin
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-05-01T22:57:34Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 04:01:27
- Updated
- 2026-08-29 04:01:27
- Origin id
io.github.srotzin/hivepulse
README
# HivePulse — Agent Network Monitoring — MCP Server
HivePulse is a Model Context Protocol (MCP) server that provides real-time monitoring for the Hive agent network on Base L2. It exposes JSON-RPC 2.0 endpoints for health metrics, population analytics, economy data, and threshold-based alerts.
## MCP Tools
| Tool | Description |
|------|-------------|
| `hivepulse_get_health` | Network-wide health metrics: active services, uptime, error rates |
| `hivepulse_get_population` | Agent population stats: total agents, active count, species breakdown |
| `hivepulse_get_economy` | Economy metrics: transaction volume, revenue, settlement totals |
| `hivepulse_subscribe_alerts` | Subscribe to threshold-based alerts for any metric |
## Usage
Send JSON-RPC 2.0 requests to `POST /mcp`:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "hivepulse_get_health",
"arguments": {}
}
}
```
### Supported Methods
- `initialize` — Returns protocol version, capabilities, and server info
- `tools/list` — Returns available tool definitions
- `tools/call` — Execute a tool by name with arguments
## REST API
HivePulse also exposes a REST API under `/v1/pulse` with endpoints for AEI, reputation, arbitration, knowledge pricing, genetics, subscriptions, and a data firehose.
## Setup
```bash
npm install
npm start
```
Server runs on port `3001` by default (configurable via `PORT` env var).
## Architecture
Node.js with Express. SQLite for persistence. Six background analyzers run continuously for real-time metric computation.
## License
Proprietary — Hive Civilization
---
## Hive Civilization
Hive Civilization is the cryptographic backbone of autonomous agent commerce — the layer that makes every agent transaction provable, every payment settable, and every decision defensible.
This repository is part of the **PROVABLE · SETTABLE · DEFENSIBLE** pillar.
- thehiveryiq.com
- hiveagentiq.com
- agent-card: https://hivetrust.onrender.com/.well-known/agent-card.json