Skip to main content

Tool Reference

This page lists every tool the Generator Labs MCP server exposes, the scope it requires, and example prompts you can paste into your AI tool of choice. AI clients translate natural-language requests into the underlying tool calls automatically — you generally won't need to invoke them by name.

RBL Monitoring​

rbl_list_hosts​

List monitored hosts on the account, with their status and most recent check time. Supports filtering by listed/unlisted state.

Scope: mcp:read

Example prompts:

  • "Show me all the hosts I'm monitoring."
  • "Which of my IPs are flagged as currently listed?"
  • "List my domain-type hosts and when they were last checked."

rbl_get_host​

Return the full record for a single monitored host: status, last check, listing history summary, monitoring profile, contact group.

Scope: mcp:read

Example prompts:

  • "Tell me more about the host mail.example.com."
  • "When was 203.0.113.5 last checked, and what profile is it on?"

rbl_listings​

Return every host currently listed on at least one RBL or URIBL. Default response is a compact summary; pass details=true for the full per-source detail (heavier payload).

Scope: mcp:read

Example prompts:

  • "What's currently listed across my account?"
  • "Give me a quick summary of active listings."

rbl_get_listing_details​

Per-host drill-down: which sources currently flag this host, what each one says, and how long the lookup took. Use after rbl_listings identifies hosts of interest.

Scope: mcp:read

Example prompts:

  • "Why is mail.example.com flagged? Show me each source's detail."
  • "Drill into the listing for the third host in that summary."

rbl_list_profiles​

List the monitoring profiles configured on the account, with their check intervals and source policy.

Scope: mcp:read

Example prompts:

  • "What monitoring profiles do I have?"
  • "Which profile uses the curated source list?"

rbl_listing_history​

Return the listing-event history for a host or for the whole account, over a given time window.

Scope: mcp:read

Example prompts:

  • "Show me listing changes over the last 7 days."
  • "Has mail.example.com been listed at all this month?"

rbl_manual_check​

Trigger an on-demand RBL check against a host. Accepts an existing host SID or a one-off literal IP / domain. Returns a check_id to poll. Counts against your daily manual-check allotment, and is billed per-check on Ultimate plans.

Scope: mcp:write

Example prompts:

  • "Run an RBL check on mail.example.com right now."
  • "Check if 203.0.113.5 is listed anywhere."

rbl_check_status​

Poll the result of a manual check started via rbl_manual_check. Returns processing/complete state, listed/total counts, and (with include_details=true) the per-source detail.

Scope: mcp:read

Example prompts:

  • "Is that check done yet?"
  • "Show me the full results once it finishes."

rbl_list_sources​

Resolve one or more RBL data source SIDs (the RB-prefixed identifiers that come back from manual checks and listing tools) to their friendly metadata: human name, DNS hostname, website URL, and type. Pass an optional sids array to look up specific sources, or omit it to list every source the account can see (the curated global pool plus your own custom sources).

Scope: mcp:read

Example prompts:

  • "What's the friendly name for RB335b5143...?"
  • "Map the source IDs from that last check back to readable names."
  • "List every RBL source available on my account, grouped by type."

Certificate Monitoring​

cert_list_monitors​

List all certificate monitors on the account, with state (good/error/expiring/expired), days remaining, and last check time. Supports filtering by state.

Scope: mcp:read

Example prompts:

  • "Show me all my certificate monitors."
  • "Which certs are in an error state right now?"

cert_get_monitor​

Return the full record for a single certificate monitor: hostname, port, protocol, profile, contact group, current state, full chain detail.

Scope: mcp:read

Example prompts:

  • "Tell me everything about the monitor for mail.example.com:443."
  • "What's the chain look like for my API endpoint cert?"

cert_expiring_soon​

List certificates expiring within a configurable window (default 30 days). Useful for renewal-readiness checks.

Scope: mcp:read

Example prompts:

  • "Which of my certificates expire in the next 30 days?"
  • "Anything renewing in the next two weeks?"

cert_recent_errors​

List monitors that have recorded errors recently, with the underlying error reason.

Scope: mcp:read

Example prompts:

  • "What cert monitors are in error state, and why?"
  • "Show me cert errors from the last 24 hours."

cert_get_event​

Look up a specific certificate event by ID — the kind of detail you'd otherwise read on a public report page (expiration trigger, fingerprint change, flapping resolve, etc.).

Scope: mcp:read (or mcp:reports for the public-page view)

Example prompts:

  • "What was that cert event from yesterday's alert?"

cert_compliance​

Generate a compliance audit covering renewal hygiene, fingerprint stability, and configuration drift over a configurable window. Returns both a summary and a per-host breakdown.

Scope: mcp:read

Example prompts:

  • "Audit my certs for compliance over the last 90 days."
  • "Are my renewals happening on schedule?"

Notifications & Alerts​

contacts_list​

List notification contacts on the account: emails, SMS, Slack/Discord/Teams webhooks, PagerDuty/Opsgenie keys. Each row shows type, status, schedule, and which contact groups it belongs to. Sensitive credential fields are redacted.

Scope: mcp:read

Example prompts:

  • "Who gets alerted when something fires?"
  • "List all my Slack contacts."

contact_groups_list​

List contact groups, with member counts and which monitoring profiles reference them.

Scope: mcp:read

Example prompts:

  • "What contact groups do I have?"
  • "Which group is used by my production profile?"

webhooks_list​

List the webhook endpoints configured on the account, with their subscribed events and last-delivery state.

Scope: mcp:read

Example prompts:

  • "What webhooks do I have set up?"
  • "Which webhook handles billing events?"

recent_alerts​

Return alerts dispatched recently across all alert channels, with destination, status, and result. Filterable by time window, type, and channel.

Scope: mcp:read

Example prompts:

  • "What alerts went out this week?"
  • "Were there any failed alert deliveries today?"

Account & Health​

account_summary​

A high-level view of the account: plan, balance, host counts, certificate counts, recent activity. Useful as a "give me the big picture" call.

Scope: mcp:read

Example prompts:

  • "Give me an overview of my account."
  • "What's my current balance and host count?"

mcp_health​

Probe the MCP server's connectivity to its own dependencies (database, Redis). Returns a simple OK/degraded status with timing info. Mostly useful for debugging.

Scope: mcp:read

Example prompts:

  • "Is the MCP server healthy?"

Server Prompts​

In addition to tools, the server exposes three preset prompts — multi-step playbooks the AI tool can run end-to-end. Surface them by name in your AI tool's prompt picker:

  • Certificate renewal audit — walks your cert inventory, identifies anything expiring or recently rotated, and suggests follow-up actions.
  • Incident triage — given a host or event ID, gathers listing detail, recent history, and contact context for paging.
  • Monthly compliance review — generates a stakeholder-friendly summary of cert hygiene and RBL posture for the current month.