CatchAll

Reliability

Status and outage history · Atom feed · Watch with other listings

How to connect

Add it to any MCP client that supports remote servers.

{
  "mcpServers": {
    "catchall": {
      "type": "http",
      "url": "https://catchall-mcp.newscatcherapi.com/mcp"
    }
  }
}

61 tools

• submit_query

  Create a new CatchAll processing job from a natural-language query. Use when: - You want to start a new CatchAll web research run from a user query. - You want the API to fetch/process sources and then return structured results. Do not use when: - You want status for an…

• initialize_query

  Preview suggested validators, enrichments, and date ranges before submitting. Use when: - You want to inspect/edit auto-generated validators/enrichments before submitting. - You want to preview date adjustments via `date_modification_message`. Do not use when: - You want to…

• get_job_status

  Check the status of a submitted job. Call this after submit_query to see if your job is ready. Status progression: submitted -> analyzing -> fetching -> clustering -> enriching -> completed/failed IMPORTANT: Jobs take several minutes to process. First check after ~1-2 minutes…

• pull_results

  Retrieve the results of a job. Can be called before completion for partial results, or after completion for the full set. Returns clustered, validated, and enriched web results. While job status is active, call this repeatedly (typically page=1) to refresh partial output. When…

• pull_job_csv

  Download a job's results as a CSV file. Use when: - You want the full job output as a CSV for offline analysis or export. - Prefer this over `pull_results` when the consumer needs spreadsheet/CSV format.

• continue_job

  Expand a job by processing more records beyond the initial limit. This increases the number of records the system processes (which costs additional credits). Only use this when the user wants MORE data processed. This only applies to jobs originally submitted with `limit`. If…

• list_user_jobs

  List all jobs submitted by you. Returns your job history with IDs, queries, statuses, and timestamps.

• delete_job

  Permanently delete a job and its results. Use when: - You want to remove a job you no longer need from your account.

• validate_query

  Check the quality of a query before submitting a job ("Check Query Quality"). Use when: - You want quick feedback on whether a query is well-formed for CatchAll before spending credits on a job. - You want concrete suggestions to improve a vague or overly broad query. Do not…

• list_source_groups

  List source groups (named domain allowlists). Use when: - You want to discover reusable, named sets of source domains (public groups plus any organization-visibility groups your organization can access). - You need a group's `slug` to attach to `submit_query` via…

• create_monitor

  Create a recurring monitor from a completed job. Monitors re-run a job's query on a schedule. Use the explore -> refine -> automate pattern: submit a job, refine until results match, then create a monitor. The schedule is defined in natural language (e.g., 'every day at 9 AM…

• list_monitors

  List all your monitors. Returns all monitors with their schedule, status, reference query, and webhook config.

• pull_monitor_results

  Retrieve the latest results from a monitor. Returns the most recent run's results including run_info, records, and all_records.

• pull_monitor_csv

  Download the latest monitor run's results as a CSV file. Use when: - You want the most recent monitor run output as a CSV for offline analysis or export. - Prefer this over `pull_monitor_results` when the consumer needs spreadsheet/CSV format.

• list_monitor_jobs

  List all jobs spawned by a monitor. Returns the history of scheduled runs for a monitor.

• disable_monitor

  Disable a monitor to stop its scheduled runs. The monitor can be re-enabled later with enable_monitor.

• enable_monitor

  Enable a previously disabled monitor to resume its scheduled runs.

• update_monitor

  Update a monitor's schedule, timezone, webhook assignments, and per-run limit. Note: reference_job_id cannot be modified through this endpoint. Webhooks are centralized — pass webhook IDs (from `create_webhook`/`list_webhooks`).

• delete_monitor

  Permanently delete a monitor and stop its scheduled runs. Use when: - You want to remove a monitor entirely (use `disable_monitor` to only pause it).

• get_monitor_status

  Get the status history of a monitor. Use when: - You want to see the timeline of a monitor's state changes (e.g. active, disabled, errored) and any related details.

• list_webhooks

  List all your webhooks. Use when: - You want to see all webhook endpoints configured in your account. - You need to find a webhook_id to pass to monitors (via webhook_ids) or jobs.

• create_webhook

  Create a new webhook endpoint. Use when: - You want to register a URL to receive job or monitor result deliveries. - You need a webhook_id to attach to a monitor (via webhook_ids) or a job submission. - You want the webhook associated with a project from the start (pass…

• get_webhook

  Retrieve the full configuration of a specific webhook. Use when: - You want to inspect a webhook's URL, method, headers, or status by its ID.

• update_webhook

  Update an existing webhook's configuration. Use when: - You want to change a webhook's URL, method, headers, or other settings. - You want to enable or disable a webhook (set `is_active`). - Only the fields you provide are updated; omitted fields remain unchanged.

• delete_webhook

  Permanently delete a webhook endpoint. Use when: - You want to remove a webhook from your account.

• test_webhook

  Send a test delivery to a webhook endpoint. Use when: - You want to verify a webhook URL is reachable and correctly configured before attaching it to a monitor or job.

• assign_webhook_resource

  Map a resource (job, monitor, or monitor_group) to a webhook. Use when: - You want a webhook to fire for a specific job or monitor's deliveries.

• list_webhook_resources

  List the resources mapped to a webhook. Use when: - You want to see which jobs/monitors a webhook is attached to.

• remove_webhook_resource

  Unmap a resource from a webhook. Use when: - You want to stop a webhook from firing for a specific job or monitor.

• list_resource_webhooks

  List the webhooks mapped to a specific resource (job/monitor/monitor_group). Use when: - You have a job or monitor ID and want to know which webhooks will fire for it.

• get_webhook_history

  Get webhook delivery history, either for a resource or for a webhook. Query in exactly one of two modes: - By resource: pass `resource_type` + `resource_id` to see deliveries made for a specific job/monitor/monitor_group. - By webhook: pass `webhook_id` to see every delivery…

• trigger_webhook

  Manually trigger webhook delivery for a resource (job/monitor/monitor_group). Use when: - You want to (re-)send a webhook delivery on demand instead of waiting for the automatic dispatch — e.g. to replay a missed or failed delivery.

• create_dataset

  Create a new dataset. Datasets are collections of entities (companies/people). Connect a dataset to a job via `submit_query(connected_dataset_ids=[...])` to narrow retrieval scope.

• list_datasets

  List your datasets.

• get_dataset

  Get a single dataset's details.

• update_dataset

  Update a dataset's name and/or description.

• delete_dataset

  Permanently delete a dataset. The entities the dataset referenced are not deleted; only the dataset and its entity associations are removed.

• add_dataset_entities

  Add existing entities to a dataset.

• remove_dataset_entities

  Remove entities from a dataset (the entities themselves are not deleted).

• list_dataset_entities

  List the entities contained in a dataset.

Security scan

Recent checks