English Français العربية

Runhooks

السجل الرسمي الإنتاجية

Schedule and manage recurring and one-off HTTP jobs on Runhooks from your AI agent.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @runhooks/mcp
Claude Code 
claude mcp add runhooks -e 'RUNHOOKS_API_KEY=<your runhooks_api_key>' -e 'RUNHOOKS_API_URL=<RUNHOOKS_API_URL>' -- npx -y @runhooks/mcp@0.1.10
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "runhooks": {
            "command": "npx",
            "args": [
                "-y",
                "@runhooks/mcp@0.1.10"
            ],
            "env": {
                "RUNHOOKS_API_KEY": "<your runhooks_api_key>",
                "RUNHOOKS_API_URL": "<RUNHOOKS_API_URL>"
            }
        }
    }
}

متغيرات البيئة

  • RUNHOOKS_API_KEY سري Runhooks API key (rh_live_...). Required for all tools except provision_account; get one instantly with the provision_account tool, the dashboard, or the CLI.
  • RUNHOOKS_API_URL API origin override. Defaults to https://api.runhooks.app.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. @runhooks/mcp
  2. Install
  3. Verify
  4. Environment variables
  5. Tools
  6. Links
  7. License

@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 recurring and one-off HTTP jobs 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):

{
  "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 once — it creates an instant account (no email), returns an rh_live_... key, and saves it locally to ~/.runhooks/mcp.json. The key is reused automatically from then on, so every other tool works immediately with no restart and no need to provision again. (Setting RUNHOOKS_API_KEY is still the most portable option across machines, and it always takes precedence over the saved key.)

Verify

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

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

Environment variables

VariableDescriptionDefault
RUNHOOKS_API_KEYYour API key (rh_live_...). Optional — provision_account saves a key locally if unset. Takes precedence over the saved key.—
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).

License

MIT

الأسئلة الشائعة

ما هو Runhooks؟

Schedule and manage recurring and one-off HTTP jobs on Runhooks from your AI agent.

كيف أثبّت Runhooks؟

يعمل على جهازك. في Claude Code: claude mcp add runhooks -e 'RUNHOOKS_API_KEY=<your runhooks_api_key>' -e 'RUNHOOKS_API_URL=<RUNHOOKS_API_URL>' -- npx -y @runhooks/mcp@0.1.10. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Runhooks إلى مفتاح API؟

نعم. يتطلب RUNHOOKS_API_KEY، وتضبطها في إعداداته.

هل Runhooks مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Runhooks؟

ينشره runhooks. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.