Segment

Segment MCP Server for Cloudflare Workers

Available Tools

108 tools available in the Segment MCP server. Each tool can be called by AI assistants to perform specific actions.

segment_list_users

List all users in the workspace.

Args:

count: Number of users to return (default: 20)
cursor: Pagination cursor
format: Response format ('json' or 'markdown')

Returns: Paginated list of users.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

segment_get_user

Get details for a specific user.

Args:

userId: The user ID (required)

Returns: User details.

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "userId": {
      "type": "string",
      "description": "User ID"
    }
  }
}

segment_delete_users

Delete users from the workspace.

WARNING: This action is irreversible.

Args:

userIds: Array of user IDs to delete (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "userIds"
  ],
  "properties": {
    "userIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "User IDs to delete"
    }
  }
}

segment_list_user_groups

List all user groups in the workspace.

Args:

count: Number of groups to return (default: 20)
cursor: Pagination cursor
format: Response format ('json' or 'markdown')

Returns: Paginated list of user groups.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

segment_get_user_group

Get details for a specific user group.

Args:

groupId: The group ID (required)

Returns: User group details.

{
  "type": "object",
  "required": [
    "groupId"
  ],
  "properties": {
    "groupId": {
      "type": "string",
      "description": "Group ID"
    }
  }
}

segment_create_user_group

Create a new user group.

Args:

name: Group name (required)

Returns: The created user group.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Group name"
    }
  }
}

segment_update_user_group

Update a user group.

Args:

groupId: The group ID (required)
name: New group name (required)

Returns: The updated user group.

{
  "type": "object",
  "required": [
    "groupId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New group name"
    },
    "groupId": {
      "type": "string",
      "description": "Group ID"
    }
  }
}

segment_delete_user_group

Delete a user group.

WARNING: This action is irreversible.

Args:

groupId: The group ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "groupId"
  ],
  "properties": {
    "groupId": {
      "type": "string",
      "description": "Group ID"
    }
  }
}

segment_add_users_to_user_group

Add users to a user group.

Args:

groupId: The group ID (required)
emails: Array of user emails to add (required)

Returns: Confirmation of addition.

{
  "type": "object",
  "required": [
    "groupId",
    "emails"
  ],
  "properties": {
    "emails": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "User emails to add"
    },
    "groupId": {
      "type": "string",
      "description": "Group ID"
    }
  }
}

segment_remove_users_from_user_group

Remove users from a user group.

Args:

groupId: The group ID (required)
emails: Array of user emails to remove (required)

Returns: Confirmation of removal.

{
  "type": "object",
  "required": [
    "groupId",
    "emails"
  ],
  "properties": {
    "emails": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "User emails to remove"
    },
    "groupId": {
      "type": "string",
      "description": "Group ID"
    }
  }
}

segment_list_invites

List all pending invites.

Args:

count: Number of invites to return (default: 20)
cursor: Pagination cursor
format: Response format ('json' or 'markdown')

Returns: Paginated list of invites.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

segment_create_invites

Send invites to new users.

Args:

emails: Array of email addresses to invite (required)

Returns: Confirmation of invites sent.

{
  "type": "object",
  "required": [
    "emails"
  ],
  "properties": {
    "emails": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Email addresses to invite"
    }
  }
}

segment_delete_invites

Cancel pending invites.

Args:

emails: Array of email addresses to cancel (required)

Returns: Confirmation of invites cancelled.

{
  "type": "object",
  "required": [
    "emails"
  ],
  "properties": {
    "emails": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Email addresses to cancel"
    }
  }
}

segment_list_labels

List all labels in the workspace.

Labels are used to organize and filter resources.

Args:

count: Number of labels to return (default: 20)
cursor: Pagination cursor
format: Response format ('json' or 'markdown')

Returns: Paginated list of labels.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

segment_create_label

Create a new label.

Args:

key: Label key (required)
value: Label value (required)
description: Label description

Returns: The created label.

{
  "type": "object",
  "required": [
    "key",
    "value"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "Label key"
    },
    "value": {
      "type": "string",
      "description": "Label value"
    },
    "description": {
      "type": "string",
      "description": "Label description"
    }
  }
}

segment_delete_label

Delete a label.

WARNING: This action is irreversible.

Args:

key: Label key (required)
value: Label value (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "key",
    "value"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "Label key"
    },
    "value": {
      "type": "string",
      "description": "Label value"
    }
  }
}

segment_list_regulations_from_source

List regulations (deletion/suppression requests) for a source.

Args:

sourceId: The source ID (required)
count: Number to return (default: 20)
cursor: Pagination cursor
format: Response format ('json' or 'markdown')

Returns: Paginated list of regulations.

{
  "type": "object",
  "required": [
    "sourceId"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "sourceId": {
      "type": "string",
      "description": "Source ID"
    }
  }
}

segment_create_source_regulation

Create a regulation (deletion/suppression request) for a source.

Use this for GDPR/CCPA compliance to delete or suppress user data.

Args:

sourceId: The source ID (required)
regulationType: Type of regulation (DELETE, SUPPRESS, etc.)
subjectType: Type of subject (USER_ID, etc.)
subjectIds: Array of subject IDs to regulate

Returns: The created regulation.

{
  "type": "object",
  "required": [
    "sourceId",
    "regulationType",
    "subjectType",
    "subjectIds"
  ],
  "properties": {
    "sourceId": {
      "type": "string",
      "description": "Source ID"
    },
    "subjectIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Subject IDs to regulate"
    },
    "subjectType": {
      "type": "string",
      "description": "Subject type (USER_ID, etc.)"
    },
    "regulationType": {
      "type": "string",
      "description": "Regulation type (DELETE, SUPPRESS, etc.)"
    }
  }
}

segment_get_regulation

Get details for a regulation.

Args:

regulationId: The regulation ID (required)

Returns: Regulation details including status.

{
  "type": "object",
  "required": [
    "regulationId"
  ],
  "properties": {
    "regulationId": {
      "type": "string",
      "description": "Regulation ID"
    }
  }
}

segment_delete_regulation

Delete a regulation request.

Args:

regulationId: The regulation ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "regulationId"
  ],
  "properties": {
    "regulationId": {
      "type": "string",
      "description": "Regulation ID"
    }
  }
}

segment_list_audit_events

List audit events for the workspace.

Audit events track changes made to workspace resources.

Args:

count: Number to return (default: 20)
cursor: Pagination cursor
resourceId: Filter by resource ID
resourceType: Filter by resource type
format: Response format ('json' or 'markdown')

Returns: Paginated list of audit events.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "resourceId": {
      "type": "string"
    },
    "resourceType": {
      "type": "string"
    }
  }
}

segment_get_workspace

Get details for the current workspace.

Returns: Workspace details including ID, name, and slug.

{
  "type": "object",
  "properties": {}
}

segment_get_sources_catalog

Browse the sources catalog.

Lists all available source types that can be created.

Args:

count: Number of sources to return (default: 20)
cursor: Pagination cursor
format: Response format ('json' or 'markdown')

Returns: Paginated list of source types.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

segment_get_source_metadata

Get metadata for a source type.

Args:

sourceMetadataId: The source metadata ID (required)

Returns: Source type metadata including description, logos, and categories.

{
  "type": "object",
  "required": [
    "sourceMetadataId"
  ],
  "properties": {
    "sourceMetadataId": {
      "type": "string",
      "description": "Source metadata ID"
    }
  }
}

segment_get_destinations_catalog

Browse the destinations catalog.

Lists all available destination types that can be created.

Args:

count: Number of destinations to return (default: 20)
cursor: Pagination cursor
format: Response format ('json' or 'markdown')

Returns: Paginated list of destination types.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

segment_get_destination_metadata

Get metadata for a destination type.

Args:

destinationMetadataId: The destination metadata ID (required)

Returns: Destination type metadata including description, supported methods, and actions.

{
  "type": "object",
  "required": [
    "destinationMetadataId"
  ],
  "properties": {
    "destinationMetadataId": {
      "type": "string",
      "description": "Destination metadata ID"
    }
  }
}

segment_get_warehouses_catalog

Browse the warehouses catalog.

Lists all available warehouse types (Snowflake, BigQuery, Redshift, etc.).

Args:

count: Number of warehouses to return (default: 20)
cursor: Pagination cursor
format: Response format ('json' or 'markdown')

Returns: Paginated list of warehouse types.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

segment_get_warehouse_metadata

Get metadata for a warehouse type.

Args:

warehouseMetadataId: The warehouse metadata ID (required)

Returns: Warehouse type metadata including description and logos.

{
  "type": "object",
  "required": [
    "warehouseMetadataId"
  ],
  "properties": {
    "warehouseMetadataId": {
      "type": "string",
      "description": "Warehouse metadata ID"
    }
  }
}

segment_list_destinations

List all destinations in the workspace.

Returns a paginated list of destinations configured in your workspace.

Args:

count: Number of destinations to return (default: 20)
cursor: Pagination cursor from previous response
format: Response format ('json' or 'markdown')

Returns: Paginated list of destinations with their IDs, names, types, and enabled status.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of destinations to return"
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

segment_get_destination

Get details for a specific destination.

Args:

destinationId: The destination ID (required)
format: Response format ('json' or 'markdown')

Returns: Destination details including settings, metadata, and configuration.

{
  "type": "object",
  "required": [
    "destinationId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "destinationId": {
      "type": "string",
      "description": "Destination ID"
    }
  }
}

segment_create_destination

Create a new destination connected to a source.

Args:

sourceId: The source ID to connect (required)
metadataId: The destination catalog ID (use segment_get_destinations_catalog)
name: Display name for the destination (required)
settings: Destination-specific settings
enabled: Whether the destination is enabled (default: true)

Returns: The created destination object.

{
  "type": "object",
  "required": [
    "sourceId",
    "metadataId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Display name for the destination"
    },
    "enabled": {
      "type": "boolean",
      "default": true,
      "description": "Whether the destination is enabled"
    },
    "settings": {
      "type": "object",
      "description": "Destination-specific settings"
    },
    "sourceId": {
      "type": "string",
      "description": "Source ID to connect"
    },
    "metadataId": {
      "type": "string",
      "description": "Destination catalog ID"
    }
  }
}

segment_update_destination

Update an existing destination.

Args:

destinationId: The destination ID to update (required)
name: New display name
enabled: Enable or disable the destination
settings: Updated destination-specific settings

Returns: The updated destination object.

{
  "type": "object",
  "required": [
    "destinationId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New display name"
    },
    "enabled": {
      "type": "boolean",
      "description": "Enable or disable"
    },
    "settings": {
      "type": "object",
      "description": "Updated settings"
    },
    "destinationId": {
      "type": "string",
      "description": "Destination ID to update"
    }
  }
}

segment_delete_destination

Delete a destination.

WARNING: This action is irreversible.

Args:

destinationId: The destination ID to delete (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "destinationId"
  ],
  "properties": {
    "destinationId": {
      "type": "string",
      "description": "Destination ID to delete"
    }
  }
}

segment_list_destination_subscriptions

List subscriptions for a destination.

Subscriptions define which events are sent to an Actions destination.

Args:

destinationId: The destination ID (required)
format: Response format ('json' or 'markdown')

Returns: List of subscriptions for the destination.

{
  "type": "object",
  "required": [
    "destinationId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "destinationId": {
      "type": "string",
      "description": "Destination ID"
    }
  }
}

segment_get_destination_subscription

Get a specific subscription for a destination.

Args:

destinationId: The destination ID (required)
subscriptionId: The subscription ID (required)

Returns: The subscription details.

{
  "type": "object",
  "required": [
    "destinationId",
    "subscriptionId"
  ],
  "properties": {
    "destinationId": {
      "type": "string",
      "description": "Destination ID"
    },
    "subscriptionId": {
      "type": "string",
      "description": "Subscription ID"
    }
  }
}

segment_create_destination_subscription

Create a subscription for a destination.

Args:

destinationId: The destination ID (required)
name: Subscription name (required)
actionId: The action ID (required)
trigger: FQL trigger expression (required)
enabled: Whether enabled (default: true)
settings: Action-specific settings

Returns: The created subscription.

{
  "type": "object",
  "required": [
    "destinationId",
    "name",
    "actionId",
    "trigger"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Subscription name"
    },
    "enabled": {
      "type": "boolean",
      "default": true
    },
    "trigger": {
      "type": "string",
      "description": "FQL trigger expression"
    },
    "actionId": {
      "type": "string",
      "description": "Action ID"
    },
    "settings": {
      "type": "object"
    },
    "destinationId": {
      "type": "string",
      "description": "Destination ID"
    }
  }
}

segment_update_destination_subscription

Update a destination subscription.

Args:

destinationId: The destination ID (required)
subscriptionId: The subscription ID (required)
name: New name
enabled: Enable or disable
trigger: New FQL trigger expression
settings: Updated settings

Returns: The updated subscription.

{
  "type": "object",
  "required": [
    "destinationId",
    "subscriptionId"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "enabled": {
      "type": "boolean"
    },
    "trigger": {
      "type": "string"
    },
    "settings": {
      "type": "object"
    },
    "destinationId": {
      "type": "string",
      "description": "Destination ID"
    },
    "subscriptionId": {
      "type": "string",
      "description": "Subscription ID"
    }
  }
}

segment_delete_destination_subscription

Delete a destination subscription.

Args:

destinationId: The destination ID (required)
subscriptionId: The subscription ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "destinationId",
    "subscriptionId"
  ],
  "properties": {
    "destinationId": {
      "type": "string",
      "description": "Destination ID"
    },
    "subscriptionId": {
      "type": "string",
      "description": "Subscription ID"
    }
  }
}

segment_list_destination_filters

List filters for a destination.

Filters control which events are sent to a destination.

Args:

destinationId: The destination ID (required)
format: Response format ('json' or 'markdown')

Returns: List of filters for the destination.

{
  "type": "object",
  "required": [
    "destinationId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "destinationId": {
      "type": "string",
      "description": "Destination ID"
    }
  }
}

segment_create_destination_filter

Create a filter for a destination.

Filters can drop events, sample events, or modify properties.

Args:

sourceId: The source ID (required)
destinationId: The destination ID (required)
title: Filter title (required)
ifClause: FQL condition expression (required)
actions: Array of filter actions (required)
enabled: Whether enabled (default: true)
description: Filter description

Returns: The created filter.

{
  "type": "object",
  "required": [
    "sourceId",
    "destinationId",
    "title",
    "ifClause"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Filter title"
    },
    "enabled": {
      "type": "boolean",
      "default": true
    },
    "ifClause": {
      "type": "string",
      "description": "FQL condition"
    },
    "sourceId": {
      "type": "string",
      "description": "Source ID"
    },
    "description": {
      "type": "string"
    },
    "destinationId": {
      "type": "string",
      "description": "Destination ID"
    }
  }
}

segment_update_destination_filter

Update a destination filter.

Args:

destinationId: The destination ID (required)
filterId: The filter ID (required)
title: New title
ifClause: New FQL condition
actions: New filter actions
enabled: Enable or disable
description: New description

Returns: The updated filter.

{
  "type": "object",
  "required": [
    "destinationId",
    "filterId"
  ],
  "properties": {
    "title": {
      "type": "string"
    },
    "enabled": {
      "type": "boolean"
    },
    "filterId": {
      "type": "string",
      "description": "Filter ID"
    },
    "ifClause": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "destinationId": {
      "type": "string",
      "description": "Destination ID"
    }
  }
}

segment_delete_destination_filter

Delete a destination filter.

Args:

destinationId: The destination ID (required)
filterId: The filter ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "destinationId",
    "filterId"
  ],
  "properties": {
    "filterId": {
      "type": "string",
      "description": "Filter ID"
    },
    "destinationId": {
      "type": "string",
      "description": "Destination ID"
    }
  }
}

segment_list_spaces

List all Engage spaces in the workspace.

Spaces are Engage workspaces that contain audiences and computed traits.

Args:

count: Number of spaces to return (default: 20)
cursor: Pagination cursor
format: Response format ('json' or 'markdown')

Returns: Paginated list of spaces.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

segment_get_space

Get details for a specific Engage space.

Args:

spaceId: The space ID (required)

Returns: Space details.

{
  "type": "object",
  "required": [
    "spaceId"
  ],
  "properties": {
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    }
  }
}

segment_list_audiences

List all audiences in an Engage space.

Audiences are dynamic groups of users based on conditions.

Args:

spaceId: The space ID (required)
count: Number of audiences to return (default: 20)
cursor: Pagination cursor
format: Response format ('json' or 'markdown')

Returns: Paginated list of audiences.

{
  "type": "object",
  "required": [
    "spaceId"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    }
  }
}

segment_get_audience

Get details for a specific audience.

Args:

spaceId: The space ID (required)
audienceId: The audience ID (required)
format: Response format ('json' or 'markdown')

Returns: Audience details including definition and status.

{
  "type": "object",
  "required": [
    "spaceId",
    "audienceId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    },
    "audienceId": {
      "type": "string",
      "description": "Audience ID"
    }
  }
}

segment_deploy_function

Deploy a function to make it available for use.

Args:

functionId: The function ID (required)

Returns: The deployed function.

{
  "type": "object",
  "required": [
    "functionId"
  ],
  "properties": {
    "functionId": {
      "type": "string",
      "description": "Function ID"
    }
  }
}

segment_create_audience

Create a new audience in an Engage space.

Args:

spaceId: The space ID (required)
name: Audience name (required)
definition: Audience definition with query and type
description: Description
enabled: Whether enabled (default: true)

Returns: The created audience.

{
  "type": "object",
  "required": [
    "spaceId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Audience name"
    },
    "enabled": {
      "type": "boolean"
    },
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    },
    "description": {
      "type": "string"
    }
  }
}

segment_update_audience

Update an existing audience.

Args:

spaceId: The space ID (required)
audienceId: The audience ID (required)
name: New name
definition: New definition
description: New description
enabled: Enable or disable

Returns: The updated audience.

{
  "type": "object",
  "required": [
    "spaceId",
    "audienceId"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "enabled": {
      "type": "boolean"
    },
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    },
    "audienceId": {
      "type": "string",
      "description": "Audience ID"
    },
    "description": {
      "type": "string"
    }
  }
}

segment_delete_audience

Delete an audience.

WARNING: This action is irreversible.

Args:

spaceId: The space ID (required)
audienceId: The audience ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "spaceId",
    "audienceId"
  ],
  "properties": {
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    },
    "audienceId": {
      "type": "string",
      "description": "Audience ID"
    }
  }
}

segment_list_computed_traits

List all computed traits in an Engage space.

Computed traits are dynamically calculated user properties.

Args:

spaceId: The space ID (required)
count: Number of traits to return (default: 20)
cursor: Pagination cursor
format: Response format ('json' or 'markdown')

Returns: Paginated list of computed traits.

{
  "type": "object",
  "required": [
    "spaceId"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    }
  }
}

segment_get_computed_trait

Get details for a specific computed trait.

Args:

spaceId: The space ID (required)
traitId: The computed trait ID (required)
format: Response format ('json' or 'markdown')

Returns: Computed trait details.

{
  "type": "object",
  "required": [
    "spaceId",
    "traitId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    },
    "traitId": {
      "type": "string",
      "description": "Computed trait ID"
    }
  }
}

segment_create_computed_trait

Create a new computed trait.

Args:

spaceId: The space ID (required)
name: Trait name (required)
definition: Trait definition with query and type
description: Description
enabled: Whether enabled (default: true)

Returns: The created computed trait.

{
  "type": "object",
  "required": [
    "spaceId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Trait name"
    },
    "enabled": {
      "type": "boolean"
    },
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    },
    "description": {
      "type": "string"
    }
  }
}

segment_update_computed_trait

Update an existing computed trait.

Args:

spaceId: The space ID (required)
traitId: The computed trait ID (required)
name: New name
definition: New definition
description: New description
enabled: Enable or disable

Returns: The updated computed trait.

{
  "type": "object",
  "required": [
    "spaceId",
    "traitId"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "enabled": {
      "type": "boolean"
    },
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    },
    "traitId": {
      "type": "string",
      "description": "Computed trait ID"
    },
    "description": {
      "type": "string"
    }
  }
}

segment_delete_computed_trait

Delete a computed trait.

WARNING: This action is irreversible.

Args:

spaceId: The space ID (required)
traitId: The computed trait ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "spaceId",
    "traitId"
  ],
  "properties": {
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    },
    "traitId": {
      "type": "string",
      "description": "Computed trait ID"
    }
  }
}

segment_list_functions

List all functions in the workspace.

Functions are custom JavaScript code that can transform or filter data.

Args:

count: Number of functions to return (default: 20)
cursor: Pagination cursor from previous response
resourceType: Filter by type (DESTINATION, INSERT_DESTINATION, SOURCE)
format: Response format ('json' or 'markdown')

Returns: Paginated list of functions.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Number to return"
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "resourceType": {
      "enum": [
        "DESTINATION",
        "INSERT_DESTINATION",
        "SOURCE"
      ],
      "type": "string"
    }
  }
}

segment_get_function

Get details for a specific function.

Args:

functionId: The function ID (required)
format: Response format ('json' or 'markdown')

Returns: Function details including code, settings, and deployment status.

{
  "type": "object",
  "required": [
    "functionId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "functionId": {
      "type": "string",
      "description": "Function ID"
    }
  }
}

segment_create_function

Create a new function.

Args:

displayName: The function display name (required)
code: JavaScript code for the function (required)
resourceType: Type of function (DESTINATION, INSERT_DESTINATION, SOURCE)
description: Description of the function
settings: Array of setting definitions

Returns: The created function.

{
  "type": "object",
  "required": [
    "displayName",
    "code",
    "resourceType"
  ],
  "properties": {
    "code": {
      "type": "string",
      "description": "JavaScript code"
    },
    "description": {
      "type": "string",
      "description": "Description"
    },
    "displayName": {
      "type": "string",
      "description": "Function display name"
    },
    "resourceType": {
      "enum": [
        "DESTINATION",
        "INSERT_DESTINATION",
        "SOURCE"
      ],
      "type": "string",
      "description": "Function type"
    }
  }
}

segment_update_function

Update an existing function.

Args:

functionId: The function ID (required)
displayName: New display name
code: New JavaScript code
description: New description
settings: Updated setting definitions

Returns: The updated function.

{
  "type": "object",
  "required": [
    "functionId"
  ],
  "properties": {
    "code": {
      "type": "string"
    },
    "functionId": {
      "type": "string",
      "description": "Function ID"
    },
    "description": {
      "type": "string"
    },
    "displayName": {
      "type": "string"
    }
  }
}

segment_delete_function

Delete a function.

WARNING: This action is irreversible.

Args:

functionId: The function ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "functionId"
  ],
  "properties": {
    "functionId": {
      "type": "string",
      "description": "Function ID"
    }
  }
}

segment_list_reverse_etl_models

List all Reverse ETL models.

Reverse ETL models sync data from warehouses back to destinations.

Args:

count: Number of models to return (default: 20)
cursor: Pagination cursor
format: Response format ('json' or 'markdown')

Returns: Paginated list of Reverse ETL models.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

segment_get_reverse_etl_model

Get details for a specific Reverse ETL model.

Args:

modelId: The model ID (required)
format: Response format ('json' or 'markdown')

Returns: Reverse ETL model details including query and schedule.

{
  "type": "object",
  "required": [
    "modelId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "modelId": {
      "type": "string",
      "description": "Model ID"
    }
  }
}

segment_list_connected_destinations_from_source

List all destinations connected to a source.

Args:

sourceId: The source ID (required)
format: Response format ('json' or 'markdown')

Returns: List of destinations connected to the source.

{
  "type": "object",
  "required": [
    "sourceId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "sourceId": {
      "type": "string",
      "description": "Source ID"
    }
  }
}

segment_create_reverse_etl_model

Create a new Reverse ETL model.

Args:

sourceId: The warehouse source ID (required)
name: Model name (required)
query: SQL query to extract data (required)
queryIdentifierColumn: Column to use as unique identifier (required)
description: Model description
enabled: Whether enabled (default: true)
scheduleStrategy: Schedule strategy (e.g., 'PERIODIC')
scheduleConfig: Schedule configuration (e.g., { intervalMinutes: 60 })

Returns: The created Reverse ETL model.

{
  "type": "object",
  "required": [
    "sourceId",
    "name",
    "query",
    "queryIdentifierColumn"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Model name"
    },
    "query": {
      "type": "string",
      "description": "SQL query"
    },
    "enabled": {
      "type": "boolean",
      "default": true
    },
    "sourceId": {
      "type": "string",
      "description": "Warehouse source ID"
    },
    "description": {
      "type": "string"
    },
    "scheduleConfig": {
      "type": "object"
    },
    "scheduleStrategy": {
      "type": "string"
    },
    "queryIdentifierColumn": {
      "type": "string",
      "description": "Unique identifier column"
    }
  }
}

segment_update_reverse_etl_model

Update a Reverse ETL model.

Args:

modelId: The model ID (required)
name: New name
query: New SQL query
description: New description
enabled: Enable or disable
scheduleStrategy: New schedule strategy
scheduleConfig: New schedule configuration

Returns: The updated Reverse ETL model.

{
  "type": "object",
  "required": [
    "modelId"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "query": {
      "type": "string"
    },
    "enabled": {
      "type": "boolean"
    },
    "modelId": {
      "type": "string",
      "description": "Model ID"
    },
    "description": {
      "type": "string"
    },
    "scheduleConfig": {
      "type": "object"
    },
    "scheduleStrategy": {
      "type": "string"
    }
  }
}

segment_delete_reverse_etl_model

Delete a Reverse ETL model.

WARNING: This action is irreversible.

Args:

modelId: The model ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "modelId"
  ],
  "properties": {
    "modelId": {
      "type": "string",
      "description": "Model ID"
    }
  }
}

segment_trigger_reverse_etl_sync

Manually trigger a Reverse ETL sync.

Args:

modelId: The model ID (required)
subscriptionId: The subscription ID (required)

Returns: Confirmation that sync was triggered.

{
  "type": "object",
  "required": [
    "modelId",
    "subscriptionId"
  ],
  "properties": {
    "modelId": {
      "type": "string",
      "description": "Model ID"
    },
    "subscriptionId": {
      "type": "string",
      "description": "Subscription ID"
    }
  }
}

segment_list_sources

List all sources in the workspace.

Returns a paginated list of sources. Use the cursor from the response to fetch the next page.

Args:

count: Number of sources to return (default: 20)
cursor: Pagination cursor from previous response
format: Response format ('json' or 'markdown')

Returns: Paginated list of sources with their IDs, names, slugs, and enabled status.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of sources to return"
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor from previous response"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

segment_get_source

Get details for a specific source.

Args:

sourceId: The source ID (required)
format: Response format ('json' or 'markdown')

Returns: Source details including ID, name, slug, write keys, metadata, and settings.

{
  "type": "object",
  "required": [
    "sourceId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "sourceId": {
      "type": "string",
      "description": "Source ID"
    }
  }
}

segment_create_source

Create a new source in the workspace.

Args:

slug: Unique slug for the source (required)
name: Display name for the source (required)
catalogId: The source catalog ID (use segment_get_sources_catalog to find IDs)

Returns: The created source object.

{
  "type": "object",
  "required": [
    "slug",
    "name",
    "catalogId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Display name for the source"
    },
    "slug": {
      "type": "string",
      "description": "Unique slug for the source"
    },
    "catalogId": {
      "type": "string",
      "description": "Source catalog ID (e.g., catalog/sources/javascript)"
    }
  }
}

segment_update_source

Update an existing source.

Args:

sourceId: The source ID to update (required)
name: New display name
enabled: Enable or disable the source

Returns: The updated source object.

{
  "type": "object",
  "required": [
    "sourceId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New display name"
    },
    "enabled": {
      "type": "boolean",
      "description": "Enable or disable the source"
    },
    "sourceId": {
      "type": "string",
      "description": "Source ID to update"
    }
  }
}

segment_delete_source

Delete a source from the workspace.

WARNING: This action is irreversible. All data associated with the source will be deleted.

Args:

sourceId: The source ID to delete (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "sourceId"
  ],
  "properties": {
    "sourceId": {
      "type": "string",
      "description": "Source ID to delete"
    }
  }
}

segment_get_source_schema_settings

Get schema settings for a source.

Schema settings control how Segment validates tracking data.

Args:

sourceId: The source ID (required)

Returns: Schema settings including track, identify, and group settings.

{
  "type": "object",
  "required": [
    "sourceId"
  ],
  "properties": {
    "sourceId": {
      "type": "string",
      "description": "Source ID"
    }
  }
}

segment_update_source_schema_settings

Update schema settings for a source.

Args:

sourceId: The source ID (required)
settings: Schema settings object

Returns: Updated schema settings.

{
  "type": "object",
  "required": [
    "sourceId",
    "settings"
  ],
  "properties": {
    "settings": {
      "type": "object",
      "description": "Schema settings to update"
    },
    "sourceId": {
      "type": "string",
      "description": "Source ID"
    }
  }
}

segment_add_labels_to_source

Add labels to a source for organization and filtering.

Args:

sourceId: The source ID (required)
labels: Array of {key, value} label objects

Returns: The updated source object.

{
  "type": "object",
  "required": [
    "sourceId"
  ],
  "properties": {
    "sourceId": {
      "type": "string",
      "description": "Source ID"
    }
  }
}

segment_list_connected_warehouses_from_source

List all warehouses connected to a source.

Args:

sourceId: The source ID (required)
format: Response format ('json' or 'markdown')

Returns: List of warehouses connected to the source.

{
  "type": "object",
  "required": [
    "sourceId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "sourceId": {
      "type": "string",
      "description": "Source ID"
    }
  }
}

segment_create_write_key_for_source

Create a new write key for a source.

Write keys are used to authenticate tracking API requests.

Args:

sourceId: The source ID (required)

Returns: The new write key.

{
  "type": "object",
  "required": [
    "sourceId"
  ],
  "properties": {
    "sourceId": {
      "type": "string",
      "description": "Source ID"
    }
  }
}

segment_remove_write_key_from_source

Remove a write key from a source.

WARNING: This will invalidate the write key and any systems using it will stop working.

Args:

sourceId: The source ID (required)
writeKey: The write key to remove (required)

Returns: Confirmation of removal.

{
  "type": "object",
  "required": [
    "sourceId",
    "writeKey"
  ],
  "properties": {
    "sourceId": {
      "type": "string",
      "description": "Source ID"
    },
    "writeKey": {
      "type": "string",
      "description": "Write key to remove"
    }
  }
}

segment_list_tracking_plans

List all tracking plans in the workspace.

Tracking plans define the expected schema for your tracking data.

Args:

count: Number of tracking plans to return (default: 20)
cursor: Pagination cursor from previous response
format: Response format ('json' or 'markdown')

Returns: Paginated list of tracking plans.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Number to return"
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

segment_get_tracking_plan

Get details for a specific tracking plan.

Args:

trackingPlanId: The tracking plan ID (required)
format: Response format ('json' or 'markdown')

Returns: Tracking plan details including name, description, and type.

{
  "type": "object",
  "required": [
    "trackingPlanId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "trackingPlanId": {
      "type": "string",
      "description": "Tracking plan ID"
    }
  }
}

segment_create_tracking_plan

Create a new tracking plan.

Args:

name: The tracking plan name (required)
type: Type of tracking plan (default: 'LIVE')
description: Description of the tracking plan

Returns: The created tracking plan.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Tracking plan name"
    },
    "type": {
      "enum": [
        "ENGAGE",
        "LIVE",
        "PROPERTY_LIBRARY",
        "RULE_LIBRARY",
        "TEMPLATE"
      ],
      "type": "string",
      "default": "LIVE"
    },
    "description": {
      "type": "string",
      "description": "Description"
    }
  }
}

segment_update_tracking_plan

Update an existing tracking plan.

Args:

trackingPlanId: The tracking plan ID (required)
name: New name
description: New description

Returns: The updated tracking plan.

{
  "type": "object",
  "required": [
    "trackingPlanId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New name"
    },
    "description": {
      "type": "string",
      "description": "New description"
    },
    "trackingPlanId": {
      "type": "string",
      "description": "Tracking plan ID"
    }
  }
}

segment_delete_tracking_plan

Delete a tracking plan.

WARNING: This action is irreversible.

Args:

trackingPlanId: The tracking plan ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "trackingPlanId"
  ],
  "properties": {
    "trackingPlanId": {
      "type": "string",
      "description": "Tracking plan ID"
    }
  }
}

segment_list_tracking_plan_rules

List rules in a tracking plan.

Rules define the expected schema for events, traits, and properties.

Args:

trackingPlanId: The tracking plan ID (required)
format: Response format ('json' or 'markdown')

Returns: List of rules in the tracking plan.

{
  "type": "object",
  "required": [
    "trackingPlanId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "trackingPlanId": {
      "type": "string",
      "description": "Tracking plan ID"
    }
  }
}

segment_update_tracking_plan_rules

Update rules in a tracking plan.

Args:

trackingPlanId: The tracking plan ID (required)
rules: Array of rule objects with key, type, and jsonSchema

Returns: Confirmation of update.

{
  "type": "object",
  "required": [
    "trackingPlanId"
  ],
  "properties": {
    "trackingPlanId": {
      "type": "string",
      "description": "Tracking plan ID"
    }
  }
}

segment_add_source_to_tracking_plan

Connect a source to a tracking plan.

Once connected, events from the source will be validated against the tracking plan.

Args:

trackingPlanId: The tracking plan ID (required)
sourceId: The source ID to connect (required)

Returns: Confirmation of connection.

{
  "type": "object",
  "required": [
    "trackingPlanId",
    "sourceId"
  ],
  "properties": {
    "sourceId": {
      "type": "string",
      "description": "Source ID"
    },
    "trackingPlanId": {
      "type": "string",
      "description": "Tracking plan ID"
    }
  }
}

segment_remove_source_from_tracking_plan

Disconnect a source from a tracking plan.

Args:

trackingPlanId: The tracking plan ID (required)
sourceId: The source ID to disconnect (required)

Returns: Confirmation of disconnection.

{
  "type": "object",
  "required": [
    "trackingPlanId",
    "sourceId"
  ],
  "properties": {
    "sourceId": {
      "type": "string",
      "description": "Source ID"
    },
    "trackingPlanId": {
      "type": "string",
      "description": "Tracking plan ID"
    }
  }
}

segment_list_sources_from_tracking_plan

List sources connected to a tracking plan.

Args:

trackingPlanId: The tracking plan ID (required)
format: Response format ('json' or 'markdown')

Returns: List of sources connected to the tracking plan.

{
  "type": "object",
  "required": [
    "trackingPlanId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "trackingPlanId": {
      "type": "string",
      "description": "Tracking plan ID"
    }
  }
}

segment_get_transformation

Get details for a specific transformation.

Args:

transformationId: The transformation ID (required)
format: Response format ('json' or 'markdown')

Returns: Transformation details including rules and configuration.

{
  "type": "object",
  "required": [
    "transformationId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "transformationId": {
      "type": "string",
      "description": "Transformation ID"
    }
  }
}

segment_identify

Identify a user and record their traits.

The Identify call lets you tie a user to their actions and record traits about them. It includes a unique User ID and any optional traits you know about them.

Args:

userId: The unique ID for the user (required)
traits: Object of user traits (email, name, plan, etc.)
anonymousId: Anonymous ID if userId is not available
context: Additional context (ip, userAgent, etc.)

Returns: Confirmation that the identify call was sent.

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "traits": {
      "type": "object",
      "description": "User traits (email, name, plan, etc.)"
    },
    "userId": {
      "type": "string",
      "description": "Unique user identifier"
    },
    "context": {
      "type": "object",
      "description": "Additional context (ip, userAgent, etc.)"
    },
    "anonymousId": {
      "type": "string",
      "description": "Anonymous ID if userId is not available"
    }
  }
}

segment_track

Track an event that a user has performed.

The Track call records actions your users perform. Every action triggers an "event", which can have associated properties.

Args:

userId: The unique ID for the user (required)
event: The name of the event (required)
properties: Object of event properties
anonymousId: Anonymous ID if userId is not available
context: Additional context (ip, userAgent, etc.)

Returns: Confirmation that the track call was sent.

{
  "type": "object",
  "required": [
    "userId",
    "event"
  ],
  "properties": {
    "event": {
      "type": "string",
      "description": "Name of the event being tracked"
    },
    "userId": {
      "type": "string",
      "description": "Unique user identifier"
    },
    "context": {
      "type": "object",
      "description": "Additional context"
    },
    "properties": {
      "type": "object",
      "description": "Event properties"
    },
    "anonymousId": {
      "type": "string",
      "description": "Anonymous ID if userId is not available"
    }
  }
}

segment_page

Track a page view on a website.

The Page call lets you record page views on your website, along with optional information about the page being viewed.

Args:

userId: The unique ID for the user (required)
name: Name of the page
category: Category of the page
properties: Additional page properties (url, referrer, etc.)
anonymousId: Anonymous ID if userId is not available
context: Additional context

Returns: Confirmation that the page call was sent.

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the page"
    },
    "userId": {
      "type": "string",
      "description": "Unique user identifier"
    },
    "context": {
      "type": "object",
      "description": "Additional context"
    },
    "category": {
      "type": "string",
      "description": "Category of the page"
    },
    "properties": {
      "type": "object",
      "description": "Page properties (url, referrer, title, etc.)"
    },
    "anonymousId": {
      "type": "string",
      "description": "Anonymous ID if userId is not available"
    }
  }
}

segment_screen

Track a screen view in a mobile app.

The Screen call lets you record whenever a user sees a screen of your mobile app.

Args:

userId: The unique ID for the user (required)
name: Name of the screen
category: Category of the screen
properties: Additional screen properties
anonymousId: Anonymous ID if userId is not available
context: Additional context

Returns: Confirmation that the screen call was sent.

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the screen"
    },
    "userId": {
      "type": "string",
      "description": "Unique user identifier"
    },
    "context": {
      "type": "object",
      "description": "Additional context"
    },
    "category": {
      "type": "string",
      "description": "Category of the screen"
    },
    "properties": {
      "type": "object",
      "description": "Screen properties"
    },
    "anonymousId": {
      "type": "string",
      "description": "Anonymous ID if userId is not available"
    }
  }
}

segment_group

Associate a user with a group (company, organization, account, etc.).

The Group call lets you associate an identified user with a group. A group could be a company, organization, account, project, or team.

Args:

userId: The unique ID for the user (required)
groupId: The unique ID for the group (required)
traits: Group traits (name, industry, employees, etc.)
anonymousId: Anonymous ID if userId is not available
context: Additional context

Returns: Confirmation that the group call was sent.

{
  "type": "object",
  "required": [
    "userId",
    "groupId"
  ],
  "properties": {
    "traits": {
      "type": "object",
      "description": "Group traits (name, industry, employees, plan, etc.)"
    },
    "userId": {
      "type": "string",
      "description": "Unique user identifier"
    },
    "context": {
      "type": "object",
      "description": "Additional context"
    },
    "groupId": {
      "type": "string",
      "description": "Unique group identifier"
    },
    "anonymousId": {
      "type": "string",
      "description": "Anonymous ID if userId is not available"
    }
  }
}

segment_alias

Create an alias between two user identities.

The Alias call lets you merge two user identities. This is useful when a user signs up and you want to merge their anonymous browsing history with their new identity.

Args:

userId: The new user ID (required)
previousId: The previous user ID or anonymous ID (required)
context: Additional context

Returns: Confirmation that the alias call was sent.

{
  "type": "object",
  "required": [
    "userId",
    "previousId"
  ],
  "properties": {
    "userId": {
      "type": "string",
      "description": "The new user ID"
    },
    "context": {
      "type": "object",
      "description": "Additional context"
    },
    "previousId": {
      "type": "string",
      "description": "The previous user ID or anonymous ID"
    }
  }
}

segment_batch

Send a batch of tracking events.

The Batch call lets you send multiple identify, track, page, screen, group, and alias events in a single request for higher performance.

Args:

batch: Array of event objects, each with a "type" field
context: Shared context for all events
integrations: Control which integrations receive the events

Returns: Confirmation that the batch was sent.

{
  "type": "object",
  "required": [
    "batch"
  ],
  "properties": {
    "batch": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of event objects"
    },
    "context": {
      "type": "object",
      "description": "Shared context for all events"
    },
    "integrations": {
      "type": "object",
      "description": "Integration settings"
    }
  }
}

segment_list_transformations

List all transformations in the workspace.

Transformations modify events as they flow through Segment.

Args:

count: Number of transformations to return (default: 20)
cursor: Pagination cursor from previous response
format: Response format ('json' or 'markdown')

Returns: Paginated list of transformations.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

segment_create_transformation

Create a new transformation.

Args:

sourceId: The source ID (required)
name: Transformation name (required)
ifClause: FQL condition for when to apply (required)
newEventName: New event name to use
enabled: Whether enabled (default: true)
destinationMetadataId: Apply to specific destination
propertyRenames: Array of {oldName, newName} for renaming properties
fqlDefinedProperties: Array of {fql, propertyName} for computed properties

Returns: The created transformation.

{
  "type": "object",
  "required": [
    "sourceId",
    "name",
    "ifClause"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Transformation name"
    },
    "enabled": {
      "type": "boolean",
      "default": true
    },
    "ifClause": {
      "type": "string",
      "description": "FQL condition"
    },
    "sourceId": {
      "type": "string",
      "description": "Source ID"
    },
    "newEventName": {
      "type": "string",
      "description": "New event name"
    },
    "destinationMetadataId": {
      "type": "string"
    }
  }
}

segment_update_transformation

Update an existing transformation.

Args:

transformationId: The transformation ID (required)
name: New name
ifClause: New FQL condition
newEventName: New event name
enabled: Enable or disable
propertyRenames: Updated property renames
fqlDefinedProperties: Updated computed properties

Returns: The updated transformation.

{
  "type": "object",
  "required": [
    "transformationId"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "enabled": {
      "type": "boolean"
    },
    "ifClause": {
      "type": "string"
    },
    "newEventName": {
      "type": "string"
    },
    "transformationId": {
      "type": "string",
      "description": "Transformation ID"
    }
  }
}

segment_delete_transformation

Delete a transformation.

WARNING: This action is irreversible.

Args:

transformationId: The transformation ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "transformationId"
  ],
  "properties": {
    "transformationId": {
      "type": "string",
      "description": "Transformation ID"
    }
  }
}

segment_list_warehouses

List all warehouses in the workspace.

Returns a paginated list of data warehouses (Snowflake, BigQuery, Redshift, etc.).

Args:

count: Number of warehouses to return (default: 20)
cursor: Pagination cursor from previous response
format: Response format ('json' or 'markdown')

Returns: Paginated list of warehouses with their IDs, names, types, and enabled status.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of warehouses to return"
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

segment_get_warehouse

Get details for a specific warehouse.

Args:

warehouseId: The warehouse ID (required)
format: Response format ('json' or 'markdown')

Returns: Warehouse details including settings, metadata, and connection info.

{
  "type": "object",
  "required": [
    "warehouseId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "warehouseId": {
      "type": "string",
      "description": "Warehouse ID"
    }
  }
}

segment_create_warehouse

Create a new warehouse.

Args:

metadataId: The warehouse catalog ID (use segment_get_warehouses_catalog)
settings: Warehouse-specific settings (credentials, database, schema, etc.)
name: Display name for the warehouse
enabled: Whether the warehouse is enabled (default: true)

Returns: The created warehouse object.

{
  "type": "object",
  "required": [
    "metadataId",
    "settings"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Display name"
    },
    "enabled": {
      "type": "boolean",
      "default": true,
      "description": "Whether enabled"
    },
    "settings": {
      "type": "object",
      "description": "Warehouse-specific settings"
    },
    "metadataId": {
      "type": "string",
      "description": "Warehouse catalog ID"
    }
  }
}

segment_update_warehouse

Update an existing warehouse.

Args:

warehouseId: The warehouse ID to update (required)
name: New display name
enabled: Enable or disable the warehouse
settings: Updated warehouse-specific settings

Returns: The updated warehouse object.

{
  "type": "object",
  "required": [
    "warehouseId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New display name"
    },
    "enabled": {
      "type": "boolean",
      "description": "Enable or disable"
    },
    "settings": {
      "type": "object",
      "description": "Updated settings"
    },
    "warehouseId": {
      "type": "string",
      "description": "Warehouse ID to update"
    }
  }
}

segment_delete_warehouse

Delete a warehouse.

WARNING: This action is irreversible.

Args:

warehouseId: The warehouse ID to delete (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "warehouseId"
  ],
  "properties": {
    "warehouseId": {
      "type": "string",
      "description": "Warehouse ID to delete"
    }
  }
}

segment_add_source_connection_to_warehouse

Connect a source to a warehouse.

This enables data from the source to be synced to the warehouse.

Args:

warehouseId: The warehouse ID (required)
sourceId: The source ID to connect (required)

Returns: Confirmation of connection.

{
  "type": "object",
  "required": [
    "warehouseId",
    "sourceId"
  ],
  "properties": {
    "sourceId": {
      "type": "string",
      "description": "Source ID to connect"
    },
    "warehouseId": {
      "type": "string",
      "description": "Warehouse ID"
    }
  }
}

segment_remove_source_connection_from_warehouse

Disconnect a source from a warehouse.

Args:

warehouseId: The warehouse ID (required)
sourceId: The source ID to disconnect (required)

Returns: Confirmation of disconnection.

{
  "type": "object",
  "required": [
    "warehouseId",
    "sourceId"
  ],
  "properties": {
    "sourceId": {
      "type": "string",
      "description": "Source ID to disconnect"
    },
    "warehouseId": {
      "type": "string",
      "description": "Warehouse ID"
    }
  }
}

segment_list_connected_sources_from_warehouse

List all sources connected to a warehouse.

Args:

warehouseId: The warehouse ID (required)
format: Response format ('json' or 'markdown')

Returns: List of sources connected to the warehouse.

{
  "type": "object",
  "required": [
    "warehouseId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "warehouseId": {
      "type": "string",
      "description": "Warehouse ID"
    }
  }
}