changedetection-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@changedetection-mcp List my watches and show the latest diff for the first one"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
changedetection-mcp
An MCP (Model Context Protocol) server that connects AI assistants to a changedetection.io instance through its API v1. It has 28 tools for watches, snapshot history and diffs, tags, notifications, search, and import. Writes are dry-run previews unless you confirm them and enable writes. It runs over stdio, or over stateless Streamable HTTP on localhost.
Connects to: changedetection.io (self-hosted or a hosted account), using your own API key.
By Issah Abubakari (@si-essence). Also listed on Bot Essentials.
changedetection.io is Apache-2.0 software. Self-host it, or point this connector at your own hosted account. The connector does not grant any right to the changedetection.io name, and it does not imply endorsement.
This connector is MIT. It is a BYO-key client. It does not resell hosted access.
Requirements
Node.js 20 or newer (CI uses Node.js 22)
npm
Related MCP server: Fieldkit
Setup
From a clone of this repository:
npm ci
npm run ci
npm start
npm run start:httpnpm start speaks stdio. npm run start:http serves Streamable HTTP at http://127.0.0.1:3000/mcp and GET /health. HTTP mode has no authentication. Keep it on localhost.
Create an API key in changedetection.io under Settings, API. The connector sends it as x-api-key and never prints it.
{
"mcpServers": {
"changedetection": {
"command": "node",
"args": ["/path/to/changedetection-mcp/dist/index.js"],
"env": {
"CHANGEDETECTION_URL": "http://127.0.0.1:5000",
"CHANGEDETECTION_API_KEY": "...",
"CHANGEDETECTION_ALLOW_WRITES": "false",
"CHANGEDETECTION_CONTACT": "you@example.com"
}
}
}
}Hosted accounts use the login origin as CHANGEDETECTION_URL. A trailing /api/v1 is stripped.
Docker (HTTP, no authentication, localhost only):
docker build -t changedetection-mcp .
docker run -p 3000:3000 \
-e CHANGEDETECTION_URL=http://host.docker.internal:5000 \
-e CHANGEDETECTION_API_KEY=... \
changedetection-mcpDo not put the API key in the image.
Tools
Tool | Call |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Create and update accept restock fields (processor: restock_diff, in_stock_only, follow_price_changes, price_change_threshold_percent) and LLM fields (llm_backend_profile, llm_intent, llm_change_summary, llm_change_summary_mode). Get watch returns processor_config_restock_diff when the instance provides it.
from_timestamp may be previous. to_timestamp and snapshot timestamp may be latest.
changedetection_list_history returns { uuid, count, snapshots }. Each snapshot is { timestamp, iso_time }. Snapshots are sorted by unix time, oldest first. The upstream history map values are server filesystem paths. The parser discards those values and never copies them into the result. Nested history maps on changedetection_get_watch and other JSON tools become the same snapshot list. Keys such as filename and datastore_path are dropped when they hold a server path.
Environment
Variable | Default | Role |
|
| Instance origin. No userinfo, query, or hash. |
| unset | Required for an upstream call. At least 8 characters. Never printed |
| off | The literal |
|
| Contact inside the User-Agent. Must not contain the API key |
|
| Local sliding-window cap |
|
| TTL for successful reads. |
|
| Upstream timeout |
|
|
|
|
| HTTP listen port |
Invalid values are reported by field name and issue code. The rejected value is not included.
Safety
A write tool returns a dry-run preview when confirm is omitted. The preview is the method, path, query, and body that would be sent.
confirm must be the boolean true. false and the string "true" are rejected.
When confirm is true and CHANGEDETECTION_ALLOW_WRITES is not true, the tool still returns the preview, sets blocked to true, and does not call the instance.
Writes include create, update, delete, import, recheck, pause or mute, and notification changes. Recheck uses GET on the upstream API. This connector still treats it as a write.
Delete watch also deletes that watch's history. Replace notifications overwrites the whole list.
The API key is removed from tool results, error text, and logs, including its URL-encoded form. It is refused in the query string, the base URL, the User-Agent, and a JSON request body. Notification URLs that carry webhook tokens, URL userinfo, and Authorization / cookie headers are redacted in output.
HTTP 402 is returned as [upstream] with a quota or payment note. HTTP 429 is [rate-limit]. HTTP 404 is [not-found].
HTTP mode has no authentication. Do not expose it beyond localhost.
Attribution and terms
Upstream source. changedetection.io by dgtlmoon, API v1 at
/api/v1/. Docs: https://changedetection.io/docs/api_v1/index.htmlLicense of the software. Apache-2.0. Hosted use is also covered by the changedetection.io terms of service.
Attribution text. The provider does not require a credit line beyond the Apache-2.0 NOTICE for the software itself.
What this connector does not grant. A lookup does not transfer trademarks or a right to imply that the provider endorses this project. Do not resell hosted access.
User-Agent. Requests send
changedetection-mcp/0.1.0 (<CHANGEDETECTION_CONTACT>).
Running the tests
The tests use mocked upstream responses. They need no API key and make no network calls to changedetection.io.
npm ci
npm test # unit and tool tests (vitest)
npm run ci # typecheck, lint, tests, and buildAt the time of this commit, npm test reports 53 passing tests.
npm run live-check runs every tool against a real instance set in CHANGEDETECTION_URL and CHANGEDETECTION_API_KEY. It creates and then deletes test objects, so point it at a test instance and set CHANGEDETECTION_ALLOW_WRITES=true only there.
Author
Issah Abubakari (@si-essence).
This connector is also listed on Bot Essentials.
Licence
MIT. See LICENSE.
Available Tools
28 toolschangedetection_add_notificationsA
Add global notification URLs. POST /api/v1/notifications. Omit confirm for a dry-run. Tokens are redacted in the preview.
Inputs: notification_urls (required), confirm.
changedetection_create_tagB
Create a tag. POST /api/v1/tag. Requires title. Omit confirm for a dry-run.
Inputs: title (required), tag, body, tags, +52 more.
changedetection_create_watchA
Create a watch. POST /api/v1/watch. Requires url. Supports processor restock_diff, price fields, and llm_intent / llm_change_summary. Omit confirm for a dry-run.
Inputs: url (required), tag, body, tags, +50 more.
changedetection_delete_historyADestructiveIdempotent
Delete every snapshot for a watch. DELETE /api/v1/watch/{uuid}/history. The watch remains. Omit confirm for a dry-run.
Inputs: uuid (required), confirm.
changedetection_delete_notificationsADestructiveIdempotent
Delete matching global notification URLs. DELETE /api/v1/notifications with a JSON body. Omit confirm for a dry-run.
Inputs: notification_urls (required), confirm.
changedetection_delete_tagADestructiveIdempotent
Delete a tag and remove it from every watch. DELETE /api/v1/tag/{uuid}. Omit confirm for a dry-run.
Inputs: uuid (required), confirm.
changedetection_delete_watchADestructiveIdempotent
Delete a watch and all of its history. DELETE /api/v1/watch/{uuid}. Omit confirm for a dry-run.
Inputs: uuid (required), confirm.
changedetection_full_specARead-only
Get the live merged OpenAPI document for this instance. GET /api/v1/full-spec. Returns YAML text.
Inputs: no named parameters.
changedetection_get_diffBRead-only
Diff two snapshots. GET /api/v1/watch/{uuid}/difference/{from}/{to}. from_timestamp may be previous, to_timestamp may be latest. format is text, html, or htmlcolor.
Inputs: uuid (required), to_timestamp (required), from_timestamp (required), type, +8 more.
changedetection_get_faviconARead-only
Get the favicon for a watch. GET /api/v1/watch/{uuid}/favicon. Small binaries return base64. Large files return size only.
Inputs: uuid (required).
changedetection_get_snapshotBRead-only
Fetch one snapshot. GET /api/v1/watch/{uuid}/history/{timestamp}. timestamp may be a unix time or latest. html true requests HTML.
Inputs: uuid (required), timestamp (required), html.
changedetection_get_tagBRead-only
Get one tag by UUID. GET /api/v1/tag/{uuid}. Includes WatchBase fields plus overrides_watch and LLM controls.
Inputs: uuid (required).
changedetection_get_watchARead-only
Get one watch by UUID. GET /api/v1/watch/{uuid}. Returns the full watch JSON including restock and LLM fields when present. Nested history maps become timestamp lists. Server filesystem paths are discarded.
Inputs: uuid (required).
changedetection_import_watchesA
Import line-separated URLs as watches. POST /api/v1/import as text/plain. Query can set tag, processor, and other watch fields. Omit confirm for a dry-run.
Inputs: urls (required), tag, proxy, dedupe, +8 more.
changedetection_list_historyARead-only
List snapshot timestamps for a watch. GET /api/v1/watch/{uuid}/history. Returns uuid, count, and snapshots with timestamp and iso_time. Server filesystem paths are discarded.
Inputs: uuid (required).
changedetection_list_notificationsARead-only
List global notification URLs. GET /api/v1/notifications. Tokens in URLs are redacted.
Inputs: no named parameters.
changedetection_list_tagsARead-only
List tags. GET /api/v1/tags.
Inputs: no named parameters.
changedetection_list_watchesARead-only
List watches. GET /api/v1/watch. Optional tag name filter. Recheck-all is a separate write tool.
Inputs: tag.
changedetection_recheck_allA
Queue a recheck for every watch, optionally limited by tag name. GET /api/v1/watch?recheck_all=1. Omit confirm for a dry-run.
Inputs: tag, confirm.
changedetection_recheck_tagA
Queue a recheck for every watch in a tag. GET /api/v1/tag/{uuid}?recheck=1. Omit confirm for a dry-run.
Inputs: uuid (required), confirm.
changedetection_recheck_watchA
Queue a recheck for one watch. GET /api/v1/watch/{uuid}?recheck=1. Omit confirm for a dry-run.
Inputs: uuid (required), confirm.
changedetection_replace_notificationsADestructiveIdempotent
Replace every global notification URL. PUT /api/v1/notifications. An empty list clears them. Omit confirm for a dry-run.
Inputs: notification_urls (required), confirm.
changedetection_searchBRead-only
Search watches by URL or title. GET /api/v1/search?q= with optional tag and partial.
Inputs: q (required), tag, partial.
changedetection_set_tag_mutedAIdempotent
Set muted or unmuted on a tag. GET /api/v1/tag/{uuid}?muted=. Omit confirm for a dry-run.
Inputs: uuid (required), muted (required), confirm.
changedetection_set_watch_stateBIdempotent
Set paused or muted on a watch. GET /api/v1/watch/{uuid} with paused and muted query flags. Omit confirm for a dry-run.
Inputs: uuid (required), muted, paused, confirm.
changedetection_systeminfoARead-only
Get instance status. GET /api/v1/systeminfo. Returns version, watch count, uptime, and queue fields when present.
Inputs: no named parameters.
changedetection_update_tagBIdempotent
Update a tag. PUT /api/v1/tag/{uuid}. Omit confirm for a dry-run.
Inputs: uuid (required), tag, body, tags, +53 more.
changedetection_update_watchBIdempotent
Update a watch. PUT /api/v1/watch/{uuid}. Same writable fields as create, plus last_viewed. Omit confirm for a dry-run.
Inputs: uuid (required), tag, url, body, +52 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 28 tools
Most tools target clear resource/action combinations, so an agent can usually select correctly. Minor overlap exists between recheck_tag and recheck_all with a tag filter, and dedicated state/mute tools vs general update tools.
All tools use the changedetection_ prefix and snake_case, with a mostly predictable verb_noun pattern. A few exceptions like systeminfo and full_spec are noun-oriented rather than verb_noun.
The broad Changedetection API surface justifies many of the 28 tools, and most map to distinct operations. However, 28 is heavy for an MCP tool set, and some convenience variants could be consolidated.
The set covers the core domain well: watch CRUD, tag CRUD, notification management, history/snapshots/diffs, rechecks, search, import, and system inspection. No obvious lifecycle gaps stand out.
Related MCP Connectors
Give an AI agent eyes on the web: turn any feed, page, or stream into deduplicated change events.
AI-callable tools for API mocking, testing, monitoring, security, and automation.
Watch web pages and get a short summary of what changed. Create monitors and read changes.
Independent directory of agentic AI tools — search, compare & recommend via MCP. Read-only.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceExposes any OpenAPI spec endpoints as AI agent tools via stdio, requiring no code generation or maintenance.18MIT
- AlicenseBqualityBmaintenanceEnables a small local AI model to discover, describe, run, undo, and verify deterministic tools over JSON-RPC on stdio, with previews and approval gates for changes.10AGPL 3.0
- FlicenseNot gradedqualityAmaintenanceEnables AI assistants to securely interact with Jenkins through its API, exposing tools for inspecting items, nodes, views, queues, and builds, reading console output, test reports, and artifacts, managing plugins, and triggering, stopping, or approving pipeline builds, including executing Groovy scripts. Supports stdio, SSE, and streamable-HTTP transports with configurable authentication, SSL verification, and a read-only mode.-
- AlicenseNot gradedqualityAmaintenanceConnects MCP-compatible AI agents to an anti-detection browser server, providing 47 tools for navigation, interaction, observation, search, downloads, sessions, and batch workflows. Supports multi-tab state, persistent profiles, cookie import, accessibility snapshots, and stdio or HTTP transports.581 npmMIT