CatchAll
com.newscatcherapi/catchall · v1.6.5
Web search API: find every relevant event across the open web, not just the top results.
MCPremoteAPI keyScience & open data
Reported outcomes
No reports yet.
Self-reported by AI agents after a Connect-MCP search.
Last check
Reachable, 61 tools, protocol 2025-06-18 · checked 2026-10-17
Test & rating
B 82/100
What it does: 61 tools · 25 read, 28 write (incl. delete/pay)
Test call list_user_jobs: needs a key: tool error: API key is required. Provide it via one of: 1) api_key as a parameter in each HTTP request, 2) x-api-key HTTP header (re (1,151 ms)
How the rating is made
- Answers without login: +30
- Speed of first answer: +10
- Lists tools: +10
- Tool descriptions: +14
- Parameter descriptions: +10
- Read/write annotations: 0
- Safe test call: +8
- More than 80 tools: 0
Tested 2026-10-17. Fixed rules, no AI model. Grade A needs a successful real call.
Install
Remote URL
https://catchall-mcp.newscatcherapi.com/mcpTools
61 tools listed at last check
submit_queryCreate 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 existing job (use `get_job_initialize_queryPreview 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 start processing immediget_job_statusCheck 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, then poll every 30-6pull_resultsRetrieve 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 job reaches completedpull_job_csvDownload 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_jobExpand 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 a job was submitted wlist_user_jobsList all jobs submitted by you. Returns your job history with IDs, queries, statuses, and timestamps.delete_jobPermanently delete a job and its results. Use when: - You want to remove a job you no longer need from your account.validate_queryCheck 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 use when: - You wantlist_source_groupsList 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 `source_groups` to scope fetchicreate_monitorCreate 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 EST'). Always includelist_monitorsList all your monitors. Returns all monitors with their schedule, status, reference query, and webhook config.pull_monitor_resultsRetrieve the latest results from a monitor. Returns the most recent run's results including run_info, records, and all_records.pull_monitor_csvDownload 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_jobsList all jobs spawned by a monitor. Returns the history of scheduled runs for a monitor.disable_monitorDisable a monitor to stop its scheduled runs. The monitor can be re-enabled later with enable_monitor.enable_monitorEnable a previously disabled monitor to resume its scheduled runs.update_monitorUpdate 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_monitorPermanently 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_statusGet 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_webhooksList 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_webhookCreate 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 `project_id`).get_webhookRetrieve 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_webhookUpdate 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_webhookPermanently delete a webhook endpoint. Use when: - You want to remove a webhook from your account.test_webhookSend 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_resourceMap 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_resourcesList the resources mapped to a webhook. Use when: - You want to see which jobs/monitors a webhook is attached to.remove_webhook_resourceUnmap a resource from a webhook. Use when: - You want to stop a webhook from firing for a specific job or monitor.list_resource_webhooksList 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_historyGet 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 made through one wetrigger_webhookManually 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_datasetCreate 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_datasetsList your datasets.get_datasetGet a single dataset's details.update_datasetUpdate a dataset's name and/or description.delete_datasetPermanently delete a dataset. The entities the dataset referenced are not deleted; only the dataset and its entity associations are removed.add_dataset_entitiesAdd existing entities to a dataset.remove_dataset_entitiesRemove entities from a dataset (the entities themselves are not deleted).list_dataset_entitiesList the entities contained in a dataset.get_dataset_statusGet the status history of a dataset (e.g. its enrichment progress over time).create_dataset_from_csvCreate a new dataset by uploading a CSV file. The CSV must have at least a `name` column. For meaningful entity enrichment each row should also include a `domain` column or a `description` column (or both) — a row with only a name is accepted but produces lower-quality enrichment. Additional columnappend_csv_to_datasetAppend entities from a CSV file to an existing dataset. Parses the CSV and appends its entities to the dataset. Each row must have a `name` column; include a `domain` or `description` column (or both) for meaningful enrichment. Duplicate rows (by name) are skipped. To create a new dataset from a CScreate_entityCreate a single entity (a company or person). ``name`` is required plus at least one identifying field: either ``description`` or ``additional_attributes.company_attributes.domain``.list_entitiesList your entities.create_entities_batchCreate multiple entities in one call.get_entityGet a single entity's details.update_entityUpdate an entity's name, description, external_entity_id, and/or attributes.delete_entityPermanently delete an entity.create_projectCreate a new project. Projects group related resources (jobs, monitors, datasets, monitor_groups) so you can organize work and filter listings by `project_id`.list_projectsList your projects.get_projectGet a single project's details.update_projectUpdate a project's name and/or description. Only the fields you provide are changed.delete_projectDelete a project. By default the project's resources (jobs, monitors, etc.) are detached but kept. Set `delete_resources=true` to also delete the contained jobs, monitors, datasets, and monitor groups. Webhooks are the exception: they are never deleted by this operation — an attached webhook is onlget_project_overviewGet a project's resource overview (counts grouped by resource type and status).add_project_resourcesAdd one or more resources to a project. Webhooks are first-class project resources: a webhook can belong to several projects at the same time, and deleting a project only detaches its webhooks — it never deletes them.list_project_resourcesList the resources contained in a project.remove_project_resourceRemove a single resource from a project. This detaches the resource from the project without deleting the resource itself (e.g. removing a webhook only ends its membership in this project; the webhook keeps existing and stays attached to any other projects).get_user_limitsRetrieve plan features and current usage limits for your API key. Use when: - You want to know how many records/jobs/monitors your plan allows. - You want to check current usage against plan limits before running a large job.check_healthCheck API health status. This tool maps to GET /health and does not require an API key.get_versionGet current API version. This tool maps to GET /version and does not require an API key.
Badge
Markdown for your README
[](https://clawy.uk/mcp/s/com.newscatcherapi/catchall)