Sign inStart free

Quickstart

Two minutes to a first call, five to a connected agent.

1. Create a key

In Developer, create an API key. Choose read-only if the integration only reads. The plaintext is shown once.

2. Read your feed

curl "https://herculradar.com/api/v1/mentions?date_preset=last_24_hours&min_urgency=70" \
  --header "Authorization: Bearer hr_live_…"

Every parameter is optional. Calling /api/v1/mentions with none returns the most recent 50.

3. Start watching something

curl "https://herculradar.com/api/v1/monitors" \
  --request POST \
  --header "Authorization: Bearer hr_live_…" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: $(uuidgen)" \
  --data '{
    "name": "Acme",
    "keywords": ["Acme", "acme.dev", "@acmehq"],
    "sources": ["x", "reddit", "youtube"]
  }'

Matching is literal, so include the domain and the handle. The idempotency key means a retried request cannot create a second monitor.

4. Connect an agent

{
  "mcpServers": {
    "herculeradar": {
      "url": "https://herculradar.com/api/mcp",
      "headers": { "Authorization": "Bearer hr_live_…" }
    }
  }
}

Then ask it something real: “What did people complain about this week, and is any of it the same complaint twice?”

Next