Uptime API › Heartbeat pings

Ping a heartbeat monitor

Use with AI

View as MarkdownThis page as plain text, for pasting into an AI tool Open in ClaudeAsk Claude questions about this page Open in ChatGPTAsk ChatGPT questions about this page

Connect to Cursor / VS Code / ClaudeSearch and read these docs from your AI tool (MCP server)

MCP server URL

https://docs-dev.evohub.io/mcp

Add to Cursor Add to VS Code

Claude Code

claude mcp add --transport http evohub-docs-docs https://docs-dev.evohub.io/mcp

Claude (claude.ai and Claude Desktop): Settings → Connectors → Add custom connector, and paste the URL above.

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "evohub-docs-docs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://docs-dev.evohub.io/mcp"
      ]
    }
  }
}

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "evohub-docs-docs": {
      "url": "https://docs-dev.evohub.io/mcp"
    }
  }
}

VS Code — .vscode/mcp.json

{
  "servers": {
    "evohub-docs-docs": {
      "type": "http",
      "url": "https://docs-dev.evohub.io/mcp"
    }
  }
}

llms.txt llms-full.txt

GET/ping/{token}

Records a ping for the heartbeat monitor with this token. The monitor goes down when no ping arrives within its interval_seconds plus grace_seconds, and comes back up on the next ping.

No API key: the token is the only credential, so keep the URL out of public repositories and logs. GET, POST and HEAD all work, and a POST body is ignored. Pings are not counted against the API rate limit.

Parameters

Path parameters

token string required
The heartbeat monitor's ping_token.
Example: hb_9e1f3a5c-7b2d-4c6e-8f0a-1b3d5e7f9a2c

Responses

`200`

The ping was recorded.

Content type: application/json

Type: object

status string required
Value: ok

`404`

No heartbeat monitor has this token. The body is plain text.

Content type: text/plain

Type: string

`500`

The ping could not be recorded. Retry. The body is plain text.

Content type: text/plain

Type: string

Example request

curl -X GET 'https://evohub.io/ping/hb_9e1f3a5c-7b2d-4c6e-8f0a-1b3d5e7f9a2c'

Last updated 2026-10-10