Skip to main content
Glama
@privacytracker/mcp
by privacykey

@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/mcp

For local development from a clone:

pnpm install
pnpm build
node dist/index.js

Configuration

The server reads three environment variables:

Variable

Required

Default

Notes

PRIVACYTRACKER_BASE_URL

no

http://localhost:3000

Origin of the running PrivacyTracker instance. No trailing slash.

PRIVACYTRACKER_ADMIN_TOKEN

conditional

—

Required when the upstream server has AUDITOR_ADMIN_TOKEN set, OR when the MCP server is reaching it across a non-local hostname. Sent as x-auditor-admin-token on every request.

PRIVACYTRACKER_TIMEOUT_MS

no

30000

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

list_apps

Every tracked app with identity + change counts. Optional grouped view.

get_app

Full privacy dossier for one app (privacy types, categories, last snapshot, policy summary).

search_apps

iTunes Store search by name and/or bundle id. Returns App Store URLs.

get_changelog

Universal cross-app change feed with filtering (app, time, type, category) and pagination.

get_app_changelog

Full changelog for one app in chronological order.

get_history_stats

Per-quarter category trend and change-event sparkline for one app (Q1 2021 forward).

get_policy_status

Privacy-policy AI run status for one app (idle/running/done/error + log).

get_policy_version_diff

Line+word diff between a policy version and its predecessor.

compare_apps

Side-by-side privacy comparison of two apps (tracked or untracked URL).

get_notifications

30 most recent privacy-change notifications + unread count.

get_sync_status

Background sync scheduler state (running, last/next run, interval).

Available resources

URI

Description

apps://list

Flat JSON list of every tracked app.

app://{appId}

Full privacy dossier for one app. Replace {appId} with the numeric Apple track ID.

Local development

pnpm install
pnpm dev          # tsx watch mode
pnpm typecheck
pnpm test
pnpm lint
pnpm build

To smoke-test against a running PrivacyTracker instance:

PRIVACYTRACKER_BASE_URL=http://localhost:3000 pnpm start

The server speaks JSON-RPC over stdio. Use the MCP Inspector for interactive exploration:

npx @modelcontextprotocol/inspector node dist/index.js

Versioning

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 tools
compare_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

    A4.2/5.0

    Scored across 11 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    All tools follow a consistent verb_noun snake_case pattern (list_, get_, search_, compare_). No mixed conventions or vague verbs.

    Tool Count5/5

    11 tools cover the full read/analysis surface of a privacy tracker without redundancy. The count fits the domain well.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Self-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.
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Custom MCP server connected to a read-only SQLite database, exposing a schema resource and a query tool for safe data retrieval.
      -