# Runhooks

> Runhooks is a freemium MCP server for developer tools. Let an agent schedule cron, interval and one-off HTTP jobs on Runhooks. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $19 a month
- **Platforms:** CLI, API
- **Website:** https://runhooks.app/docs/mcp
- **Repository:** https://github.com/runhooks/runhooks-mcp
- **MCP Registry name:** io.github.runhooks/runhooks-mcp
- **Categories:** developer tools, productivity
- **Listing updated:** 2026-11-14

## About

Scheduling a webhook normally means writing code or clicking through a dashboard. Here the agent can do it from a prompt such as a POST to a sync endpoint every five minutes, or a one-time warm-up call on a chosen date. The package runs locally as a subprocess and calls the Runhooks REST API over HTTPS, so there is nothing to host.

Accounts can be created by the agent itself: provision_account makes an anonymous account without email and saves the key to ~/.runhooks/mcp.json, so the other tools work straight away. Eighteen tools cover jobs, run history with replay, usage, and failure alerts by email, webhook or Slack.

Usage counts against your Runhooks plan. The pricing page shows a Free tier (10 jobs, 2,000 runs a month, 24-hour log retention) and paid tiers from $19 a month with higher run, retention and concurrency limits.

## Features

- **Cron and interval jobs:** Create recurring HTTP jobs or one-off runs at a future time.
- **Run history and replay:** List a job's executions and re-run a past one.
- **Failure alerts:** Configure alerts by email, webhook or Slack.
- **Instant accounts:** provision_account issues an API key with no email.
- **Usage view:** get_usage shows plan usage and limits.
- **No hosting:** Runs locally through npx as a thin REST client.

## Good for

- Poll an endpoint every few minutes without writing a scheduler
- Schedule a one-time call for a launch date
- Review failed runs of a billing job
- Pause and resume jobs during maintenance
- Set up alerts for failing webhooks

## Install

### Claude Code (Terminal)

```sh
claude mcp add runhooks-mcp --env RUNHOOKS_API_KEY='<RUNHOOKS_API_KEY>' -- npx -y @runhooks/mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "runhooks-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@runhooks/mcp"
      ],
      "env": {
        "RUNHOOKS_API_KEY": "<RUNHOOKS_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `create_job`: Create a recurring (cron or interval) or one-off scheduled job.
- `list_jobs`: List jobs with filters and pagination.
- `get_job`: Get one job by ID.
- `update_job`: Update an existing job.
- `delete_job`: Delete a job.
- `pause_job`: Pause a job.
- `resume_job`: Resume a job.
- `list_executions`: List a job's run history.
- `replay_execution`: Re-run a past execution immediately.
- `provision_account`: Create an anonymous account and return an API key.
- `whoami`: Show the current account.
- `rotate_key`: Rotate the API key.
- `get_usage`: Show plan usage and limits.
- `list_alerts`: List failure-alert configurations.
- `create_alert`: Create a failure alert by email, webhook or Slack.
- `get_alert`: Get one alert by ID.
- `update_alert`: Update an alert.
- `delete_alert`: Delete an alert.

## FAQ

### Do I need an account first?

No. Ask the agent to run provision_account, or get a key from the dashboard or CLI.

### Where does the key go?

Set RUNHOOKS_API_KEY in the client config; provision_account also saves one to ~/.runhooks/mcp.json.

### What does it cost?

The MCP server adds no cost; usage counts against your plan, which starts Free and goes up to $19, $59 and $129 a month.

### Can I point it elsewhere?

Yes, RUNHOOKS_API_URL overrides the API origin.

### Is Runhooks free?

Runhooks has a free plan, with paid plans for more usage or features. Paid plans start at $19 a month.

### How do I add Runhooks to Claude Code?

Run this command in your terminal: claude mcp add runhooks-mcp --env RUNHOOKS_API_KEY='<RUNHOOKS_API_KEY>' -- npx -y @runhooks/mcp

### What are the best alternatives to Runhooks?

The closest alternatives to Runhooks are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/runhooks
