Skip to main content
Glama
changedetection-mcp

changedetection-mcp

by si-essence

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:http

npm 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-mcp

Do not put the API key in the image.

Tools

Tool

Call

changedetection_list_watches

GET /api/v1/watch

changedetection_get_watch

GET /api/v1/watch/{uuid}

changedetection_create_watch

POST /api/v1/watch

changedetection_update_watch

PUT /api/v1/watch/{uuid}

changedetection_delete_watch

DELETE /api/v1/watch/{uuid}

changedetection_recheck_watch

GET /api/v1/watch/{uuid}?recheck=1

changedetection_recheck_all

GET /api/v1/watch?recheck_all=1

changedetection_set_watch_state

GET /api/v1/watch/{uuid} with paused and muted

changedetection_list_history

GET /api/v1/watch/{uuid}/history (timestamps only)

changedetection_get_snapshot

GET /api/v1/watch/{uuid}/history/{timestamp}

changedetection_get_diff

GET /api/v1/watch/{uuid}/difference/{from}/{to}

changedetection_delete_history

DELETE /api/v1/watch/{uuid}/history

changedetection_get_favicon

GET /api/v1/watch/{uuid}/favicon

changedetection_list_tags

GET /api/v1/tags

changedetection_get_tag

GET /api/v1/tag/{uuid}

changedetection_create_tag

POST /api/v1/tag

changedetection_update_tag

PUT /api/v1/tag/{uuid}

changedetection_delete_tag

DELETE /api/v1/tag/{uuid}

changedetection_recheck_tag

GET /api/v1/tag/{uuid}?recheck=1

changedetection_set_tag_muted

GET /api/v1/tag/{uuid}?muted=

changedetection_list_notifications

GET /api/v1/notifications

changedetection_add_notifications

POST /api/v1/notifications

changedetection_replace_notifications

PUT /api/v1/notifications

changedetection_delete_notifications

DELETE /api/v1/notifications

changedetection_search

GET /api/v1/search

changedetection_import_watches

POST /api/v1/import as text/plain

changedetection_systeminfo

GET /api/v1/systeminfo

changedetection_full_spec

GET /api/v1/full-spec

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

CHANGEDETECTION_URL

https://example.invalid

Instance origin. No userinfo, query, or hash. /api/v1 suffix is stripped

CHANGEDETECTION_API_KEY

unset

Required for an upstream call. At least 8 characters. Never printed

CHANGEDETECTION_ALLOW_WRITES

off

The literal true enables writes. Any other value keeps writes as a blocked preview

CHANGEDETECTION_CONTACT

contact@example.com

Contact inside the User-Agent. Must not contain the API key

CHANGEDETECTION_PER_MINUTE

30

Local sliding-window cap

CHANGEDETECTION_CACHE_TTL_SEC

60

TTL for successful reads. 0 disables the cache

CHANGEDETECTION_TIMEOUT_MS

20000

Upstream timeout

MCP_TRANSPORT

stdio

stdio or http. --http forces HTTP

PORT

3000

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.html

  • License 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 build

At 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 tools
changedetection_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_historyA
DestructiveIdempotent

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_notificationsA
DestructiveIdempotent

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_tagA
DestructiveIdempotent

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_watchA
DestructiveIdempotent

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_specA
Read-only

Get the live merged OpenAPI document for this instance. GET /api/v1/full-spec. Returns YAML text.

Inputs: no named parameters.

changedetection_get_diffB
Read-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_faviconA
Read-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_snapshotB
Read-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_tagB
Read-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_watchA
Read-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_historyA
Read-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_notificationsA
Read-only

List global notification URLs. GET /api/v1/notifications. Tokens in URLs are redacted.

Inputs: no named parameters.

changedetection_list_tagsA
Read-only

List tags. GET /api/v1/tags.

Inputs: no named parameters.

changedetection_list_watchesA
Read-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_notificationsA
DestructiveIdempotent

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_set_tag_mutedA
Idempotent

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_stateB
Idempotent

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_systeminfoA
Read-only

Get instance status. GET /api/v1/systeminfo. Returns version, watch count, uptime, and queue fields when present.

Inputs: no named parameters.

changedetection_update_tagB
Idempotent

Update a tag. PUT /api/v1/tag/{uuid}. Omit confirm for a dry-run.

Inputs: uuid (required), tag, body, tags, +53 more.

changedetection_update_watchB
Idempotent

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

    A3.6/5.0

    Scored across 28 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count3/5

    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.

    Completeness5/5

    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

    Related MCP Servers

    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables 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.
      -
    • A
      license
      Not graded
      quality
      A
      maintenance
      Connects 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 npm
      MIT