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