Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 15 additions & 9 deletions PRIVACY.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Mobile Dev Privacy Policy

Last updated: 3 November 2026
Last updated: 19 November 2026

## 1. Who we are and what this policy covers

Expand Down Expand Up @@ -62,8 +62,8 @@ Use test data, scope requests to the relevant app, and review content before
sharing it. Do not provide passwords, API keys, payment-card data, health records,
or government identifiers through these workflows.

Mobile Dev does not upload this development content to Callstack's Sentry or
Mixpanel projects as telemetry. This exclusion does not prevent a tool result from reaching the
Mobile Dev does not upload this development content to Callstack's Sentry project or
analytics service as telemetry. This exclusion does not prevent a tool result from reaching the
host or content you deliberately email to support from reaching Callstack.

### Diagnostics and usage telemetry
Expand Down Expand Up @@ -96,7 +96,7 @@ not a reason to put secrets into your test data.

### Product analytics

Release builds send basic product analytics to Mixpanel so we can see how many
Release builds send basic product analytics to our own analytics service so we can see how many
installations use Mobile Dev and which tools they use most. Events record that a
host session started or that a tool was called, with the tool's name, whether it
succeeded, the host (Codex, Claude, Cursor, the Mac app or other), the plugin
Expand All @@ -105,7 +105,7 @@ described above. Frequent polling and input tools are not recorded.

Analytics events never contain MCP arguments or results, app or device content,
device names or identifiers, project paths, or account details. They go to
Mixpanel's EU ingestion endpoint with IP collection turned off, so Mixpanel does
our analytics service at anal.margelo.com with IP collection turned off, so it does
not store your IP address or derive a location from it. We do not create user
profiles, combine analytics with other data about you, or use them for advertising.

Expand Down Expand Up @@ -141,8 +141,12 @@ telemetry controls and the right to object.
Callstack. The configured ingestion endpoints are in Sentry's German region.
This alone is not a promise that every support, subprocessor, or administrative
operation takes place exclusively in Germany.
- **Mixpanel:** processes the product analytics described above for Callstack,
in its EU data residency region.
- **Vercel and MotherDuck:** host and store the product analytics described
above for Callstack, in the United States: the service runs in Vercel's
Washington, D.C. region and stores analytics in MotherDuck's AWS US East region.
- **Mixpanel:** processes the product analytics that releases up to 0.1.189 send,
for Callstack, in its EU data residency region. A copy of their history up to
19 November 2026 is also kept in our analytics service.
- **OpenAI or another host you use:** receives tool results and content supplied
through that host. Its processing and retention are governed by your relationship
with that provider, not the Sentry opt-out.
Expand All @@ -158,6 +162,8 @@ Where personal data is transferred outside the EEA, applicable transfer
requirements must be met, such as an adequacy decision or appropriate contractual
safeguards. Contact us for information about safeguards applicable to your data.
See also [Sentry's privacy policy](https://sentry.io/privacy/),
[Vercel's privacy policy](https://vercel.com/legal/privacy-policy),
[MotherDuck's privacy policy](https://motherduck.com/privacy-policy/),
[Mixpanel's privacy policy](https://mixpanel.com/legal/privacy-policy/),
[GitHub's privacy statement](https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement),
and [OpenAI's privacy policy](https://openai.com/policies/privacy-policy/).
Expand All @@ -168,7 +174,7 @@ and [OpenAI's privacy policy](https://openai.com/policies/privacy-policy/).
| --- | --- |
| Sentry errors/crashes | 90 days under our Sentry Team plan. |
| Sentry performance spans and Application Metrics | 30 days under our Sentry Team plan. |
| Mixpanel product analytics | Up to 24 months, then deleted. |
| Product analytics | Up to 24 months, then deleted. |
| Local live logs | Held in bounded memory buffers. A server log session expires after five minutes without reads or keep-alives; closing the session stops collection. Copies already attached to the host follow the host's retention. |
| Saved performance recordings | Stored under `~/Library/Application Support/mobile-dev/recordings` until you remove them; the recording store has no automatic age-based expiry. |
| TraceSift integration results/references and the chosen project folder | Stored under `~/.tracesift/integrations/mobile-dev` by default, or the corresponding `TRACE_SIFT_HOME` directory, until removed. Original profiles and the TraceSift service's own data are separate. |
Expand All @@ -193,7 +199,7 @@ operating system, and your own backup tools manage their copies separately.
components and prevents creation of a new installation ID. It does not delete
reports already sent or disable GitHub update checks or host processing.
- **Disable product analytics only:** set `MOBILE_DEV_ANALYTICS=off` (or
`DO_NOT_TRACK=1`) in the same environment and restart. Mixpanel events stop;
`DO_NOT_TRACK=1`) in the same environment and restart. Product analytics stop;
Sentry error and performance reporting continues unless you also turn it off.
- **Reset the installation ID:** stop Mobile Dev processes and remove only the
`anonymous-user-id` file listed above. A new ID is generated on the next start
Expand Down
21 changes: 12 additions & 9 deletions docs/telemetry.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,22 +55,25 @@ shell has no native Sentry SDK.

## Product analytics

Since 0.1.177, release MCP servers send basic product analytics to Mixpanel's EU
project to count installations and feature use. `instrumentProductAnalytics`
(`packages/core/src/analytics.ts`) wraps the `tools/call` handler and reports
Since 0.1.177, release MCP servers send basic product analytics to count
installations and feature use. Through 0.1.189 they went to Mixpanel's EU project;
later releases send them to our own analytics service at `anal.margelo.com`, which
takes Mixpanel's ingestion API, so the requests are unchanged apart from the host
and project token. Mixpanel's history up to 19 November 2026 was imported there.
`instrumentProductAnalytics` (`packages/core/src/analytics.ts`) wraps the `tools/call` handler and reports
`Tool Called` with the tool name and a `success` or `error` outcome; the chat
client's initialization reports `Session Started`. Every event carries only
`host`, `plugin_version`, `os` (`process.platform`), a timestamp, an insert ID and
the server-owned installation ID as `distinct_id`. Tools `isFrequentTool` lists are
skipped. Events are batched (50 per request, at most 500 queued), sent every 30
seconds and when the plugin closes; failed batches are dropped. Requests go to
`api-eu.mixpanel.com/track?ip=0&verbose=1`: Mixpanel neither stores nor geolocates
`anal.margelo.com/track?ip=0&verbose=1`: the service neither stores nor geolocates
the IP, and reports rejected batches in its reply.

Each connected session also queues an installation profile with the same
`distinct_id`, `host`, `plugin_version` and `os`. Profiles are sent through
`api-eu.mixpanel.com/engage?ip=0&verbose=1` with `$ip: "0"`, so they appear in
Mixpanel's Users view without IP-derived location, names or account details.
`anal.margelo.com/engage?ip=0&verbose=1` with `$ip: "0"`, so they appear in the
service's Users view without IP-derived location, names or account details.
Existing events join the profile by installation ID. Profiles are pseudonymous,
not a guarantee of anonymisation under data protection law. A failed profile
update stays pending until the next flush; closing makes one final attempt and
Expand All @@ -79,11 +82,11 @@ discards any pending update. Profile failures do not prevent event delivery.
Development builds send nothing, and neither does the iOS mirror service. The
choice is made when the server starts: `MOBILE_DEV_TELEMETRY=off` turns analytics
off along with Sentry; `MOBILE_DEV_ANALYTICS=off` or `DO_NOT_TRACK=1` turns off only
analytics, including profile updates. `analytics.flush` counts each Mixpanel request
with `component=server` and `outcome=success` only when Mixpanel accepted the batch.
analytics, including profile updates. `analytics.flush` counts each analytics request
with `component=server` and `outcome=success` only when the service accepted the batch.
The bounded `endpoint` attribute distinguishes `track` event batches from `engage`
profile updates; before installation profiles, the metric counted only event batches.
The panel UI sends nothing to Mixpanel, and its CSP is unchanged.
The panel UI sends no product analytics, and its CSP is unchanged.

## Volume policy

Expand Down
12 changes: 6 additions & 6 deletions packages/core/src/analytics.ts
Original file line number Diff line number Diff line change
Expand Up @@ -3,13 +3,13 @@ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { CallToolRequestSchema } from "@modelcontextprotocol/sdk/types.js";
import type { CallToolRequest, CallToolResult } from "@modelcontextprotocol/sdk/types.js";
import { PLUGIN_VERSION } from "@mobile-dev/shared/version.ts";
import { isFrequentTool, MIXPANEL_TOKEN, MIXPANEL_TRACK_URL, MIXPANEL_ENGAGE_URL, TELEMETRY_INTERVAL_MS } from "@mobile-dev/shared/telemetry.ts";
import { isFrequentTool, ANALYTICS_TOKEN, ANALYTICS_TRACK_URL, ANALYTICS_ENGAGE_URL, TELEMETRY_INTERVAL_MS } from "@mobile-dev/shared/telemetry.ts";
import type { TelemetryEnvironment, TelemetryHost } from "@mobile-dev/shared/telemetry.ts";
import { TELEMETRY_ENVIRONMENT } from "./telemetry-environment.ts";
import { getTelemetryIdentity } from "./telemetry-identity.ts";
import { recordAnalyticsFlush, serverTelemetryHost } from "./telemetry.ts";

// Mixpanel takes at most 50 events per request; the queue stays bounded while it is unreachable.
// Mixpanel's API takes at most 50 events per request; the queue stays bounded while it is unreachable.
const BATCH_SIZE = 50;
const MAX_QUEUED = 500;

Expand Down Expand Up @@ -54,12 +54,12 @@ async function deliver(send: Send, url: string, batch: AnalyticsEvent[] | Analyt
}

/**
* Sends pseudonymous product analytics to Mixpanel from release servers: connected host sessions and
* Sends pseudonymous product analytics to our analytics service from release servers: connected host sessions and
* the tools they call, plus an installation profile with its host, plugin version and OS. Never sends
* arguments, results, device details, paths or IP properties. Install before tools register.
*/
export function instrumentProductAnalytics(server: McpServer, options: AnalyticsOptions = {}): ProductAnalytics {
const { token = MIXPANEL_TOKEN, environment = TELEMETRY_ENVIRONMENT, userId = getTelemetryIdentity()?.userId, send = fetch } = options;
const { token = ANALYTICS_TOKEN, environment = TELEMETRY_ENVIRONMENT, userId = getTelemetryIdentity()?.userId, send = fetch } = options;
if (token === "" || environment !== "release" || userId === undefined || optedOut()) return disabled;
const distinctId = userId;
const queue: AnalyticsEvent[] = [];
Expand All @@ -71,13 +71,13 @@ export function instrumentProductAnalytics(server: McpServer, options: Analytics
async function drain() {
const profile = pendingProfile;
if (profile !== undefined) {
const outcome = await deliver(send, MIXPANEL_ENGAGE_URL, [profile]);
const outcome = await deliver(send, ANALYTICS_ENGAGE_URL, [profile]);
recordAnalyticsFlush(outcome, "engage");
if (outcome === "success" && pendingProfile === profile) pendingProfile = undefined;
}
while (queue.length > 0) {
const batch = queue.splice(0, BATCH_SIZE);
const outcome = await deliver(send, MIXPANEL_TRACK_URL, batch);
const outcome = await deliver(send, ANALYTICS_TRACK_URL, batch);
recordAnalyticsFlush(outcome, "track");
}
}
Expand Down
2 changes: 1 addition & 1 deletion packages/core/src/telemetry.ts
Original file line number Diff line number Diff line change
Expand Up @@ -111,7 +111,7 @@ export function recordTraceSiftPayload(kind: "task" | "react", bytes: number) {
Sentry.metrics.gauge("tracesift.explore.payload_bytes", bytes, { unit: "byte", attributes });
}

/** Counts each batch sent to Mixpanel by whether Mixpanel accepted it. */
/** Counts each batch sent to the analytics service by whether it accepted it. */
export function recordAnalyticsFlush(outcome: "success" | "failed", endpoint: "track" | "engage") {
if (process.env.MOBILE_DEV_TELEMETRY === "off") return;
Sentry.metrics.count("analytics.flush", 1, { attributes: { component: "server", outcome, endpoint } });
Expand Down
20 changes: 10 additions & 10 deletions packages/core/test/analytics.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ import type { Envelope } from "@sentry/core";
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
import { MIXPANEL_TRACK_URL, MIXPANEL_ENGAGE_URL, TELEMETRY_INTERVAL_MS } from "../../shared/src/telemetry.ts";
import { ANALYTICS_TRACK_URL, ANALYTICS_ENGAGE_URL, TELEMETRY_INTERVAL_MS } from "../../shared/src/telemetry.ts";
import { PLUGIN_VERSION } from "../../shared/src/version.ts";
import { instrumentProductAnalytics } from "../src/analytics.ts";
import type { AnalyticsOptions } from "../src/analytics.ts";
Expand All @@ -22,14 +22,14 @@ function mixpanel(status = 1) {
return Response.json({ error: status === 1 ? "" : "rejected", status });
};
function events() {
const batches = requests.filter(request => request.url === MIXPANEL_TRACK_URL);
const batches = requests.filter(request => request.url === ANALYTICS_TRACK_URL);
return batches.flatMap(request => {
const batch: SentEvent[] = JSON.parse(request.body);
return batch;
});
}
function profiles() {
const batches = requests.filter(request => request.url === MIXPANEL_ENGAGE_URL);
const batches = requests.filter(request => request.url === ANALYTICS_ENGAGE_URL);
return batches.flatMap(request => {
const batch: SentProfile[] = JSON.parse(request.body);
return batch;
Expand Down Expand Up @@ -71,10 +71,10 @@ test("product analytics joins EU installation profiles to events without IPs or
await client.close();
await analytics.close();
assert.equal(requests.length, 2);
assert.equal(requests[0].url, MIXPANEL_ENGAGE_URL);
assert.equal(requests[1].url, MIXPANEL_TRACK_URL);
assert.match(MIXPANEL_TRACK_URL, /^https:\/\/api-eu\.mixpanel\.com\/track\?(?=.*\bip=0\b)(?=.*\bverbose=1\b)/);
assert.match(MIXPANEL_ENGAGE_URL, /^https:\/\/api-eu\.mixpanel\.com\/engage\?(?=.*\bip=0\b)(?=.*\bverbose=1\b)/);
assert.equal(requests[0].url, ANALYTICS_ENGAGE_URL);
assert.equal(requests[1].url, ANALYTICS_TRACK_URL);
assert.match(ANALYTICS_TRACK_URL, /^https:\/\/anal\.margelo\.com\/track\?(?=.*\bip=0\b)(?=.*\bverbose=1\b)/);
assert.match(ANALYTICS_ENGAGE_URL, /^https:\/\/anal\.margelo\.com\/engage\?(?=.*\bip=0\b)(?=.*\bverbose=1\b)/);
const sentProfiles = profiles();
assert.deepEqual(sentProfiles, [{
$token: "token", $distinct_id: "anon_1", $ip: "0",
Expand Down Expand Up @@ -135,7 +135,7 @@ test("product analytics batches at Mixpanel's limit and counts batches Mixpanel
const closing = analytics.close();
delivery.resolve();
await closing;
const eventRequests = requests.filter(request => request.url === MIXPANEL_TRACK_URL);
const eventRequests = requests.filter(request => request.url === ANALYTICS_TRACK_URL);
const batchSizes = eventRequests.map(request => {
const batch: SentEvent[] = JSON.parse(request.body);
return batch.length;
Expand Down Expand Up @@ -163,7 +163,7 @@ test("a rejected profile retries on the existing timer without blocking events o
let profileAttempts = 0;
const send = async (url: string, init: RequestInit) => {
const response = await recorded.send(url, init);
if (url === MIXPANEL_ENGAGE_URL) {
if (url === ANALYTICS_ENGAGE_URL) {
profileAttempts += 1;
if (profileAttempts === 1) return Response.json({ status: 0, error: "rejected" });
}
Expand Down Expand Up @@ -200,7 +200,7 @@ test("closing waits for an in-flight profile and flushes queued events", async (
const gate = Promise.withResolvers<Response>();
const send = async (url: string, init: RequestInit) => {
const response = await recorded.send(url, init);
if (url === MIXPANEL_ENGAGE_URL) return gate.promise;
if (url === ANALYTICS_ENGAGE_URL) return gate.promise;
return response;
};
const { client, analytics } = await connect({ send });
Expand Down
12 changes: 6 additions & 6 deletions packages/shared/src/telemetry.ts
Original file line number Diff line number Diff line change
Expand Up @@ -8,14 +8,14 @@ export const SENTRY_SERVER_DSN = "https://2ee03a9449e1f1b48e3e7c7606b6f562@o4512
export const SENTRY_NATIVE_DSN = "https://1deeefda39022a67df902c638dcf3c8f@o4512180958068736.ingest.de.sentry.io/4512181036318800";
export const SENTRY_ORIGIN = "https://o4512180958068736.ingest.de.sentry.io";
export const SENTRY_RELEASE = `mobile-dev@${PLUGIN_VERSION}`;
/** Public token of the EU-resident Mixpanel project for product analytics. */
export const MIXPANEL_TOKEN = "780e4817b73c1234479ad8d418d34e89";
/** Public token of Mobile Dev's project in our analytics service, sent with every event like a Mixpanel token. */
export const ANALYTICS_TOKEN = "8f6bad25f85f55b745a41843c257a3c6";
/**
* Mixpanel's EU ingestion endpoint. `ip=0` stops Mixpanel from storing or geolocating the sender's IP;
* `verbose=1` makes rejected batches say so, since Mixpanel answers them with HTTP 200 too.
* Our analytics service, which takes Mixpanel's ingestion API. `ip=0` stops it from deriving a location
* from the sender's IP; `verbose=1` makes rejected batches say so, since the API can answer them with HTTP 200.
*/
export const MIXPANEL_TRACK_URL = "https://api-eu.mixpanel.com/track?ip=0&verbose=1";
export const MIXPANEL_ENGAGE_URL = "https://api-eu.mixpanel.com/engage?ip=0&verbose=1";
export const ANALYTICS_TRACK_URL = "https://anal.margelo.com/track?ip=0&verbose=1";
export const ANALYTICS_ENGAGE_URL = "https://anal.margelo.com/engage?ip=0&verbose=1";
export const TELEMETRY_META_KEY = "mobile-dev/telemetry";
export const TELEMETRY_INTERVAL_MS = 30_000;
export const TELEMETRY_HOSTS = ["codex", "claude", "cursor", "mac", "other"] as const;
Expand Down
Loading
Loading