{"openapi":"3.1.0","info":{"title":"Mixpanel Flags and Catalogs (BYOK) API","version":"0.1.0","description":"Mixpanel Flags and Catalogs (BYOK) lets an AI assistant read your own Mixpanel Flags and Catalogs data through the Mixpanel Flags and Catalogs API with a key you supply (service account username). Read-only: 6 tools (list_feature_flags, get_feature_flag, list_experiments, get_experiment, list_saved_cohorts, list_saved_funnels). The BYOK key travels with each request, is used for that one call...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-mixpanel-catalogs.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-mixpanel-catalogs/docs"},"termsOfService":"https://connectorbay.com/byok-mixpanel-catalogs/terms"},"servers":[{"url":"https://byok-mixpanel-catalogs.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-mixpanel-catalogs/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_feature_flags":{"post":{"operationId":"list_feature_flags","summary":"List the feature flags of a project workspace with key, name, status (enabled, disabled, archived), serving method, tags","description":"List the feature flags of a project workspace with key, name, status (enabled, disabled, archived), serving method, tags and enable time. Rollout rules are left out; use get_feature_flag for them. Use for \"Which Mixpanel feature flags are enabled\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Numeric Mixpanel project id (shown in project settings and in the project URL).","maximum":999999999999,"minimum":1,"title":"Project Id","type":"integer"},"workspace_id":{"description":"Numeric workspace id of the project (the number after /workspace/ in the Mixpanel URL).","maximum":999999999999,"minimum":1,"title":"Workspace Id","type":"integer"},"include_archived":{"anyOf":[{"enum":["true","false"],"type":"string"},{"type":"null"}],"default":null,"description":"Set to true to include archived flags (left out by default).","title":"Include Archived"}},"required":["project_id","workspace_id"],"title":"list_feature_flagsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_feature_flag":{"post":{"operationId":"get_feature_flag","summary":"Get one feature flag with its status, serving method, variants and rollout rules (cohorts, percentages, variant splits).","description":"Get one feature flag with its status, serving method, variants and rollout rules (cohorts, percentages, variant splits). Use for \"Show the rollout rules of a Mixpanel feature flag\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Numeric Mixpanel project id (shown in project settings and in the project URL).","maximum":999999999999,"minimum":1,"title":"Project Id","type":"integer"},"workspace_id":{"description":"Numeric workspace id of the project (the number after /workspace/ in the Mixpanel URL).","maximum":999999999999,"minimum":1,"title":"Workspace Id","type":"integer"},"flag_id":{"description":"Feature flag id (a UUID) from list_feature_flags.","maxLength":64,"title":"Flag Id","type":"string"}},"required":["project_id","workspace_id","flag_id"],"title":"get_feature_flagArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_experiments":{"post":{"operationId":"list_experiments","summary":"List the experiments of a workspace with name, hypothesis, status, tags and start and end dates. Variants, metrics and r","description":"List the experiments of a workspace with name, hypothesis, status, tags and start and end dates. Variants, metrics and result caches are left out. Use for \"Which Mixpanel experiments are running\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"workspace_id":{"description":"Numeric workspace id of the project (the number after /workspace/ in the Mixpanel URL).","maximum":999999999999,"minimum":1,"title":"Workspace Id","type":"integer"}},"required":["workspace_id"],"title":"list_experimentsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_experiment":{"post":{"operationId":"get_experiment","summary":"Get one experiment with its hypothesis, status, dates, variants, goal metrics and settings. Use for \"Show the variants a","description":"Get one experiment with its hypothesis, status, dates, variants, goal metrics and settings. Use for \"Show the variants and metrics of a Mixpanel experiment\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"workspace_id":{"description":"Numeric workspace id of the project (the number after /workspace/ in the Mixpanel URL).","maximum":999999999999,"minimum":1,"title":"Workspace Id","type":"integer"},"experiment_id":{"description":"Experiment id (a UUID) from list_experiments.","maxLength":64,"title":"Experiment Id","type":"string"}},"required":["workspace_id","experiment_id"],"title":"get_experimentArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_saved_cohorts":{"post":{"operationId":"list_saved_cohorts","summary":"List the saved cohorts of a project with id, name, description, size, creation time and visibility. Cohort members are n","description":"List the saved cohorts of a project with id, name, description, size, creation time and visibility. Cohort members are not returned. Use for \"Which cohorts are saved in my Mixpanel project\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Numeric Mixpanel project id (required with a service account).","maximum":999999999999,"minimum":1,"title":"Project Id","type":"integer"},"workspace_id":{"anyOf":[{"maximum":999999999999,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Numeric workspace id, when the project has several workspaces.","title":"Workspace Id"}},"required":["project_id"],"title":"list_saved_cohortsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_saved_funnels":{"post":{"operationId":"list_saved_funnels","summary":"List the saved funnels of a project with their ids and names. Use for \"Which saved funnels do we have in Mixpanel\".","description":"List the saved funnels of a project with their ids and names. Use for \"Which saved funnels do we have in Mixpanel\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Numeric Mixpanel project id (required with a service account).","maximum":999999999999,"minimum":1,"title":"Project Id","type":"integer"},"workspace_id":{"anyOf":[{"maximum":999999999999,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Numeric workspace id, when the project has several workspaces.","title":"Workspace Id"}},"required":["project_id"],"title":"list_saved_funnelsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}