{"openapi":"3.1.0","info":{"title":"Amplitude Taxonomy (BYOK) API","version":"0.1.0","description":"Amplitude Taxonomy (BYOK) lets an AI assistant read your own Amplitude Taxonomy data through the Amplitude Taxonomy API with a key you supply (project API key). Read-only: 9 tools (list_event_categories, get_event_category, list_event_types, get_event_type, list_shared_event_properties, list_user_properties, get_user_property, list_group_properties, get_group_property). The BYOK key travels with...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-amplitude-taxonomy.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-amplitude-taxonomy/docs"},"termsOfService":"https://connectorbay.com/byok-amplitude-taxonomy/terms"},"servers":[{"url":"https://byok-amplitude-taxonomy.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-amplitude-taxonomy/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_event_categories":{"post":{"operationId":"list_event_categories","summary":"List the event categories used to group event types in the tracking plan (id and name). Use for \"Which event categories ","description":"List the event categories used to group event types in the tracking plan (id and name). Use for \"Which event categories does my Amplitude tracking plan have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_event_categoriesArguments","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_event_category":{"post":{"operationId":"get_event_category","summary":"Get the id of one event category by its name. Use for \"What is the id of the Conversion event category in Amplitude\".","description":"Get the id of one event category by its name. Use for \"What is the id of the Conversion event category in Amplitude\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category_name":{"description":"Exact category name (URL-encoded for you).","maxLength":200,"title":"Category Name","type":"string"}},"required":["category_name"],"title":"get_event_categoryArguments","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_event_types":{"post":{"operationId":"list_event_types","summary":"List the event types in the tracking plan with category, display name, description, active flag, tags and owner. Hidden ","description":"List the event types in the tracking plan with category, display name, description, active flag, tags and owner. Hidden events are not returned. Use for \"Which events are planned in my Amplitude tracking plan\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"show_deleted":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to include deleted items (default false).","title":"Show Deleted"}},"title":"list_event_typesArguments","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_event_type":{"post":{"operationId":"get_event_type","summary":"Get one event type by its exact name: category, display name, description, active flag, tags and owner. Use for \"Describ","description":"Get one event type by its exact name: category, display name, description, active flag, tags and owner. Use for \"Describe the Sign Up event in Amplitude\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"event_type":{"description":"Exact event name, for example Sign Up (URL-encoded for you).","maxLength":200,"title":"Event Type","type":"string"}},"required":["event_type"],"title":"get_event_typeArguments","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_shared_event_properties":{"post":{"operationId":"list_shared_event_properties","summary":"List the shared event properties in the tracking plan (those not tied to one event): type, description, allowed values, ","description":"List the shared event properties in the tracking plan (those not tied to one event): type, description, allowed values, required flag and classifications. Use for \"Which shared event properties are defined in Amplitude\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_shared_event_propertiesArguments","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_user_properties":{"post":{"operationId":"list_user_properties","summary":"List the user properties in the tracking plan with type, description, allowed values, classifications and deleted flag. ","description":"List the user properties in the tracking plan with type, description, allowed values, classifications and deleted flag. Custom properties start with gp:. Use for \"Which user properties does Amplitude know about\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"show_deleted":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to include deleted items (default false).","title":"Show Deleted"}},"title":"list_user_propertiesArguments","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_user_property":{"post":{"operationId":"get_user_property","summary":"Get one user property by name (prefix custom properties with gp:). Use for \"Describe the gp:plan user property in Amplit","description":"Get one user property by name (prefix custom properties with gp:). Use for \"Describe the gp:plan user property in Amplitude\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"user_property":{"description":"User property name, for example gp:plan.","maxLength":200,"title":"User Property","type":"string"},"show_deleted":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to include deleted items (default false).","title":"Show Deleted"}},"required":["user_property"],"title":"get_user_propertyArguments","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_group_properties":{"post":{"operationId":"list_group_properties","summary":"List group properties in the tracking plan, optionally for one group type: type, description, allowed values and classif","description":"List group properties in the tracking plan, optionally for one group type: type, description, allowed values and classifications. Use for \"Which properties do Amplitude company groups have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"group_type":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Name of a group type to list or look up properties for; leave out for shared group properties.","title":"Group Type"}},"title":"list_group_propertiesArguments","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_group_property":{"post":{"operationId":"get_group_property","summary":"Get one group property by name (prefix custom properties with grp:), optionally for one group type. Use for \"Describe th","description":"Get one group property by name (prefix custom properties with grp:), optionally for one group type. Use for \"Describe the grp:industry group property in Amplitude\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"group_property":{"description":"Group property name, for example grp:industry.","maxLength":200,"title":"Group Property","type":"string"},"group_type":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Name of a group type to list or look up properties for; leave out for shared group properties.","title":"Group Type"}},"required":["group_property"],"title":"get_group_propertyArguments","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}}}}