@privacytracker/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., "@@privacytracker/mcp what's changed in Signal's privacy policy recently?"
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.
@privacytracker/mcp
Model Context Protocol server for PrivacyTracker. Exposes the local privacy library — apps, privacy labels, change history, AI policy summaries — to any MCP-compatible client (Claude Desktop, Claude Code, Cline, etc.).
This is a read-only proxy. It talks to a running PrivacyTracker instance over its existing HTTP API; it does not touch the SQLite database directly and never mutates state.
Prerequisites
A running PrivacyTracker instance (local
pnpm dev, Docker, or remote install).Node.js 20 or newer on the machine running the MCP client.
Related MCP server: paycoreDb
Install
You don't need to clone this repo to use the server — every MCP client can spawn it via npx:
npx -y @privacytracker/mcpFor local development from a clone:
pnpm install
pnpm build
node dist/index.jsConfiguration
The server reads three environment variables:
Variable | Required | Default | Notes |
| no |
| Origin of the running PrivacyTracker instance. No trailing slash. |
| conditional | — | Required when the upstream server has |
| no |
| Per-request timeout. |
A 401 response from the server triggers a clear MCP error explaining which side of the token contract is wrong.
Claude Desktop config
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"privacytracker": {
"command": "npx",
"args": ["-y", "@privacytracker/mcp"],
"env": {
"PRIVACYTRACKER_BASE_URL": "http://localhost:3000",
"PRIVACYTRACKER_ADMIN_TOKEN": "..."
}
}
}
}Restart Claude Desktop and the privacytracker server will appear in the tools menu.
Available tools
All tools are read-only and map 1:1 to existing PrivacyTracker API endpoints.
Tool | Description |
| Every tracked app with identity + change counts. Optional |
| Full privacy dossier for one app (privacy types, categories, last snapshot, policy summary). |
| iTunes Store search by name and/or bundle id. Returns App Store URLs. |
| Universal cross-app change feed with filtering (app, time, type, category) and pagination. |
| Full changelog for one app in chronological order. |
| Per-quarter category trend and change-event sparkline for one app (Q1 2021 forward). |
| Privacy-policy AI run status for one app (idle/running/done/error + log). |
| Line+word diff between a policy version and its predecessor. |
| Side-by-side privacy comparison of two apps (tracked or untracked URL). |
| 30 most recent privacy-change notifications + unread count. |
| Background sync scheduler state (running, last/next run, interval). |
Available resources
URI | Description |
| Flat JSON list of every tracked app. |
| Full privacy dossier for one app. Replace |
Local development
pnpm install
pnpm dev # tsx watch mode
pnpm typecheck
pnpm test
pnpm lint
pnpm buildTo smoke-test against a running PrivacyTracker instance:
PRIVACYTRACKER_BASE_URL=http://localhost:3000 pnpm startThe server speaks JSON-RPC over stdio. Use the MCP Inspector for interactive exploration:
npx @modelcontextprotocol/inspector node dist/index.jsVersioning
This package versions independently of PrivacyTracker itself. Tag a release (v0.x.y) on main and the publish workflow ships it to npm automatically.
License
Apache-2.0. See LICENSE.
Available Tools
11 toolscompare_appsA
Compare the privacy posture of two apps side by side. Each side can be a tracked app (id:) or an untracked App Store URL (url:<...>) which is scraped fresh without persisting.
Inputs: a (required), b (required).
get_appA
Get the full privacy dossier for a single tracked app: identity, privacy types and categories, last snapshot, and policy summary if one has been generated.
Inputs: appId (required).
get_app_changelogA
Get the full privacy changelog for one app: every snapshot diff (label changes, policy revisions, wayback baselines) in chronological order with the trigger that produced it.
Inputs: appId (required).
get_changelogA
Get the universal privacy changelog across every tracked app. Each row is a single change event (added / removed / modified / policy / wayback) with app context. Supports filtering by app, time window, type, and category, with pagination.
Inputs: to, from, type, appId, +3 more.
get_history_statsA
Get aggregated history stats for one app: per-quarter category trend (added/removed) and a sparkline of change-event counts. Buckets align to calendar quarters from Q1 2021 forward.
Inputs: appId (required).
get_notificationsA
Get the most recent privacy-change notifications (up to 30) plus the current unread count. Read-only — does not mark anything as read.
Inputs: no named parameters.
get_policy_statusA
Get the privacy-policy AI run status for one app: current run state (idle/running/done/error), start time, last log lines, and whether a structured summary is ready. Use get_app for the actual summary content.
Inputs: appId (required).
get_policy_version_diffA
Get a line+word diff between a privacy-policy version and the version immediately before it for the same app. Returns 404 if the given version is the first scrape for its app.
Inputs: versionId (required).
get_sync_statusA
Get the background sync scheduler status: whether it is currently running, when it last ran, when it is next due, and the configured interval.
Inputs: no named parameters.
list_appsA
List every app currently tracked in the PrivacyTracker library, with developer, bundle id, change counts, and last-updated timestamps. Optionally returns a grouped view bucketed by dominant privacy category.
Inputs: grouped.
search_appsA
Search the iTunes Store for App Store entries by name or bundle id. Returns candidate matches with App Store URLs that can be used to add the app to PrivacyTracker. Pass either names or bundleIds (or both).
Inputs: names, country, bundleIds.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool targets a distinct resource and action. The only possible overlap between get_app and get_policy_status is clarified by descriptions focusing on summary content vs run state.
All tools follow a consistent verb_noun snake_case pattern (list_, get_, search_, compare_). No mixed conventions or vague verbs.
11 tools cover the full read/analysis surface of a privacy tracker without redundancy. The count fits the domain well.
Core workflows (listing, inspecting, changelogs, statistics, policy diffing, comparison) are well covered. Minor gaps include no tool to add/remove tracked apps or mark notifications read, but search_apps supports comparison via URLs.
Related MCP Connectors
Read-only MCP server for The Quiet Protocol's engines, benchmarks, proof, and business data.
Unofficial remote MCP server for Less Annoying CRM: OAuth 2.1, read-only grants, 10 tools.
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
OAuth-protected, read-only-by-default MCP server for provenance-labeled QuillCaddie project memory.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceSelf-hosted MCP server for app market intelligence, enabling tools to query app download/revenue estimates, ad intensity proxies, creator mentions, and rank history from local collected data.1MIT
- FlicenseNot gradedqualityDmaintenanceCustom MCP server connected to a read-only SQLite database, exposing a schema resource and a query tool for safe data retrieval.-
- AlicenseAqualityBmaintenanceA read-only MCP server for querying Timely time tracking data, providing tools for project overviews, time spent summaries, and work log entries.3MIT
- FlicenseNot gradedqualityDmaintenanceA Python MCP server for querying grant applications and previewing or committing scoped reviewer reassignments.-