MCP

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

curl -X POST "https://herculradar.com/api/mcp" \
  -H "Authorization: Bearer hr_live_…" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Tools

• list_projects

  List the projects this credential can reach. Start here when you do not know the project id.

• create_project

  Create a workspace for a brand. Only needed once per brand you monitor.

• list_monitors

  List what is currently being watched: keywords, aliases, sources and whether each monitor is active.

• create_monitor

  Start watching a brand, product or competitor. Include every spelling people actually use — the domain and the @handle as well as the name — because matching is literal.

• update_monitor

  Change a monitor’s keywords, sources or active state. Only the fields you pass change.

• delete_monitor

  Permanently remove a monitor. Mentions already collected are kept. Prefer update_monitor with active:false if the user may want it back.

• list_mentions

  The main read tool. Returns collected posts newest first, already classified. Call with no arguments for the latest, or filter by category, sentiment, urgency, source or a named time window. Page with the returned nextCursor.

• get_mention

  Fetch one mention in full, with its AI classification and a link to the original post.

• update_mention_status

  Move a mention through triage. Use done once it has been handled and ignored when it is not really about the brand.

• get_mention_analytics

  Counts for a window — totals, relevance rate, how many need attention, and breakdowns by category, sentiment and source. Use this to answer "how are we doing" without paging the whole feed.

• list_alerts

  List alert rules — what triggers a notification and where it is sent.

• create_alert

  Notify an email address or https webhook when a matching mention arrives. Empty filter arrays mean "any".

• delete_alert

  Permanently remove an alert rule. Notifications stop immediately.

• get_usage

  Plan, mentions used against the quota, and what collection cost this period. Check before creating monitors if the user is near their limit.