Runhooks

io.github.runhooksv0.1.3更新於 Oct 8, 2026

Schedule and manage cron jobs and webhooks on Runhooks from your AI agent.

已驗證STDIO僅桌面Developer ToolsCloud & Infrastructure

概覽

AI 產生的概覽

讓助理透過 Runhooks API 建立與管理 Runhooks 排程工作、Webhook、執行紀錄與失敗警示。

功能
這個本機 MCP 伺服器把助理連接到 Runhooks 排程基礎設施。它提供工具來建立、列出、查詢、更新、刪除、暫停與恢復排程工作（cron 或間隔），查看工作的執行歷史，重播過去的執行，查看方案用量與限制，並管理透過電子郵件、Webhook 或 Slack 發送的失敗警示。它也可以建立匿名帳號、顯示目前帳號以及輪換 API 金鑰。
適用情境
當你希望助理在不離開對話的情況下設定或維護排程 HTTP 呼叫與 Webhook、檢視或重播歷史執行、或設定失敗警示時，值得加入。它面向已經在使用或評估 Runhooks 作為排程基礎設施的開發者。
執行需求
以 npm 套件（@runhooks/mcp）由 MCP 用戶端（例如 Claude Desktop 或 Cursor）在本機啟動，因此需要 Node.js 與 npx。它透過 HTTPS 與 Runhooks REST API 通訊。除 provision_account 外，所有工具都需要 RUNHOOKS_API_KEY 環境變數；RUNHOOKS_API_URL 為選用，用來覆寫 API 位址。僅支援桌面端。
安裝前請注意
此伺服器會處理正式 API 金鑰（RUNHOOKS_API_KEY，rh_live_...），該金鑰可存取帳號及其工作；provision_account 會建立免電子郵件的帳號，rotate_key 會使舊金鑰失效。相關工具可以建立、更新、刪除、暫停、恢復與重播工作及警示，因此變更會影響真實的排程 HTTP 呼叫。工作定義與警示設定會傳送到 Runhooks API。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Runhooks，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@runhooks/mcp

Model Context Protocol (MCP) server for Runhooks — reliable HTTP scheduling infrastructure. It lets AI agents (Claude Desktop, Cursor, and any MCP client) schedule and manage cron jobs and webhooks directly.

The server runs locally on your machine: your MCP client spawns it with npx and it talks to the Runhooks REST API over HTTPS. There is no hosted service — just this package.

Install

Add it to your MCP client config. For Claude Desktop (claude_desktop_config.json):

json
{  "mcpServers": {    "runhooks": {      "command": "npx",      "args": ["-y", "@runhooks/mcp"],      "env": { "RUNHOOKS_API_KEY": "rh_live_..." }    }  }}

No API key yet? Leave env out and ask the agent to run the provision_account tool — it creates an instant account (no email) and returns an rh_live_... key. Save that key as RUNHOOKS_API_KEY and restart your client.

Verify

Check the server starts and advertises its tools (replace the key, or omit env and use provision_account from inside your client):

bash
RUNHOOKS_API_KEY=rh_live_... npx -y @runhooks/mcp

Environment variables

VariableDescriptionDefault
RUNHOOKS_API_KEYYour API key (rh_live_...). Required for all tools except provision_account.—
RUNHOOKS_API_URLAPI origin.https://api.runhooks.app

Tools

ToolDescription
provision_accountCreate an anonymous account and get an API key (no email).
whoamiShow the current account.
rotate_keyRotate the API key.
create_jobCreate a scheduled job (cron or interval).
list_jobsList jobs with filters and pagination.
get_jobGet one job by ID.
update_jobUpdate a job.
delete_jobDelete a job.
pause_job / resume_jobPause or resume a job.
list_executionsList a job's run history.
replay_executionRe-run a past execution.
get_usageShow plan usage and limits.
list_alerts / create_alert / get_alert / update_alert / delete_alertManage failure alerts (email, webhook, Slack).

Links

License

MIT

來源：README.md，提交 d9ff52d

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v0.1.3最新Oct 8, 2026