MCP Server
CatchAll
com.newscatcherapi/catchall
What this MCP does
Runs broad web research jobs and manages datasets, entity enrichment, recurring monitors, projects and webhook delivery.
Capabilities
Tools
61
tools
add_dataset_entities
Add Dataset Entities
Add existing entities to a dataset.
Input schema
{'type': 'object', 'required': ['dataset_id', 'entity_ids'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'dataset_id': {'type': 'string', 'description': 'The dataset ID to add entities to.'}, 'entity_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of entity IDs to add (required).'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
add_project_resources
Add Project Resources
Add 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.
Input schema
{'type': 'object', 'required': ['project_id', 'resources'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'resources': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'additionalProperties': {'type': 'string'}}}, {'type': 'string'}], 'description': 'A list of resource objects, each `{"resource_type": ..., "resource_id": ...}`.\n`resource_type` is one of: \'job\', \'monitor\', \'dataset\', \'monitor_group\', \'webhook\'.\nMay also be passed as a JSON-string array for client compatibility.'}, 'project_id': {'type': 'string', 'description': 'The project ID to add resources to.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
append_csv_to_dataset
Append Csv To Dataset
Append 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 CSV, use `create_dataset_from_csv` instead.
Input schema
{'type': 'object', 'required': ['dataset_id', 'file'], 'properties': {'file': {'type': 'string', 'description': 'CSV content (required) â\x80\x94 raw CSV text or standard base64-encoded\nCSV, capped at 10 MB after decoding. Server-side file paths are\nnot accepted.'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'dataset_id': {'type': 'string', 'description': 'The dataset ID to append entities to (required).'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
assign_webhook_resource
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.
Input schema
{'type': 'object', 'required': ['webhook_id', 'resource_type', 'resource_id'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'webhook_id': {'type': 'string', 'description': 'The webhook ID to attach the resource to.'}, 'resource_id': {'type': 'string', 'description': 'The ID of the job/monitor/monitor_group to map.'}, 'resource_type': {'type': 'string', 'description': "Resource type: 'job', 'monitor', or 'monitor_group'."}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
check_health
Check Health
Check API health status.
This tool maps to GET /health and does not require an API key.
Input schema
{'type': 'object', 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'Optional CatchAll API key.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
continue_job
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 a job was submitted without `limit`, there is nothing to continue.
The new_limit must be greater than the previous limit when provided.
If omitted, API defaults to your plan maximum.
Input schema
{'type': 'object', 'required': ['job_id'], 'properties': {'job_id': {'type': 'string', 'description': 'The job ID to continue processing'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'new_limit': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Optional new record processing limit (must exceed the previous limit if provided).'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
create_dataset
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.
Input schema
{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'description': 'Human-readable dataset name (required).'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'entity_ids': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Optional list of existing entity IDs to seed the dataset with.'}, 'project_id': {'type': 'string', 'default': '', 'description': 'Optional project ID to associate this dataset with.'}, 'description': {'type': 'string', 'default': '', 'description': 'Optional dataset description.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
create_dataset_from_csv
Create Dataset From Csv
Create 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 columns are mapped to entity
attributes. Max file size is plan-dependent. To add CSV rows to an
existing dataset, use `append_csv_to_dataset` instead.
Input schema
{'type': 'object', 'required': ['name', 'file'], 'properties': {'file': {'type': 'string', 'description': 'CSV content (required) â\x80\x94 raw CSV text or standard base64-encoded\nCSV, capped at 10 MB after decoding. Server-side file paths are\nnot accepted.'}, 'name': {'type': 'string', 'description': 'Human-readable dataset name (required).'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'project_id': {'type': 'string', 'default': '', 'description': 'Optional project ID to associate this dataset with (new in 1.6.1).'}, 'description': {'type': 'string', 'default': '', 'description': 'Optional dataset description.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
create_entities_batch
Create Entities Batch
Create multiple entities in one call.
Input schema
{'type': 'object', 'required': ['entities'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'entities': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, {'type': 'string'}], 'description': 'A list of entity objects. Each object requires a ``name``\nplus one identifying field for good enrichment: either a top-level\n``"description"`` or ``"additional_attributes": {"company_attributes": {"domain": "..."}}``.\nAlso accepts optional ``entity_type`` (\'company\'/\'person\').\nMay also be passed as a JSON-string array.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
create_entity
Create Entity
Create a single entity (a company or person).
``name`` is required plus at least one identifying
field: either ``description`` or ``additional_attributes.company_attributes.domain``.
Input schema
{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'description': 'Entity name (required).'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'description': {'type': 'string', 'default': '', 'description': 'Optional description of the entity.'}, 'entity_type': {'type': 'string', 'default': '', 'description': "Optional entity type: 'company' (default) or 'person'."}, 'external_entity_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Optional customer-supplied identifier linking this entity to\nan external system's record (new in 1.6.3)."}, 'additional_attributes': {'anyOf': [{'type': 'object', 'additionalProperties': True}, {'type': 'null'}], 'default': None, 'description': 'Optional structured attributes. For companies, use\n`{"company_attributes": {"alternative_names": [...], "domain": "...",\n"key_persons": [...], "description": "..."}}`.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
create_monitor
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 EST').
Always include a timezone (in the schedule text or via the `timezone` arg).
API-enforced constraints apply:
- If `backfill=true`, reference job end_date must be within the last 7 days
- If `backfill=false`, reference job age does not matter
- Minimum schedule frequency depends on your plan
Webhooks are now centralized: register them with `create_webhook`, then pass
their IDs here via `webhook_ids` (there is no inline webhook config anymore).
Input schema
{'type': 'object', 'required': ['reference_job_id', 'schedule'], 'properties': {'limit': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Optional max records per run (minimum 10). If omitted, API uses plan default.'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'backfill': {'type': 'boolean', 'default': True, 'description': 'Optional gap-fill toggle before first run (default true).'}, 'schedule': {'type': 'string', 'description': "Natural language schedule (e.g., 'every day at 9 AM EST', 'every Monday at 8 AM UTC', 'every 48 hours')"}, 'timezone': {'type': 'string', 'default': '', 'description': "Optional IANA timezone for the schedule (e.g. 'America/New_York').\nDefaults to UTC. A timezone written into the schedule text overrides this."}, 'project_id': {'type': 'string', 'default': '', 'description': 'Optional project ID to associate this monitor with.'}, 'webhook_ids': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Optional list of webhook IDs to notify on each run completion (max 5).'}, 'reference_job_id': {'type': 'string', 'description': 'ID of a completed job to use as the template'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
create_project
Create Project
Create a new project.
Projects group related resources (jobs, monitors, datasets, monitor_groups)
so you can organize work and filter listings by `project_id`.
Input schema
{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'description': 'Human-readable project name (required).'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'description': {'type': 'string', 'default': '', 'description': 'Optional project description.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
create_webhook
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 `project_id`).
Input schema
{'type': 'object', 'required': ['name', 'url'], 'properties': {'url': {'type': 'string', 'description': 'Target URL that will receive webhook deliveries (required).'}, 'auth': {'anyOf': [{'type': 'object', 'additionalProperties': True}, {'type': 'null'}], 'default': None, 'description': 'Optional auth object forwarded with each delivery. One of:\n- {"type": "bearer", "token": "..."}\n- {"type": "api_key", "header": "X-API-Key", "value": "..."}\n- {"type": "basic", "username": "...", "password": "..."}'}, 'name': {'type': 'string', 'description': 'Human-readable name for the webhook (required).'}, 'type': {'type': 'string', 'default': '', 'description': "Optional webhook target type: 'generic' (default), 'slack', 'teams', or 'custom'.\n'slack'/'teams' send pre-formatted payloads; 'generic'/'custom' send the raw result payload."}, 'method': {'type': 'string', 'default': 'POST', 'description': "HTTP method for delivery (default 'POST'). One of GET, POST, PUT, PATCH, DELETE."}, 'params': {'anyOf': [{'type': 'object', 'additionalProperties': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Optional dict of query string parameters appended to the webhook URL.'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'headers': {'anyOf': [{'type': 'object', 'additionalProperties': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Optional dict of custom HTTP headers to include in deliveries.'}, 'project_id': {'type': 'string', 'default': '', 'description': "Optional project ID to associate this webhook with immediately\nupon creation. A webhook can belong to several projects at once; use\n`add_project_resources` (resource_type 'webhook') to attach it to more."}, 'delivery_mode': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Optional delivery mode: 'full' (default, whole result set in one call)\nor 'per_record' (one call per article)."}, 'formatter_config': {'anyOf': [{'type': 'object', 'additionalProperties': True}, {'type': 'null'}], 'default': None, 'description': 'Optional custom payload transformation config dict.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
delete_dataset
Delete Dataset
Permanently delete a dataset.
The entities the dataset referenced are not deleted; only the dataset and its
entity associations are removed.
Input schema
{'type': 'object', 'required': ['dataset_id'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'dataset_id': {'type': 'string', 'description': 'The dataset ID to delete.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
delete_entity
Delete Entity
Permanently delete an entity.
Input schema
{'type': 'object', 'required': ['entity_id'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'entity_id': {'type': 'string', 'description': 'The entity ID to delete.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
delete_job
Delete Job
Permanently delete a job and its results.
Use when:
- You want to remove a job you no longer need from your account.
Input schema
{'type': 'object', 'required': ['job_id'], 'properties': {'job_id': {'type': 'string', 'description': 'The job ID to delete.'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
delete_monitor
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).
Input schema
{'type': 'object', 'required': ['monitor_id'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'monitor_id': {'type': 'string', 'description': 'The monitor ID to delete.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
delete_project
Delete Project
Delete 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 only detached
from the project and keeps working (it may belong to other projects or
resources independently of this one).
Input schema
{'type': 'object', 'required': ['project_id'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'project_id': {'type': 'string', 'description': 'The project ID to delete.'}, 'delete_resources': {'type': 'boolean', 'default': False, 'description': "If true, also delete the project's resources except\nwebhooks, which are always detached rather than deleted (default false)."}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
delete_webhook
Delete Webhook
Permanently delete a webhook endpoint.
Use when:
- You want to remove a webhook from your account.
Input schema
{'type': 'object', 'required': ['webhook_id'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'webhook_id': {'type': 'string', 'description': 'The webhook ID to delete.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
disable_monitor
Disable Monitor
Disable a monitor to stop its scheduled runs.
The monitor can be re-enabled later with enable_monitor.
Input schema
{'type': 'object', 'required': ['monitor_id'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'monitor_id': {'type': 'string', 'description': 'The monitor ID to disable'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
enable_monitor
Enable Monitor
Enable a previously disabled monitor to resume its scheduled runs.
Input schema
{'type': 'object', 'required': ['monitor_id'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'backfill': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'default': None, 'description': 'Optional backfill behavior for resume.'}, 'monitor_id': {'type': 'string', 'description': 'The monitor ID to enable'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
get_dataset
Get Dataset
Get a single dataset's details.
Input schema
{'type': 'object', 'required': ['dataset_id'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'dataset_id': {'type': 'string', 'description': 'The dataset ID to retrieve.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
get_dataset_status
Get Dataset Status
Get the status history of a dataset (e.g. its enrichment progress over time).
Input schema
{'type': 'object', 'required': ['dataset_id'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'dataset_id': {'type': 'string', 'description': 'The dataset ID to inspect.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
get_entity
Get Entity
Get a single entity's details.
Input schema
{'type': 'object', 'required': ['entity_id'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'entity_id': {'type': 'string', 'description': 'The entity ID to retrieve.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
get_job_status
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, then poll every 30-60 seconds.
Broad searches can take 10-30+ minutes; for long jobs, poll every 60-120 seconds.
Do NOT call this tool in a tight loop.
Stop polling when status is `completed` or `failed`.
Treat `submitted`, `analyzing`, `fetching`, `clustering`, and `enriching`
as active states and continue polling.
You don't need to wait for completion to pull results. Partial results are
available during `enriching` â call pull_results after ~2 minutes, then
poll status every 30-60 seconds and pull again for fresher results.
Do not stop pulling just because an intermediate pull is empty/unchanged.
Use `progress_validated` vs `candidate_records` to track whether more
results may still appear (`progress_validated < candidate_records`).
If transport/session fails, resume using the same `job_id`.
Input schema
{'type': 'object', 'required': ['job_id'], 'properties': {'job_id': {'type': 'string', 'description': 'The job ID returned from submit_query'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
get_monitor_status
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.
Input schema
{'type': 'object', 'required': ['monitor_id'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'monitor_id': {'type': 'string', 'description': 'The monitor ID to inspect.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
get_project
Get Project
Get a single project's details.
Input schema
{'type': 'object', 'required': ['project_id'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'project_id': {'type': 'string', 'description': 'The project ID to retrieve.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
get_project_overview
Get Project Overview
Get a project's resource overview (counts grouped by resource type and status).
Input schema
{'type': 'object', 'required': ['project_id'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'project_id': {'type': 'string', 'description': 'The project ID to summarize.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
get_user_limits
Get User Limits
Retrieve 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.
Input schema
{'type': 'object', 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
get_version
Get Version
Get current API version.
This tool maps to GET /version and does not require an API key.
Input schema
{'type': 'object', 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'Optional CatchAll API key.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
get_webhook
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.
Input schema
{'type': 'object', 'required': ['webhook_id'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'webhook_id': {'type': 'string', 'description': 'The webhook ID to retrieve.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
get_webhook_history
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 made through one
webhook â including manual test deliveries (from `test_webhook`), which
are not tied to a job or monitor and only appear in this mode.
Input schema
{'type': 'object', 'properties': {'page': {'type': 'integer', 'default': 1, 'description': 'Page number for pagination (default: 1).'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'page_size': {'type': 'integer', 'default': 50, 'description': 'Number of results per page (default: 50, max: 500).'}, 'webhook_id': {'type': 'string', 'default': '', 'description': 'Webhook ID to fetch history for. Mutually exclusive with\n`resource_type`/`resource_id`.'}, 'resource_id': {'type': 'string', 'default': '', 'description': 'The ID of the job/monitor/monitor_group.'}, 'resource_type': {'type': 'string', 'default': '', 'description': "Resource type: 'job', 'monitor', or 'monitor_group'.\nRequired together with `resource_id` when `webhook_id` is not given."}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
initialize_query
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 start processing immediately with final inputs (use `submit_query`).
Key behavior:
- Preview-only endpoint: does not create a job and does not start processing.
- Suggestions are LLM-generated and not deterministic across calls.
- To reuse suggestions, pass them explicitly to `submit_query`.
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': 'Natural language query to preview (required). If you plan to attach a\ncompany dataset via `connected_dataset_ids` in the subsequent `submit_query`,\ndo NOT reference the company list here â\x80\x94 entity filtering is applied\nautomatically by the dataset, not by the query text.'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'context': {'type': 'string', 'default': '', 'description': 'Optional guidance on what to prioritize so suggested validators,\nenrichments, and dates align with your target data points. If a company\ndataset will be attached in `submit_query`, note that entity-relevance\nvalidators (e.g. `company_is_primary_subject`) will be auto-generated â\x80\x94\ndo not ask for them here. Do not mention things like "company list will be attached".\nFocus on the event or topic only.'}, 'fetch_all_watchlist_news': {'type': 'boolean', 'default': False, 'description': 'When `True`, signals that the subsequent job will\nretrieve all news for connected watchlist entities without topic filtering.\nPass this when you intend to use `fetch_all_watchlist_news=True` in\n`submit_query` so the previewed validators/enrichments are generated\naccordingly. Requires `connected_dataset_ids` to be set in `submit_query`.\nDefault: `False`.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
list_dataset_entities
List Dataset Entities
List the entities contained in a dataset.
Input schema
{'type': 'object', 'required': ['dataset_id'], 'properties': {'page': {'type': 'integer', 'default': 1, 'description': 'Page number for pagination (default: 1).'}, 'search': {'type': 'string', 'default': '', 'description': 'Optional text filter on entity name.'}, 'status': {'type': 'string', 'default': '', 'description': "Optional status filter: 'pending', 'enriching', 'ready', or 'failed'."}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'sort_by': {'type': 'string', 'default': '', 'description': "Optional sort field: 'created_at', 'name', or 'status'."}, 'page_size': {'type': 'integer', 'default': 100, 'description': 'Number of results per page (default: 100).'}, 'dataset_id': {'type': 'string', 'description': 'The dataset ID whose entities you want.'}, 'sort_order': {'type': 'string', 'default': '', 'description': "Optional sort direction: 'asc' or 'desc'."}, 'entity_type': {'type': 'string', 'default': '', 'description': "Optional type filter: 'company' or 'person'."}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
list_datasets
List Datasets
List your datasets.
Input schema
{'type': 'object', 'properties': {'page': {'type': 'integer', 'default': 1, 'description': 'Page number for pagination (default: 1).'}, 'search': {'type': 'string', 'default': '', 'description': 'Optional text filter on the dataset name.'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'sort_by': {'type': 'string', 'default': '', 'description': "Optional sort field: 'name', 'created_at', or 'status'."}, 'ownership': {'type': 'string', 'default': '', 'description': "Optional ownership filter: 'all', 'own', or 'shared'."}, 'page_size': {'type': 'integer', 'default': 100, 'description': 'Number of results per page (default: 100, max: 1000).'}, 'project_id': {'type': 'string', 'default': '', 'description': 'Optional filter to datasets belonging to a specific project.'}, 'sort_order': {'type': 'string', 'default': '', 'description': "Optional sort direction: 'asc' or 'desc'."}, 'latest_status': {'type': 'string', 'default': '', 'description': "Optional status filter: 'pending', 'enriching', 'ready', or 'failed'."}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
list_entities
List Entities
List your entities.
Input schema
{'type': 'object', 'properties': {'page': {'type': 'integer', 'default': 1, 'description': 'Page number for pagination (default: 1).'}, 'search': {'type': 'string', 'default': '', 'description': 'Optional text filter on entity name.'}, 'status': {'type': 'string', 'default': '', 'description': "Optional status filter: 'pending', 'enriching', 'ready', or 'failed'."}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'sort_by': {'type': 'string', 'default': '', 'description': "Optional sort field: 'created_at', 'name', or 'status'."}, 'page_size': {'type': 'integer', 'default': 100, 'description': 'Number of results per page (default: 100, max: 1000).'}, 'project_id': {'type': 'string', 'default': '', 'description': 'Optional filter to entities belonging to a specific project.'}, 'sort_order': {'type': 'string', 'default': '', 'description': "Optional sort direction: 'asc' or 'desc'."}, 'entity_type': {'type': 'string', 'default': '', 'description': "Optional type filter: 'company' or 'person'."}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
list_monitor_jobs
List Monitor Jobs
List all jobs spawned by a monitor.
Returns the history of scheduled runs for a monitor.
Input schema
{'type': 'object', 'required': ['monitor_id'], 'properties': {'sort': {'type': 'string', 'default': 'asc', 'description': "Sort order by start_date: 'asc' (default) or 'desc'"}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'monitor_id': {'type': 'string', 'description': 'The monitor ID to list jobs for'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
list_monitors
List Monitors
List all your monitors.
Returns all monitors with their schedule, status, reference query, and webhook config.
Input schema
{'type': 'object', 'properties': {'page': {'type': 'integer', 'default': 1, 'description': 'Page number for pagination (default: 1).'}, 'search': {'type': 'string', 'default': '', 'description': 'Optional text filter on the monitor query.'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'ownership': {'type': 'string', 'default': '', 'description': "Optional ownership filter: 'all', 'own', or 'shared'."}, 'page_size': {'type': 'integer', 'default': 100, 'description': 'Number of results per page (default: 100, max: 1000).'}, 'project_id': {'type': 'string', 'default': '', 'description': 'Optional filter to monitors belonging to a specific project.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
list_project_resources
List Project Resources
List the resources contained in a project.
Input schema
{'type': 'object', 'required': ['project_id'], 'properties': {'page': {'type': 'integer', 'default': 1, 'description': 'Page number for pagination (default: 1).'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'page_size': {'type': 'integer', 'default': 100, 'description': 'Number of results per page (default: 100, max: 1000).'}, 'project_id': {'type': 'string', 'description': 'The project ID whose resources you want.'}, 'resource_type': {'type': 'string', 'default': '', 'description': "Optional filter: 'job', 'monitor', 'dataset', 'monitor_group', or 'webhook'."}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
list_projects
List Projects
List your projects.
Input schema
{'type': 'object', 'properties': {'page': {'type': 'integer', 'default': 1, 'description': 'Page number for pagination (default: 1).'}, 'search': {'type': 'string', 'default': '', 'description': 'Optional text filter on the project name.'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'ownership': {'type': 'string', 'default': '', 'description': "Optional ownership filter: 'all', 'own', or 'shared'."}, 'page_size': {'type': 'integer', 'default': 100, 'description': 'Number of results per page (default: 100, max: 1000).'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
list_resource_webhooks
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.
Input schema
{'type': 'object', 'required': ['resource_type', 'resource_id'], 'properties': {'page': {'type': 'integer', 'default': 1, 'description': 'Page number for pagination (default: 1).'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'is_active': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'default': None, 'description': 'Optional filter â\x80\x94 only active (true) or inactive (false) webhooks.'}, 'page_size': {'type': 'integer', 'default': 100, 'description': 'Number of results per page (default: 100, max: 1000).'}, 'resource_id': {'type': 'string', 'description': 'The ID of the job/monitor/monitor_group.'}, 'resource_type': {'type': 'string', 'description': "Resource type: 'job', 'monitor', or 'monitor_group'."}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
list_source_groups
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 `source_groups`
to scope fetching to that domain allowlist.
Input schema
{'type': 'object', 'properties': {'page': {'type': 'integer', 'default': 1, 'description': 'Page number for pagination (default: 1).'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'page_size': {'type': 'integer', 'default': 100, 'description': 'Number of results per page (default: 100, max: 500).'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
list_user_jobs
List User Jobs
List all jobs submitted by you.
Returns your job history with IDs, queries, statuses, and timestamps.
Input schema
{'type': 'object', 'properties': {'mode': {'type': 'string', 'default': '', 'description': "Optional filter by job processing mode: 'base' or 'lite'."}, 'page': {'type': 'integer', 'default': 1, 'description': 'Page number for pagination (default: 1)'}, 'search': {'type': 'string', 'default': '', 'description': 'Optional text filter on the job query.'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'ownership': {'type': 'string', 'default': '', 'description': "Optional ownership filter: 'all', 'own', or 'shared'."}, 'page_size': {'type': 'integer', 'default': 100, 'description': 'Number of results per page (default: 100, max: 1000)'}, 'project_id': {'type': 'string', 'default': '', 'description': 'Optional filter to jobs belonging to a specific project.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
list_webhook_resources
List Webhook Resources
List the resources mapped to a webhook.
Use when:
- You want to see which jobs/monitors a webhook is attached to.
Input schema
{'type': 'object', 'required': ['webhook_id'], 'properties': {'page': {'type': 'integer', 'default': 1, 'description': 'Page number for pagination (default: 1).'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'page_size': {'type': 'integer', 'default': 100, 'description': 'Number of results per page (default: 100, max: 1000).'}, 'webhook_id': {'type': 'string', 'description': 'The webhook ID whose resource mappings you want.'}, 'resource_type': {'type': 'string', 'default': '', 'description': "Optional filter: 'job', 'monitor', or 'monitor_group'."}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
list_webhooks
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.
Input schema
{'type': 'object', 'properties': {'page': {'type': 'integer', 'default': 1, 'description': 'Page number for pagination (default: 1).'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'page_size': {'type': 'integer', 'default': 100, 'description': 'Number of results per page (default: 100, max: 1000).'}, 'project_id': {'type': 'string', 'default': '', 'description': 'Optional filter to webhooks belonging to a specific project.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
pull_job_csv
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.
Input schema
{'type': 'object', 'required': ['job_id'], 'properties': {'job_id': {'type': 'string', 'description': 'The job ID to download as CSV.'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
pull_monitor_csv
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.
Input schema
{'type': 'object', 'required': ['monitor_id'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'monitor_id': {'type': 'string', 'description': 'The monitor ID to download results for.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
pull_monitor_results
Pull Monitor Results
Retrieve the latest results from a monitor.
Returns the most recent run's results including run_info, records, and all_records.
Input schema
{'type': 'object', 'required': ['monitor_id'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'monitor_id': {'type': 'string', 'description': 'The monitor ID to pull results from'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
pull_results
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 job reaches completed, iterate all pages.
If job fails, call once more to capture any partial output.
Input schema
{'type': 'object', 'required': ['job_id'], 'properties': {'page': {'type': 'integer', 'default': 1, 'description': 'Page number for pagination (default: 1). Use total_pages from the response to iterate through all results.'}, 'job_id': {'type': 'string', 'description': 'The job ID returned from submit_query'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'page_size': {'type': 'integer', 'default': 100, 'description': 'Number of records returned per page (default: 100, max: 1000).'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
remove_dataset_entities
Remove Dataset Entities
Remove entities from a dataset (the entities themselves are not deleted).
Input schema
{'type': 'object', 'required': ['dataset_id', 'entity_ids'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'dataset_id': {'type': 'string', 'description': 'The dataset ID to remove entities from.'}, 'entity_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of entity IDs to remove (required).'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
remove_project_resource
Remove Project Resource
Remove 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).
Input schema
{'type': 'object', 'required': ['project_id', 'resource_type', 'resource_id'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'project_id': {'type': 'string', 'description': 'The project ID to remove the resource from.'}, 'resource_id': {'type': 'string', 'description': 'The ID of the resource to remove.'}, 'resource_type': {'type': 'string', 'description': "Resource type: 'job', 'monitor', 'dataset', 'monitor_group', or 'webhook'."}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
remove_webhook_resource
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.
Input schema
{'type': 'object', 'required': ['webhook_id', 'resource_type', 'resource_id'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'webhook_id': {'type': 'string', 'description': 'The webhook ID to detach the resource from.'}, 'resource_id': {'type': 'string', 'description': 'The ID of the mapped job/monitor/monitor_group.'}, 'resource_type': {'type': 'string', 'description': "Resource type: 'job', 'monitor', or 'monitor_group'."}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
submit_query
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 existing job (use `get_job_status`).
- You want records for an existing job (use `pull_results`).
Key rules:
- `query` is required.
- You can submit with only `query`; omitted optional fields (`validators`, `enrichments`, `start_date`, `end_date`) are auto-selected/generated by the API.
- Optional fields are independent: you can pass any subset (for example, custom `validators` but no `enrichments`), and omitted fields are still auto-selected/generated.
- When `connected_dataset_ids` is set, the `query` must describe the **topic or event type only**
(e.g. "M&A activity", "regulatory filings", "executive changes"). Do NOT write things like
"for my companies", "for the selected list of companies", or "news about my watchlist" â the
entity filtering is applied automatically by the connected dataset. Mentioning companies in
the query when a dataset is attached is redundant and degrades retrieval quality.
- When `connected_dataset_ids` is set, entity-relevance validators (e.g.
`company_is_primary_subject`) are generated automatically by the API. Do NOT add them
manually to `validators` â they are redundant and may conflict with the auto-generated ones.
Only pass validators that describe the **event or topic**, not entity filtering.
- `start_date` and `end_date` filter by web page discovery date, not event date.
- Discovery dates and extracted event dates can differ. For event-time accuracy, use event-focused validators/enrichments and verify `event_date` in pulled results.
- `end_date` must be after `start_date`.
- Dates outside your plan lookback limits return API 400.
- `limit` controls processed record count (cost-affecting). Omit it to retrieve everything
up to your plan's maximum. If provided, must be >= 10.
- `validators` / `enrichments` may be passed either as arrays or as JSON-string arrays (for client compatibility).
- `validators[].type` must be `boolean` (if omitted, it defaults to `boolean`).
- `enrichments[].type` supported values: text, number, date, option, url, company.
Basic examples:
- validators:
`[{"name":"is_acquisition_event","description":"true if page describes an acquisition","type":"boolean"}]`
- enrichments:
`[{"name":"acquiring_company","description":"Extract acquiring company","type":"company"},{"name":"deal_value","description":"Extract announced deal value","type":"number"}]`
Next step:
- Save the returned `job_id`.
- Poll `get_job_status` and call `pull_results` (partial results can appear before completion).
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'mode': {'type': 'string', 'default': '', 'description': 'Optional job processing mode: `"lite"` (faster, lower cost, less detail) or `"base"` (default,\nfull extraction). If omitted, the API defaults to `"base"`.'}, 'limit': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': "Optional processing cap (minimum 10); affects cost. Omit to retrieve everything\nup to your plan's maximum."}, 'query': {'type': 'string', 'description': 'Plain text search intent (required).'}, 'schema': {'type': 'string', 'default': '', 'description': 'Optional advanced custom JSON schema string that overrides the default extraction\nschema. Use `initialize_query` to discover a suitable schema.'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'context': {'type': 'string', 'default': '', 'description': 'Optional guidance on what to prioritize (for example, target entities,\nevent types, and specific data points you want captured in enrichments).\nIf a company dataset will be attached, note that entity-relevance\nvalidators (e.g. `company_is_primary_subject`) will be auto-generated â\x80\x94\ndo not ask for them here. Do not mention things like "company list will be attached".'}, 'end_date': {'type': 'string', 'default': '', 'description': 'Optional ISO 8601 UTC end of search window.'}, 'project_id': {'type': 'string', 'default': '', 'description': 'Optional project ID to associate this job with.'}, 'start_date': {'type': 'string', 'default': '', 'description': 'Optional ISO 8601 UTC start of search window.'}, 'validators': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'required': ['name', 'description', 'type'], 'properties': {'name': {'type': 'string'}, 'type': {'type': 'string', 'const': 'boolean'}, 'description': {'type': 'string'}}, 'description': 'Schema for a custom validator.'}}, {'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional custom boolean validators (`name`, `description`, `type`), as array or JSON-string array.\nWhen `connected_dataset_ids` is set, do NOT include entity-relevance validators such as\n`company_is_primary_subject` â\x80\x94 the API generates those automatically. Only add validators\nthat describe the event or topic (e.g. `is_acquisition_event`).'}, 'enrichments': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'required': ['name', 'description', 'type'], 'properties': {'name': {'type': 'string'}, 'type': {'enum': ['text', 'number', 'date', 'option', 'url', 'company'], 'type': 'string'}, 'description': {'type': 'string'}}, 'description': 'Schema for a custom enrichment.'}}, {'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional custom enrichments (`name`, `description`, `type`), as array or JSON-string array.'}, 'webhook_ids': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Optional list of webhook IDs to notify when the job completes (max 5 per job).\nUse `list_webhooks` / `create_webhook` to get IDs.'}, 'ed_score_min': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Optional minimum entity-domain relevance score (1-10). Only relevant when\n`connected_dataset_ids` is set.'}, 'ed_association_type': {'type': 'string', 'default': '', 'description': 'Optional filter on how strongly a watchlist entity must appear in\neach event. Only relevant when `connected_dataset_ids` is set.\n- `"event_associated"`: keep only events where the entity is a **direct actor** (default when connected_dataset_ids is set).\n- `"mention"`: keep all even where the entity is **merely referenced**.'}, 'connected_dataset_ids': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Optional list of dataset IDs whose entities narrow the retrieval\nscope. When set: (1) entity filtering is applied automatically â\x80\x94 do NOT mention the\ncompany list or watchlist in `query`; (2) entity-relevance validators such as\n`company_is_primary_subject` are generated automatically â\x80\x94 do NOT add them to\n`validators`. `ed_score_min` defaults to 2 if not provided.'}, 'fetch_all_watchlist_news': {'type': 'boolean', 'default': False, 'description': 'When `True`, retrieves **all** news for connected watchlist\nentities without applying topic filtering from `query`. Requires\n`connected_dataset_ids` to be set. Default: `False`.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
test_webhook
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.
Input schema
{'type': 'object', 'required': ['webhook_id'], 'properties': {'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'payload': {'anyOf': [{'type': 'object', 'additionalProperties': True}, {'type': 'null'}], 'default': None, 'description': 'Optional custom JSON object to send as the test body. If omitted,\nthe API sends a default sample payload.'}, 'webhook_id': {'type': 'string', 'description': 'The webhook ID to test.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
trigger_webhook
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.
Input schema
{'type': 'object', 'required': ['webhook_id', 'resource_type', 'resource_id'], 'properties': {'job_id': {'type': 'string', 'default': '', 'description': "Optional job ID whose payload should be delivered (e.g. a specific\nmonitor run's job). If omitted, the API picks the resource's payload itself."}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'webhook_id': {'type': 'string', 'description': 'The webhook ID to deliver through.'}, 'resource_id': {'type': 'string', 'description': 'The ID of the job/monitor/monitor_group to trigger delivery for.'}, 'resource_type': {'type': 'string', 'description': "Resource type: 'job', 'monitor', or 'monitor_group'."}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
update_dataset
Update Dataset
Update a dataset's name and/or description.
Input schema
{'type': 'object', 'required': ['dataset_id'], 'properties': {'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional new dataset name.'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'dataset_id': {'type': 'string', 'description': 'The dataset ID to update.'}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional new dataset description.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
update_entity
Update Entity
Update an entity's name, description, external_entity_id, and/or attributes.
Input schema
{'type': 'object', 'required': ['entity_id'], 'properties': {'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional new entity name.'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'entity_id': {'type': 'string', 'description': 'The entity ID to update.'}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional new description.'}, 'external_entity_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Optional customer-supplied identifier linking this entity to\nan external system's record (new in 1.6.3)."}, 'additional_attributes': {'anyOf': [{'type': 'object', 'additionalProperties': True}, {'type': 'null'}], 'default': None, 'description': 'Optional updated structured attributes\n(see `create_entity` for the company_attributes shape).'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
update_monitor
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`).
Input schema
{'type': 'object', 'required': ['monitor_id'], 'properties': {'limit': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'default': None, 'description': 'Optional updated maximum records per run (minimum 10).'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'schedule': {'type': 'string', 'default': '', 'description': "Optional new natural-language schedule to replace the monitor's current\none (e.g. 'every day at 9 AM', 'every Monday at 6 PM EST'). Leave unset to keep\nthe current schedule. The scheduler picks up the new schedule on its next\nreload and the old schedule stops firing."}, 'timezone': {'type': 'string', 'default': '', 'description': "Optional IANA timezone for the new schedule (e.g. 'America/New_York').\nDefaults to UTC. Overridden if the schedule text itself contains a timezone.\nIgnored if `schedule` is not set."}, 'monitor_id': {'type': 'string', 'description': 'The monitor ID to update'}, 'webhook_ids': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Optional list of webhook IDs to assign to this monitor.\nPass an empty list `[]` to clear all webhook assignments.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
update_project
Update Project
Update a project's name and/or description.
Only the fields you provide are changed.
Input schema
{'type': 'object', 'required': ['project_id'], 'properties': {'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional new project name.'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'project_id': {'type': 'string', 'description': 'The project ID to update.'}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional new project description.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
update_webhook
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.
Input schema
{'type': 'object', 'required': ['webhook_id'], 'properties': {'url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Updated target URL.'}, 'auth': {'anyOf': [{'type': 'object', 'additionalProperties': True}, {'type': 'null'}], 'default': None, 'description': 'Updated auth object. One of:\n- {"type": "bearer", "token": "..."}\n- {"type": "api_key", "header": "X-API-Key", "value": "..."}\n- {"type": "basic", "username": "...", "password": "..."}'}, 'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Updated webhook name.'}, 'type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Updated webhook type: 'generic', 'slack', 'teams', or 'custom'."}, 'method': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Updated HTTP method: one of GET, POST, PUT, PATCH, DELETE.'}, 'params': {'anyOf': [{'type': 'object', 'additionalProperties': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Updated dict of query string parameters.'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}, 'headers': {'anyOf': [{'type': 'object', 'additionalProperties': {'type': 'string'}}, {'type': 'null'}], 'default': None, 'description': 'Updated dict of custom HTTP headers.'}, 'is_active': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'default': None, 'description': 'Set to false to disable the webhook (stop deliveries), true to re-enable it.'}, 'webhook_id': {'type': 'string', 'description': 'The webhook ID to update.'}, 'delivery_mode': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Updated delivery mode: 'full' or 'per_record'."}, 'formatter_config': {'anyOf': [{'type': 'object', 'additionalProperties': True}, {'type': 'null'}], 'default': None, 'description': 'Updated formatter configuration dict.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
validate_query
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 use when:
- You want to preview auto-generated validators/enrichments (use `initialize_query`).
- You want to actually run a search (use `submit_query`).
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': 'The natural-language query to assess (required).'}, 'api_key': {'type': 'string', 'default': '', 'description': 'CatchAll API key. Optional if provided via x-api-key header or CATCHALL_API_KEY env var.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
History
Recent tool changes
Changed
get_version
Sept. 23, 2026, 2:54 a.m.
Changed
check_health
Sept. 23, 2026, 2:54 a.m.
Changed
get_user_limits
Sept. 23, 2026, 2:54 a.m.
Changed
remove_project_resource
Sept. 23, 2026, 2:54 a.m.
Changed
list_project_resources
Sept. 23, 2026, 2:54 a.m.
Changed
add_project_resources
Sept. 23, 2026, 2:54 a.m.
Changed
get_project_overview
Sept. 23, 2026, 2:54 a.m.
Changed
delete_project
Sept. 23, 2026, 2:54 a.m.
Changed
update_project
Sept. 23, 2026, 2:54 a.m.
Changed
get_project
Sept. 23, 2026, 2:54 a.m.
Changed
list_projects
Sept. 23, 2026, 2:54 a.m.
Changed
create_project
Sept. 23, 2026, 2:54 a.m.
Changed
delete_entity
Sept. 23, 2026, 2:54 a.m.
Changed
update_entity
Sept. 23, 2026, 2:54 a.m.
Changed
get_entity
Sept. 23, 2026, 2:54 a.m.
Changed
create_entities_batch
Sept. 23, 2026, 2:54 a.m.
Changed
list_entities
Sept. 23, 2026, 2:54 a.m.
Changed
create_entity
Sept. 23, 2026, 2:54 a.m.
Changed
append_csv_to_dataset
Sept. 23, 2026, 2:54 a.m.
Changed
create_dataset_from_csv
Sept. 23, 2026, 2:54 a.m.
Changed
get_dataset_status
Sept. 23, 2026, 2:54 a.m.
Changed
list_dataset_entities
Sept. 23, 2026, 2:54 a.m.
Changed
remove_dataset_entities
Sept. 23, 2026, 2:54 a.m.
Changed
add_dataset_entities
Sept. 23, 2026, 2:54 a.m.
Changed
delete_dataset
Sept. 23, 2026, 2:54 a.m.
Changed
update_dataset
Sept. 23, 2026, 2:54 a.m.
Changed
get_dataset
Sept. 23, 2026, 2:54 a.m.
Changed
list_datasets
Sept. 23, 2026, 2:54 a.m.
Changed
create_dataset
Sept. 23, 2026, 2:54 a.m.
Changed
trigger_webhook
Sept. 23, 2026, 2:54 a.m.
Discover
Similar MCP servers
LiveDataLink
io.github.blackboxfoundry/livedatalink
Exposes public-data tools covering economics, labor, banking, transport, books, legal opinions, carriers, environmental data, and…
Stratalize Healthcare
com.stratalize/healthcare
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Governance
com.stratalize/governance
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Oracle
com.stratalize/oracle
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Real Estate
com.stratalize/realestate
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Crypto & DeFi
com.stratalize/crypto
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Valuein — SEC EDGAR Fundamentals & Smart-Money Data
io.github.valuein/mcp-sec-edgar
Provides point-in-time SEC EDGAR fundamentals, filings, ownership signals, financial analysis, valuation models, research reports…
equibles
io.github.daniel3303/equibles
Provides equity and market research tools covering SEC filings, company financials, portfolios, prices, options, macroeconomic da…