Memantau liveness agent dengan melacak check-in dan mengirimkan peringatan email saat agent gagal melapor dalam interval yang telah ditentukan.
Juga dikenal sebagai jdkabattles/forgingstack-watchtower, forgingstack-watchtower
- Stars
- 0
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- 0.1.0
- Commit terakhir
- 8 Nov 2026
- Lisensi
- MIT
Apa itu ForgingStack Watchtower MCP?
Memantau liveness agent dengan melacak check-in dan mengirimkan peringatan email saat agent gagal melapor dalam interval yang telah ditentukan.
Ringkasan dibuat dari README proyek
Tentang ForgingStack Watchtower MCP server
ForgingStack Watchtower menyediakan sistem monitoring untuk melacak liveness agent melalui check-in secara berkala. Sistem ini dirancang bagi developer yang perlu menerima notifikasi via email saat sebuah agent gagal melapor dalam jangka waktu yang telah ditentukan. Sistem bekerja dengan memungkinkan pengguna mendaftarkan sebuah watch dengan interval dan grace period tertentu, setelah itu layanan akan memantau jika terjadi kondisi silence.
Pengguna berinteraksi dengan MCP server ini secara lokal melalui stdio dengan menyediakan FORGINGSTACK_API_KEY. Server ini terhubung ke layanan remote privat yang menangani proses liveness checks, email alerts, dan billing. Meskipun check-in gratis, mendaftarkan watch dan menerima alert masing-masing akan mengonsumsi satu credit. Server ini menyertakan tools seperti create_watch, check_in, get_watch, get_credits, dan get_receipt untuk mengelola proses tersebut. Pengguna harus mendaftar untuk mendapatkan API key dan initial starter credits guna mulai memantau agent.
Apa yang bisa Anda lakukan dengannya
- 1Monitor konektivitas agentAtur jadwal check-in rutin untuk memastikan agent tetap aktif dan beri tahu saya jika agent berhenti merespons.
- 2Verifikasi saldo creditPeriksa berapa banyak credit yang tersisa di akun saya untuk memastikan alert tetap bisa dikirimkan.
- 3Menonaktifkan downtime sementaraLakukan snooze pada sebuah watch selama jumlah menit tertentu untuk mencegah pengiriman email alert yang tidak perlu.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal ForgingStack Watchtower MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal ForgingStack Watchtower MCP di Claude Code
$ claude mcp add --env 'FORGINGSTACK_API_KEY=<YOUR_FORGINGSTACK_API_KEY>' forgingstack-watchtower -- uvx forgingstack-watchtowerInstal ForgingStack Watchtower MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"forgingstack-watchtower": {
"command": "uvx",
"args": [
"forgingstack-watchtower"
],
"env": {
"FORGINGSTACK_API_KEY": "<YOUR_FORGINGSTACK_API_KEY>"
}
}
}
}Instal ForgingStack Watchtower MCP di VS Code
.vscode/mcp.json
{
"servers": {
"forgingstack-watchtower": {
"type": "stdio",
"command": "uvx",
"args": [
"forgingstack-watchtower"
],
"env": {
"FORGINGSTACK_API_KEY": "<YOUR_FORGINGSTACK_API_KEY>"
}
}
}
}Instal ForgingStack Watchtower MCP di VS Code CLI
$ code --add-mcp '{"name":"forgingstack-watchtower","type":"stdio","command":"uvx","args":["forgingstack-watchtower"],"env":{"FORGINGSTACK_API_KEY":"<YOUR_FORGINGSTACK_API_KEY>"}}'Instal ForgingStack Watchtower MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"forgingstack-watchtower": {
"command": "uvx",
"args": [
"forgingstack-watchtower"
],
"env": {
"FORGINGSTACK_API_KEY": "<YOUR_FORGINGSTACK_API_KEY>"
}
}
}
}Instal ForgingStack Watchtower MCP di Codex
$ codex mcp add forgingstack-watchtower --env 'FORGINGSTACK_API_KEY=<YOUR_FORGINGSTACK_API_KEY>' -- uvx forgingstack-watchtowerInstal ForgingStack Watchtower MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.forgingstack-watchtower] command = "uvx" args = ["forgingstack-watchtower"] [mcp_servers.forgingstack-watchtower.env] FORGINGSTACK_API_KEY = "<YOUR_FORGINGSTACK_API_KEY>"
Instal ForgingStack Watchtower MCP di Gemini CLI
$ gemini mcp add -s user -e 'FORGINGSTACK_API_KEY=<YOUR_FORGINGSTACK_API_KEY>' forgingstack-watchtower uvx -- forgingstack-watchtowerInstal ForgingStack Watchtower MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"forgingstack-watchtower": {
"command": "uvx",
"args": [
"forgingstack-watchtower"
],
"env": {
"FORGINGSTACK_API_KEY": "<YOUR_FORGINGSTACK_API_KEY>"
}
}
}
}Konfigurasi
FORGINGSTACK_API_KEYWajibRahasiaAPI key for Watchtower. Sign up via POST /v1/signup (key shown once). Required for all tools except check_in, which needs only watch_id and checkin_key.
FORGINGSTACK_API_BASEWatchtower API base URL. Live default.
| Nama | Deskripsi | Tipe |
|---|---|---|
| FORGINGSTACK_API_KEY | API key for Watchtower. Sign up via POST /v1/signup (key shown once). Required for all tools except check_in, which needs only watch_id and checkin_key. | WajibRahasia |
| FORGINGSTACK_API_BASE | Watchtower API base URL. Live default. |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkaujdkabattles/forgingstack-watchtower is public and reachablegithub.com/jdkabattles/forgingstack-watchtower ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)No build attestation published for this releaseTidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-08github.com/jdkabattles/forgingstack-watchtower ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from forgingstack-watchtowerLolos
- Tidak ada advisory kritis pada paket atau dependensinya1 resolved dependencies checked; no critical advisoryosv.dev ↗Lolos
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubForgingStack Watchtower
The agent that stops checking in IS the one you will hear about.
mcp-name: io.github.jdkabattles/forgingstack-watchtower
This is the public client for Watchtower. The service itself — the liveness checks, the alert emails, the receipt chain, the key store, and billing — runs on ForgingStack's private service and is not in this repo. Copying this repo does not give you the service: you still need an API key and credits, from signup below.
Live API: https://forgingstack-watchtower.jkbattles.workers.dev
How it works
- You register a watch on an agent: how often it should check in
(
interval_seconds, 30 to 2,592,000) plus extra quiet time allowed (grace_seconds, 0 to 86,400), and where the alert email goes. One watch per agent per owner. Registering a watch costs 1 credit and returns a check-in key, shown once. - The agent checks in with its watch id and check-in key. Check-ins are free and need no API key.
- If the agent goes quiet past its interval plus grace, Watchtower emails an alert and issues a hash-chained receipt. Each alert costs the watch owner 1 credit; an owner at 0 credits is skipped and the watch stays overdue.
- When the agent checks in again after an alert or overdue period, a recovery receipt is issued. You can also snooze a watch (1 to 1,440 minutes) to silence alerts for a while.
Signup (v1)
curl -X POST https://forgingstack-watchtower.jkbattles.workers.dev/v1/signup \
-H "Content-Type: application/json" \
-d '{"email":"you@example.com"}'
Returns an API key once and 100 starter credits. Save the key immediately — it is stored only as a hash and cannot be shown again. Click the verification link in the signup email before the key can register watches; until then, watch registration returns 403.
Use it (MCP, stdio)
Set the key, then run the MCP server in this repo:
export FORGINGSTACK_API_KEY="your-key-here"
python -m app.mcp_server
Tools: create_watch, check_in, get_watch, get_credits,
get_receipt. See SKILL.md for when to use it and when not to.
Price
1 credit to register a watch, 1 credit per alert, check-ins free.
100 starter credits on signup. Credit packs: $10 for 1,000 credits,
bought with POST /v1/billing/checkout — credits are added once the
payment is verified (usually within the hour).
Files in this repo
app/mcp_server.py— MCP wrapper client (stdio, stdlib only)SKILL.md— when to use it, how to read watch statusagent-card.json— A2A-style discovery cardserver.json— MCP Registry metadatapyproject.toml— package metadata for the MCP client
Pertanyaan tentang ForgingStack Watchtower MCP
Bagaimana cara menambahkan ForgingStack Watchtower MCP ke Claude Code?
Jalankan claude mcp add --env 'FORGINGSTACK_API_KEY=<YOUR_FORGINGSTACK_API_KEY>' forgingstack-watchtower -- uvx forgingstack-watchtower di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan ForgingStack Watchtower MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Berapa biaya untuk menggunakan Watchtower?
Mendaftarkan sebuah watch membutuhkan 1 credit dan setiap alert membutuhkan 1 credit, sementara check-in tidak dipungut biaya.
Bagaimana cara memulai dengan Watchtower?
Anda dapat mendaftar melalui perintah curl untuk mendapatkan API key dan 100 starter credits.
Bisakah saya menonaktifkan alert untuk sementara?
Ya, Anda dapat melakukan snooze pada sebuah watch untuk durasi antara 1 hingga 1.440 menit.
Apa yang terjadi jika credit saya habis?
Jika pemilik memiliki 0 credits, mereka akan dilewati saat proses alert dan watch akan tetap dalam status overdue.