Ruby SDK

1. Install

gem "meerkat-agents"

bundle install

require "meerkat"

2. Sign up & get a key

Sign up on Meerkat Cloud, copy your API key, add your LLM key under LLM key.

3. Create a monitor

client = Meerkat::Client.new(api_key: ENV["MEERKAT_API_KEY"])

client.monitors.create(
  description: "Notify me when pricing or plan limits change",
  input_params: { url: "https://competitor.com/pricing" },
  frequency: "every 6 hours",
  output_webhook: "https://myapp.com/webhooks/meerkat"
)

All monitors are recurring — there is no task_type.

4. CRUD, runs & artifacts

client.monitors.list
client.monitors.retrieve(id)
client.monitors.update(id, frequency: "every 12 hours")
client.monitors.pause(id)
client.monitors.resume(id)
client.monitors.delete(id)

client.monitors.runs(id)
client.monitors.retrieve_run(id, run_id)
client.monitors.artifacts(id, run_id)  # structured findings
client.monitors.run(id)                # on-demand run

5. Paid loop

Free: 1 monitor / 1 run. Then $20 — 5 tasks, 50 runs. Limit hit → Meerkat::SubscriptionRequiredError.

Verify webhooks

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

  def create
    payload = JSON.parse(request.raw_post)
    head :ok
  end
end

Configuration