Newscatcher/catchall-mcp

MCP server for the NewsCatcher CatchAll Web Search API.
Quick Start — Use Our Hosted Server
You don't need to clone or run this repo to use the MCP — NewsCatcher runs a hosted instance:
Get a CatchAll API key at platform.newscatcherapi.com, then connect:
Or via Claude Code CLI:
Full integration docs: https://www.newscatcherapi.com/docs/web-search-api/integrations/mcp
Prefer to run the server yourself (locally or self-hosted)? See Running below.
Tool To Endpoint Mapping
Jobs
| MCP Tool | Method | Endpoint |
| --- | --- | --- |
| initialize_query | POST | /catchAll/initialize |
| submit_query | POST | /catchAll/submit |
| validate_query | POST | /catchAll/validate |
| continue_job | POST | /catchAll/continue |
| list_user_jobs | GET | /catchAll/jobs/user |
| get_job_status | GET | /catchAll/status/{job_id} |
| pull_results | GET | /catchAll/pull/{job_id} |
| pull_job_csv | GET | /catchAll/pull/{job_id}/csv |
| delete_job | DELETE | /catchAll/jobs/{job_id} |
> **Job listing filters:** list_user_jobs supports search, ownership, project_id,
> and mode (base or lite) filters in addition to page/page_size.
Monitors
| MCP Tool | Method | Endpoint |
| --- | --- | --- |
| create_monitor | POST | /catchAll/monitors/create |
| update_monitor | PATCH | /catchAll/monitors/{monitor_id} |
| delete_monitor | DELETE | /catchAll/monitors/{monitor_id} |
| list_monitors | GET | /catchAll/monitors/ |
| list_monitor_jobs | GET | /catchAll/monitors/{monitor_id}/jobs |
| get_monitor_status | GET | /catchAll/monitors/{monitor_id}/status |
| pull_monitor_results | GET | /catchAll/monitors/pull/{monitor_id} |
| pull_monitor_csv | GET | /catchAll/monitors/pull/{monitor_id}/csv |
| enable_monitor | POST | /catchAll/monitors/{monitor_id}/enable |
| disable_monitor | POST | /catchAll/monitors/{monitor_id}/disable |
Webhooks
| MCP Tool | Method | Endpoint |
| --- | --- | --- |
| list_webhooks | GET | /catchAll/webhooks |
| create_webhook | POST | /catchAll/webhooks |
| get_webhook | GET | /catchAll/webhooks/{webhook_id} |
| update_webhook | PATCH | /catchAll/webhooks/{webhook_id} |
| delete_webhook | DELETE | /catchAll/webhooks/{webhook_id} |
| test_webhook | POST | /catchAll/webhooks/{webhook_id}/test |
| assign_webhook_resource | POST | /catchAll/webhooks/{webhook_id}/resources |
| list_webhook_resources | GET | /catchAll/webhooks/{webhook_id}/resources |
| remove_webhook_resource | DELETE | /catchAll/webhooks/{webhook_id}/resources/{resource_type}/{resource_id} |
| list_resource_webhooks | GET | /catchAll/resources/{resource_type}/{resource_id}/webhooks |
| get_webhook_history | GET | /catchAll/webhook-history |
| trigger_webhook | POST | /catchAll/webhook/trigger/{resource_type}/{resource_id} |
> **Webhook notes:** create_webhook accepts an optional project_id to attach the
> webhook to a project on creation. list_webhooks also accepts an optional project_id
> to filter to webhooks belonging to a specific project. get_webhook_history queries in
> one of two modes — pass resource_type + resource_id for a job/monitor/monitor_group's
> deliveries, or pass webhook_id for everything delivered through one webhook (exactly
> one mode per call). Manual test deliveries (test_webhook) only appear in webhook mode
> and are recorded with resource_type: "test".
Projects
| MCP Tool | Method | Endpoint |
| --- | --- | --- |
| create_project | POST | /catchAll/projects/ |
| list_projects | GET | /catchAll/projects/ |
| get_project | GET | /catchAll/projects/{project_id} |
| update_project | PATCH | /catchAll/projects/{project_id} |
| delete_project | DELETE | /catchAll/projects/{project_id} |
| get_project_overview | GET | /catchAll/projects/{project_id}/overview |
| add_project_resources | POST | /catchAll/projects/{project_id}/resources |
| list_project_resources | GET | /catchAll/projects/{project_id}/resources |