Concepts

Monitor

A monitor is the unit you create. It holds:

• a plain-English description (what “meaningful change” means)
• input_params (usually a url or tracking link)
• schedule: one_off or recurring + frequency
• output_webhook — where to POST results

Create monitors with client.monitors.create (Ruby gem) or the Cloud dashboard — same API operations either way. All monitors are recurring (no task_type).

Run

A run is one execution of a monitor. Each run has a status (pending, running, succeeded, failed), structured findings, and webhook delivery history.

Inspect runs in the Cloud dashboard — useful while you validate instructions and webhook handlers.

Webhook

Meerkat delivers results with an HTTPS POST to your app. Payloads are HMAC-signed — verify them in Rails with the gem helper.

class Webhooks::MeerkatController < ApplicationController
  include Meerkat::Rails::WebhookVerification

  def create
    payload = JSON.parse(request.raw_post)
    # payload["data"] includes summary / structured findings
    head :ok
  end
end

Webhooks guide →

BYOK (bring your own LLM key)

Change Intelligence needs a model to understand pages. You attach your Anthropic or OpenAI key in the account menu → LLM key. Meerkat never resells tokens.

Credits & pricing

Free trial: 1 monitor and 1 run. After that, buy $20 — 5 tasks, 50 runs. Optional auto top-up recharges when run credits hit zero.