Skip to content
Back to search

mcp-canary

Zero-config health checks and schema-drift alerts for the MCP servers you have installed

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dasandner--mcp-canary/badge.svg)](/listings/dasandner--mcp-canary)

HTML

<a href="/listings/dasandner--mcp-canary"><img src="/api/listings/dasandner--mcp-canary/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

cargo install --git https://github.com/DaSandner/mcp-canary

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 76 lines
  1. # mcp-canary
  2. **Find out when the MCP servers you use break or change — before your agent quietly works around them.**
  3. MCP servers fail silently. A tool disappears after `npx -y …@latest` pulls a new version, a parameter changes type, a server hangs on the handshake. Nothing errors; your agent just starts using a nearby tool or answering from memory.
  4. `mcp-canary` reads the MCP configs you already have, connects to every server, and remembers each tool's schema. Run it again later and it tells you exactly what changed.
  5. ```
  6. $ mcp-canary diff
  7. Running fresh check...
  8. ! Project .mcp.json/hang connect: initialize failed: no response to `initialize` within 30s
  9. 2 change(s):
  10. - legacy in Project .mcp.json/fake
  11. ~ search in Project .mcp.json/fake (schema changed)
  12. + param limit
  13. ~ param q: "string" -> "number"
  14. ! limit is now required
  15. ```
  16. ## Install
  17. ```sh
  18. cargo install --git https://github.com/DaSandner/mcp-canary
  19. ```
  20. ## Usage
  21. ```sh
  22. mcp-canary scan # list every MCP server found in your configs
  23. mcp-canary check # connect to each one, list tools, save a snapshot
  24. mcp-canary diff # re-check and compare against the last snapshot
  25. ```
  26. | Flag | Effect |
  27. | --- | --- |
  28. | `--timeout <secs>` | Max wait per server response (default 30) |
  29. | `check -v` | Print every tool name |
  30. **Exit codes:** `0` all good · `1` a server failed or a schema changed · `2` mcp-canary itself errored. That makes it usable in a cron job, a git hook, or CI.
  31. ## Where it looks
  32. | Client | Config |
  33. | --- | --- |
  34. | Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` |
  35. | Claude Code | `~/.claude.json` (global and per-project servers) |
  36. | Cursor | `~/.cursor/mcp.json`, `./.cursor/mcp.json` |
  37. | VS Code | `./.vscode/mcp.json` |
  38. | Any project | `./.mcp.json` |
  39. Snapshots live in `~/.mcp-canary/` (`latest.json` plus a `history/` folder).
  40. ## What it checks
  41. - The `initialize` handshake completes within the timeout
  42. - `tools/list` returns (with pagination)
  43. - Tools added or removed since the last snapshot
  44. - Input-schema changes, with parameter-level detail: added/removed params, type changes, newly required params
  45. A server that fails during `diff` is reported as unreachable, not as "all tools removed", and its last good snapshot is kept.
  46. ## What it doesn't do (yet)
  47. - **Remote (HTTP/SSE) servers** are listed but skipped
  48. - **No tool calls.** It checks the contract, not whether results are correct. It never executes a tool, so it is safe to run against servers with write access.
  49. - Windows and Linux config paths for Claude Desktop are not read yet
  50. ## Related
  51. If you **build** MCP servers and want to test one in depth (replayed calls, fuzzing, contract files), look at [EnjoyableWork/mcp-doctor](https://github.com/EnjoyableWork/mcp-doctor). `mcp-canary` is for people who **use** a pile of servers and want one command that says "something you rely on changed."
  52. ## License
  53. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.