amazon-datazone-mcp-server
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AWS_ACCESS_KEY_ID | No | AWS access key ID for authentication. | |
| AWS_DEFAULT_REGION | No | AWS default region (e.g., us-east-1). | |
| AWS_SECRET_ACCESS_KEY | No | AWS secret access key for authentication. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_domainB | Calls the Amazon DataZone GetDomain API for a given domain identifier. Args: identifier (str): The domain identifier (e.g., "dzd_4p9n6sw4qt9xgn") Returns: Any: The API response containing domain details or None if an error occurs |
| create_domainB | Creates a new Amazon DataZone domain. Args: name (str): The name of the domain domain_execution_role (str): The ARN of the domain execution role service_role (str): The ARN of the service role domain_version (str, optional): The version of the domain (V1 or V2) (default: "V2") description (str, optional): Description of the domain kms_key_identifier (str, optional): ARN of the KMS key for encryption tags (Dict[str, str], optional): Tags to associate with the domain single_sign_on (Dict[str, str], optional): Single sign-on configuration Returns: Dict containing: - id: Domain identifier - arn: Domain ARN - name: Domain name - description: Domain description - domain_version: Domain version - status: Domain status - portal_url: Data portal URL - root_domain_unit_id: Root domain unit ID |
| list_domain_unitsB | Lists child domain units for the specified parent domain unit in an Amazon DataZone domain. Args: domain_identifier (str): The identifier of the domain (e.g., "dzd_4p9n6sw4qt9xgn") parent_domain_unit_identifier (str): The identifier of the parent domain unit (e.g., "3thjq258ficc2v") Returns: Any: The API response containing the list of domain units |
| list_domainsA | Lists Amazon DataZone domains. Args: max_results (int, optional): Maximum number of results to return (default: 25, max: 25) next_token (str, optional): Token for pagination to get next page of results status (str, optional): Filter domains by status (e.g., "AVAILABLE", "CREATING", "DELETING") Returns: Dict containing: - items: List of domains with details including ID, name, status, ARN, etc. - next_token: Token for next page of results (if available) |
| create_domain_unitA | Creates a new domain unit in Amazon DataZone. Args: domain_identifier (str): The ID of the domain where the domain unit will be created Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ name (str): The name of the domain unit (1-128 characters) Pattern: ^[\w -]+$ parent_domain_unit_identifier (str): The ID of the parent domain unit Pattern: ^[a-z0-9_-]+$ description (str, optional): Description of the domain unit (0-2048 characters) client_token (str, optional): A unique token to ensure idempotency (1-128 characters) Pattern: ^[\x21-\x7E]+$ Returns: Dict containing: - id: Domain unit identifier - name: Domain unit name - description: Domain unit description - domain_id: Domain ID - parent_domain_unit_id: Parent domain unit ID - ancestor_domain_unit_ids: List of ancestor domain unit IDs - created_at: Creation timestamp - created_by: Creator information - owners: List of domain unit owners |
| get_domain_unitA | Retrieves detailed information about a specific domain unit in Amazon DataZone. Args: domain_identifier (str): The ID of the domain where the domain unit exists Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ identifier (str): The ID of the domain unit to retrieve Pattern: ^[a-z0-9_-]+$ Returns: Dict containing: - id: Domain unit identifier - name: Domain unit name - description: Domain unit description - domain_id: Domain ID - parent_domain_unit_id: Parent domain unit ID - created_at: Creation timestamp - created_by: Creator information - owners: List of domain unit owners - lastUpdatedAt: The timestamp at which the domain unit was last updated - lastUpdatedBy: The user who last updated the domain unit |
| add_entity_ownerA | Adds an owner to an entity (domain unit or project) in Amazon DataZone. Args: domain_identifier (str): The ID of the domain entity_identifier (str): The ID or name of the entity (domain unit or project) to add the owner to owner_identifier (str): The identifier of the owner to add (can be IAM ARN for users) entity_type (str, optional): The type of entity (DOMAIN_UNIT or PROJECT, default: DOMAIN_UNIT) owner_type (str, optional): The type of owner (default: "USER") client_token (str, optional): A unique token to ensure idempotency Returns: Any: The API response |
| add_policy_grantC | Adds a policy grant to a specified entity in Amazon DataZone. Args: domain_identifier (str): The ID of the domain entity_identifier (str): The ID of the entity to add the policy grant to entity_type (str): The type of entity (DOMAIN_UNIT, ENVIRONMENT_BLUEPRINT_CONFIGURATION, or ENVIRONMENT_PROFILE) policy_type (str): The type of policy to grant (e.g., CREATE_DOMAIN_UNIT, OVERRIDE_DOMAIN_UNIT_OWNERS, etc.) principal_identifier (str): The identifier of the principal to grant permissions to principal_type (str, optional): The type of principal (default: "USER") client_token (str, optional): A unique token to ensure idempotency detail (dict, optional): Additional details for the policy grant Returns: Any: The API response |
| searchA | Searches for assets in Amazon DataZone. Args: domain_identifier (str): The identifier of the Amazon DataZone domain Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ search_scope (str): The scope of the search Valid Values: ASSET | GLOSSARY | GLOSSARY_TERM | DATA_PRODUCT additional_attributes (List[str], optional): Specifies additional attributes for the search Valid Values: FORMS | TIME_SERIES_DATA_POINT_FORMS filters (Dict[str, Any], optional): Specifies the search filters Type: FilterClause object (Union type) max_results (int, optional): Maximum number of results to return (1-50, default: 50) next_token (str, optional): Token for pagination (1-8192 characters) owning_project_identifier (str, optional): The identifier of the owning project. This is required when the user is requesting a search_scope of ASSET or DATA_PRODUCT. Pattern: ^[a-zA-Z0-9_-]{1,36}$ search_in (List[Dict[str, str]], optional): The details of the search Array Members: 1-10 items Each item contains: - attribute (str): The attribute to search in search_text (str, optional): The text to search for (1-4096 characters) sort (Dict[str, str], optional): Specifies how to sort the results Contains: - attribute (str): The attribute to sort by - order (str): The sort order (ASCENDING | DESCENDING) Returns: Any: The API response containing: - items (list): The search results - nextToken (str): Token for pagination if more results are available - totalMatchCount (int): Total number of search results Example:
|
| search_typesA | Invokes the SearchTypes action in a specified Amazon DataZone domain to retrieve type definitions (e.g., asset types, form types, or lineage node types) that match the search criteria. Args: domain_identifier (str): The identifier of the Amazon DataZone domain in which to invoke the SearchTypes action. Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ (Required) Returns: dict: A response object containing: - items (List[dict]): A list of SearchTypesResultItem objects matching the query. - nextToken (str): A pagination token for retrieving the next set of results. - totalMatchCount (int): Total number of matching items. |
| get_user_profileB | Retrieves the user profile in a specified Amazon DataZone domain for a given user. Args: domain_identifier (str): The ID of the Amazon DataZone domain from which to retrieve the user profile. Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ Required: Yes Returns: dict: A response object containing: - details (dict): A UserProfileDetails object with specific IAM or SSO profile data. - domainId (str): The identifier of the DataZone domain. - id (str): The identifier of the user profile. - status (str): The status of the user profile. Valid values: "ASSIGNED", "NOT_ASSIGNED", "ACTIVATED", "DEACTIVATED". - type (str): The type of the user profile. Valid values: "IAM", "SSO". |
| search_user_profilesA | Searches for user profiles within a specified Amazon DataZone domain. This API supports filtering results by user type and search text, as well as pagination through Args: domain_identifier (str): The identifier of the Amazon DataZone domain in which to perform the search. Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ Required: Yes Returns: dict: A response object containing: - items (List[dict]): A list of user profile summaries. Each summary includes: - details (dict): UserProfileDetails (union type) - domainId (str): Domain ID the user profile belongs to. - id (str): The identifier of the user profile. - status (str): Profile status. Possible values: "ASSIGNED", "NOT_ASSIGNED", "ACTIVATED", "DEACTIVATED". - type (str): Type of the user profile. Possible values: "IAM", "SSO". - nextToken (str, optional): Token for paginated responses. Min length: 1, Max length: 8192 |
| search_group_profilesA | Searches for group profiles within a specified Amazon DataZone domain. This operation allows you to find groups by specifying a group type and optional search text. Pagination is supported through Args: domain_identifier (str): The identifier of the Amazon DataZone domain in which to search group profiles. Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ Required: Yes Returns: dict: A response object containing: - items (List[dict]): A list of group profile summaries. Each summary includes: - domainId (str): The domain to which the group belongs. - groupName (str): The name of the group. - id (str): The unique identifier of the group profile. - status (str): The current status of the group profile. - nextToken (str, optional): A token to retrieve the next page of results, if more are available. Length: 1–8192 characters Raises: HTTPError: If the API request fails or returns an error. |
| get_assetA | Retrieves detailed information about one specific asset (specified by user) in Amazon DataZone. Use this API when you want to inspect or manage a particular known asset dataset, or table and want to retrieve its:
Data asset is a specific dataset or table, while data source is a location where your data resides. related tools:
Args: domain_identifier (str): The ID of the domain containing the asset asset_identifier (str): The ID of the asset to retrieve revision (str, optional): The specific revision of the asset to retrieve Returns: Any: The API response containing asset details including: - Basic info (name, description, ID) - Creation timestamps (createdAt, firstRevisionCreatedAt) - Domain and project IDs - Asset type and revision info - Forms and metadata - Glossary terms - Listing status - Time series data points |
| create_assetA | Creates an asset in the Amazon DataZone catalog. Args: domain_identifier (str): The ID of the domain where the asset is created name (str): The name of the asset (1-256 characters) type_identifier (str): The ID of the asset type (1-513 characters) owning_project_identifier (str): The ID of the project that owns this asset description (str, optional): Description of the asset (0-2048 characters) external_identifier (str, optional): External ID of the asset (1-600 characters) forms_input (List[Dict[str, str]], optional): Metadata forms for the asset Example: [{ "content": "form-content", "formName": "form-name", "typeIdentifier": "type-id", "typeRevision": "type-rev" }] glossary_terms (List[str], optional): Glossary terms to attach to the asset Example: ["term1", "term2"] prediction_configuration (Dict[str, Dict[str, bool]], optional): Configuration for business name generation Example: {"businessNameGeneration": {"enabled": True}} type_revision (str, optional): The revision of the asset type client_token (str, optional): Token for idempotency Returns: Any: The API response containing: - Asset ID and revision - Creation timestamps - Domain and project IDs - Forms and metadata - Glossary terms - Listing status - Time series data points |
| publish_assetA | Publishes an asset to the Amazon DataZone catalog. Args: domain_identifier (str): The ID of the domain containing the asset asset_identifier (str): The ID of the asset to publish Returns: Any: The API response containing: - Published asset ID and revision - Listing status - Creation and update timestamps - Domain and project IDs - Forms and metadata - Glossary terms |
| get_listingA | Gets a listing (a record of an asset at a given time) in Amazon DataZone. If a listing version is specified, only details specific to that version are returned. Args: domain_identifier (str): The ID of the Amazon DataZone domain Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ identifier (str): The ID of the listing Pattern: ^[a-zA-Z0-9_-]{1,36}$ listing_revision (str, optional): The revision of the listing Length: 1-64 characters Returns: Any: The API response containing: - Listing ID and revision - Creation and update timestamps - Domain ID - Listing name and description - Listing status (CREATING | ACTIVE | INACTIVE) - Listing item details - Creator and updater information |
| search_listingsA | Search published data asset listings in Amazon DataZone using keyword, filter, and sort options. Use it to search only within published data asset listings. related tools:
Args: domain_identifier (str): The ID of the domain to search in search_text (str, optional): Text to search for max_results (int, optional): Maximum number of results to return (1-50, default: 50) next_token (str, optional): Token for pagination additional_attributes (List[str], optional): Additional attributes to include in search Valid values: ["FORMS", "TIME_SERIES_DATA_POINT_FORMS"] search_in (List[Dict[str, str]], optional): Attributes to search in Example: [{"attribute": "name"}, {"attribute": "description"}] sort (Dict[str, str], optional): Sorting criteria Example: {"attribute": "name", "order": "ASCENDING"} Returns: Any: The API response containing search results |
| create_data_sourceA | Creates a data source in Amazon DataZone and associates it with a project. Args: domain_identifier (str): The ID of the domain where the data source is created project_identifier (str): The ID of the project to associate the data source with name (str): The name of the data source (1-256 characters) data_src_type (str): The type of data source (e.g., "S3", "GLUE", "REDSHIFT") description (str, optional): Description of the data source (0-2048 characters) enable_setting (str, optional): Whether the data source is enabled (ENABLED/DISABLED) environment_identifier (str, optional): ID of the environment to publish assets to connection_identifier (str, optional): ID of the connection to use configuration (Dict[str, Any], optional): Data source configuration Example for S3: { "s3Configuration": { "bucketName": "my-bucket", "prefix": "data/" } } asset_forms_input (List[Dict[str, str]], optional): Metadata forms for assets Example: [{ "content": "form-content", "formName": "form-name", "typeIdentifier": "type-id", "typeRevision": "type-rev" }] publish_on_import (bool, optional): Whether to automatically publish imported assets recommendation (Dict[str, bool], optional): Recommendation settings Example: {"enableBusinessNameGeneration": True} schedule (Dict[str, str], optional): Schedule configuration Example: { "schedule": "cron(0 12 * * ? *)", "timezone": "UTC" } client_token (str, optional): Token for idempotency Returns: Any: The API response containing: - Data source ID and status - Creation and update timestamps - Domain and project IDs - Configuration details - Last run information - Error messages (if any) |
| get_data_sourceA | Retrieves detailed information about a specific, known data source in Amazon DataZone. Use this API when the user mentions a specific data source by name, type, or context (e.g., "Redshift data source in analytics domain") and wants details like:
Data source is a location that defines where your data resides, while data asset is a specific dataset or table. Connections are credentials + config for accessing a system, while data source is a specific location where your data resides using a connection. related tools:
Args: domain_identifier (str): The ID of the domain where the data source exists identifier (str): The ID of the data source to retrieve Returns: Any: The API response containing data source details |
| start_data_source_runA | Starts a data source run in Amazon DataZone. Args: domain_identifier (str): The identifier of the Amazon DataZone domain in which to start a data source run Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ data_source_identifier (str): The identifier of the data source Pattern: ^[a-zA-Z0-9_-]{1,36}$ client_token (str, optional): A unique, case-sensitive identifier that is provided to ensure the idempotency of the request Length: 1-128 characters Returns: Any: The API response containing: - createdAt: Timestamp when the data source run was created - dataSourceConfigurationSnapshot: Configuration snapshot of the data source - dataSourceId: Identifier of the data source - domainId: Identifier of the domain - errorMessage: Error details if the operation failed - id: Identifier of the data source run - projectId: Identifier of the project - runStatisticsForAssets: Statistics about the run including: - added: Number of assets added - failed: Number of assets that failed - skipped: Number of assets skipped - unchanged: Number of assets unchanged - updated: Number of assets updated - startedAt: Timestamp when the run started - status: Status of the run (REQUESTED, RUNNING, FAILED, PARTIALLY_SUCCEEDED, SUCCESS) - stoppedAt: Timestamp when the run stopped - type: Type of the run (PRIORITIZED, SCHEDULED) - updatedAt: Timestamp when the run was last updated Example:
|
| create_subscription_requestA | Creates a subscription request in Amazon DataZone. Args: domain_identifier (str): The ID of the domain where the subscription request is created request_reason (str): The reason for the subscription request (1-4096 characters) subscribed_listings (List[Dict[str, str]]): The published assets to subscribe to Example: [{"identifier": "listing-id"}] subscribed_principals (List[Dict[str, Any]]): The principals to subscribe using tagged union format Example for project: [{"project": {"identifier": "project-id"}}] Example for user: [{"user": {"userId": "user-id"}}] metadata_forms (List[Dict[str, str]], optional): Additional metadata forms Example: [{ "content": "form-content", "formName": "form-name", "typeIdentifier": "type-id", "typeRevision": "type-rev" }] client_token (str, optional): A unique token to ensure idempotency Returns: Any: The API response containing: - Subscription request ID and status - Creation and update timestamps - Domain ID - Request reason and decision comment - Subscribed listings and principals - Metadata forms - Reviewer information |
| accept_subscription_requestA | Accepts a subscription request to a specific asset in Amazon DataZone. Args: domain_identifier (str): The ID of the domain where the subscription request exists identifier (str): The unique identifier of the subscription request to accept asset_scopes (List[Dict[str, Any]], optional): The asset scopes of the accept subscription request Example: [{"assetId": "asset-id", "filterIds": ["filter-id"]}] decision_comment (str, optional): A description that specifies the reason for accepting the request Length: 1-4096 characters Returns: Any: The API response containing: - Subscription request ID and status - Creation and update timestamps - Domain ID - Decision comment - Subscribed listings and principals - Metadata forms - Reviewer information |
| get_subscriptionA | Gets a subscription in Amazon DataZone. Args: domain_identifier (str): The ID of the Amazon DataZone domain in which the subscription exists Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ identifier (str): The ID of the subscription Pattern: ^[a-zA-Z0-9_-]{1,36}$ Returns: Any: The API response containing: - Subscription ID and status (APPROVED | REVOKED | CANCELLED) - Creation and update timestamps - Domain ID - Retain permissions flag - Subscribed listing details - Subscribed principal information - Subscription request ID - Creator and updater information |
| get_form_typeA | Retrieves detailed information about a specific metadata form type in Amazon DataZone. Args: domain_identifier (str): The ID of the domain where the form type exists Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ form_type_identifier (str): The ID of the form type to retrieve Length: 1-385 characters revision (str, optional): The revision of the form type to retrieve Length: 1-64 characters Returns: Any: The API response containing form type details including: - createdAt (number): Timestamp of when the form type was created - createdBy (str): The user who created the form type - description (str): The description of the form type (0-2048 characters) - domainId (str): The ID of the domain - imports (list): The imports of the form type (1-10 items) Each import contains: - name (str): The name of the import - revision (str): The revision of the import - model (dict): The model of the form type (Union type) - name (str): The name of the form type (1-128 characters) - originDomainId (str): The ID of the domain where the form type was originally created - originProjectId (str): The ID of the project where the form type was originally created - owningProjectId (str): The ID of the project that owns the form type - revision (str): The revision of the form type (1-64 characters) - status (str): The status of the form type (ENABLED or DISABLED) Example:
|
| create_form_typeA | Creates a new metadata form type in Amazon DataZone. Args: domain_identifier (str): The ID of the domain where the form type will be created Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ name (str): The name of the form type (1-128 characters) model (Dict[str, Any]): The model of the form type Note: This is a Union type object where only one member can be specified owning_project_identifier (str): The ID of the project that owns the form type Pattern: ^[a-zA-Z0-9_-]{1,36}$ description (str, optional): The description of the form type (0-2048 characters) status (str, optional): The status of the form type (ENABLED or DISABLED, default: ENABLED) Returns: Any: The API response containing: - description (str): The description of the form type - domainId (str): The ID of the domain - name (str): The name of the form type - originDomainId (str): The ID of the domain where the form type was originally created - originProjectId (str): The ID of the project where the form type was originally created - owningProjectId (str): The ID of the project that owns the form type - revision (str): The revision of the form type (1-64 characters) Example:
|
| list_data_sourcesA | Retrieve a list of data sources in Datazone domain Use this API when the user is browsing, searching, or filtering data sources — especially if they don't know the exact ID or want to find a list to choose from.
This is not the correct API if the user asks for config details of a known data source — use related tools: get_data_source: Retrieves detailed information about a known data source. Use get_data_source when you want to fetch info about the connection details, authentication settings, or ingestion configuration of a particular data source. Args: domainIdentifier (str): The identifier of the Amazon DataZone domain in which to list the data sources. Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ Required: Yes projectIdentifier (str): The identifier of the project in which to list data sources. Required: Yes connectionIdentifier (str, optional): The ID of the connection used to filter the data sources. environmentIdentifier (str, optional): The identifier of the environment in which to list the data sources. maxResults (int, optional): The maximum number of data sources to return in one response. Valid Range: 1–50 name (str, optional): Filter by name of the data source. Length Constraints: 1–256 characters nextToken (str, optional): A pagination token for fetching the next set of results. Length Constraints: 1–8192 characters status (str, optional): Filter data sources by their current status. Valid values: - CREATING - FAILED_CREATION - READY - UPDATING - FAILED_UPDATE - RUNNING - DELETING - FAILED_DELETION type (str, optional): Filter by the type of data source (e.g., GLUE, REDSHIFT). Length Constraints: 1–256 characters Returns: dict: A dictionary with the following keys: - items (List[dict]): A list of DataSourceSummary objects containing: - connectionId (str) - createdAt (str) - dataSourceId (str) - description (str) - domainId (str) - enableSetting (str) - environmentId (str) - lastRunAssetCount (int) - lastRunAt (str) - lastRunErrorMessage (dict): Contains "errorDetail" and "errorType" - lastRunStatus (str) - name (str) - schedule (dict): Contains "schedule" and "timezone" - status (str) - type (str) - updatedAt (str) |
| create_projectB | Creates a new project in an Amazon DataZone domain. Args: domain_identifier (str): The ID of the domain where the project will be created name (str): The name of the project (required) description (str, optional): The description of the project domain_unit_id (str, optional): The ID of the domain unit where the project will be created glossary_terms (List[str], optional): List of glossary terms that can be used in the project project_profile_id (str, optional): The ID of the project profile user_parameters (List[Dict[str, Any]], optional): The user parameters of the project Returns: Any: The API response containing the created project details |
| get_projectA | Retrieves detailed information, metadata and configuration, of a specific project in Amazon DataZone. Use this API when the user is asking about a known project by name or context and wants to:
Returns: Any: The API response containing project details including: - Basic info (name, description, ID) - Timestamps (createdAt, lastUpdatedAt) - Domain IDs (domainId, domainUnitId) - Project status and profile - Environment deployment details - User parameters - Glossary terms - Failure reasons (if any) |
| list_projectsA | Lists projects in an Amazon DataZone domain with optional filtering and pagination. Args: domain_identifier (str): The identifier of the domain max_results (int, optional): Maximum number of projects to return (1-50, default: 50) next_token (str, optional): Token for pagination name (str, optional): Filter projects by name user_identifier (str, optional): Filter projects by user group_identifier (str, optional): Filter projects by group Returns: Any: The API response containing the list of projects |
| create_project_membershipC | Make a request to the Amazon DataZone CreateProjectMembership API. Args: domainIdentifier (str): The identifier of the domain. projectIdentifier (str): The identifier of the project. designation (str): The designation of the member. memberIdentifier (str): The identifier of the member. |
| list_project_profilesA | Lists all project profiles available in an Amazon DataZone domain. Args: domain_identifier (str): The ID of the domain max_results (int, optional): Maximum number of profiles to return (1-50, default: 50) next_token (str, optional): Token for pagination Returns: Any: The API response containing the list of project profiles |
| create_project_profileB | Creates a new project profile in Amazon DataZone. Args: domain_identifier (str): The ID of the domain where the project profile will be created Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ name (str): The name of the project profile (1-64 characters) Pattern: ^[\w -]+$ description (str, optional): Description of the project profile (0-2048 characters) domain_unit_identifier (str, optional): The ID of the domain unit where the project profile will be created Pattern: ^[a-z0-9_-]+$ environment_configurations (List[Dict[str, Any]], optional): Environment configurations for the project profile Each configuration should include: - awsAccount: AWS account details - awsRegion: AWS region details - configurationParameters: Configuration parameters - deploymentMode: Deployment mode - deploymentOrder: Deployment order - description: Environment description - environmentBlueprintId: Environment blueprint ID - id: Environment ID - name: Environment name status (str, optional): The status of the project profile (ENABLED or DISABLED, default: ENABLED) Returns: Dict containing: - id: Project profile identifier - name: Project profile name - description: Project profile description - domain_id: Domain ID - domain_unit_id: Domain unit ID - environment_configurations: Environment configurations - status: Project profile status - created_at: Creation timestamp - created_by: Creator information - last_updated_at: Last update timestamp |
| get_project_profileA | Get the details of the project profile in an Amazon DataZone domain. Args: domain_identifier (str): The ID of the domain Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ identifier (str): The ID of the project profile (1-50, default: 50) Pattern: ^[a-zA-Z0-9_-]{1,36}$ Returns: dict: A dictionary with the following fields: createdAt (str): The timestamp when the project profile was created. createdBy (str): The user who created the project profile. description (str): Description of the project profile. (0–2048 characters) domainId (str): The identifier of the domain the project profile belongs to. Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ domainUnitId (str): The identifier of the domain unit within the domain. Pattern: r"^[a-z0-9_-]+$", length 1–256 environmentConfigurations (List[dict]): A list of environment configurations. Each item includes: - awsAccount (dict): AWS account details. - awsRegion (dict): AWS region. - configurationParameters (dict): Parameters for deployment. - parameterOverrides (List[dict]): Overridden parameters with: - isEditable (bool): Whether the parameter can be edited. - name (str): Parameter name. - value (str): Parameter value. - resolvedParameters (List[dict]): Final resolved parameters, same structure as above. - ssmPath (str): SSM path for configuration parameters. - deploymentMode (str): Mode of deployment. - deploymentOrder (int): Order in which to deploy this environment. - description (str): Description of the environment configuration. - environmentBlueprintId (str): Identifier of the environment blueprint. - id (str): Unique ID of the environment configuration. - name (str): Name of the environment configuration. id (str): Unique identifier for the project profile. Pattern: ^[a-zA-Z0-9_-]{1,36}$ lastUpdatedAt (str): The timestamp when the project profile was last updated. name (str): The name of the project profile (1–64 characters). Pattern: ^[\w -]+$ status (str): Status of the project profile. Valid values: "ENABLED" | "DISABLED" |
| list_project_membershipsA | Lists the memberships of a specified Amazon DataZone project within a domain. Args: domain_identifier (str): The identifier of the Amazon DataZone domain. Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ Required: Yes Returns: dict: A dictionary containing: - members (List[dict]): A list of project members, where each member includes: - designation (str): The role or designation of the member within the project. - memberDetails (dict): Additional details about the member (structure depends on implementation). |
| list_environmentsA | Lists environments in Amazon DataZone. Args: domain_identifier (str): The identifier of the Amazon DataZone domain. project_identifier (str): The identifier of the Amazon DataZone project. max_results (int, optional): Maximum number of environments to return. Defaults to 50. next_token (str, optional): Token for pagination. Defaults to None. aws_account_id (str, optional): The identifier of the AWS account where you want to list environments. aws_account_region (str, optional): The AWS region where you want to list environments. environment_blueprint_identifier (str, optional): The identifier of the Amazon DataZone blueprint. environment_profile_identifier (str, optional): The identifier of the environment profile. name (str, optional): The name of the environment. provider (str, optional): The provider of the environment. status (str, optional): The status of the environments to list. Valid values: ACTIVE, CREATING, UPDATING, DELETING, CREATE_FAILED, UPDATE_FAILED, DELETE_FAILED, VALIDATION_FAILED, SUSPENDED, DISABLED, EXPIRED, DELETED, INACCESSIBLE Returns: Any: The API response containing environment details or None if an error occurs Example: >>> list_environments( ... domain_identifier="dzd_4p9n6sw4qt9xgn", ... project_identifier="prj_123456789", ... status="ACTIVE", ... ) |
| create_connectionA | Creates a new connection in Amazon DataZone. A connection enables you to connect your resources. (domains, projects, and environments) to external resources and services. This is specifically for creating DataZone connections and should be used in the DataZone MCP server. Args: domain_identifier (str): The ID of the domain where the connection is created. Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ name (str): The connection name. Length Constraints: Minimum length of 0. Maximum length of 64. environment_identifier (str, optional): The ID of the environment where the connection is created. Pattern: ^[a-zA-Z0-9_-]{1,36}$ aws_location (Dict[str, str], optional): The location where the connection is created. Contains: - accessRole (str): The access role for the connection - awsAccountId (str): The AWS account ID - awsRegion (str): The AWS region - iamConnectionId (str): The IAM connection ID description (str, optional): A connection description. Length Constraints: Minimum length of 0. Maximum length of 128. client_token (str, optional): A unique, case-sensitive identifier to ensure idempotency. props (Dict[str, Any], optional): The connection properties. Type: ConnectionPropertiesInput object (Union type) Returns: Any: The API response containing: - connectionId (str): The ID of the created connection - description (str): The connection description - domainId (str): The domain ID - domainUnitId (str): The domain unit ID - environmentId (str): The environment ID - name (str): The connection name - physicalEndpoints (list): The physical endpoints of the connection - projectId (str): The project ID - props (dict): The connection properties - type (str): The connection type Example: >>> create_connection( ... domain_identifier="dzd_4p9n6sw4qt9xgn", ... name="MyConnection", ... environment_identifier="env_123456789", ... aws_location={ ... "accessRole": "arn:aws:iam::123456789012:role/DataZoneAccessRole", ... "awsAccountId": "123456789012", ... "awsRegion": "us-east-1", ... "iamConnectionId": "iam-123456789", ... }, ... description="Connection to external service", ... ) |
| get_connectionA | Gets a connection in Amazon DataZone. A connection enables you to connect your resources (domains, projects, and environments) to external resources and services. Connections are credentials + config for accessing a system, while data source is a specific location where your data resides using a connection. related tools:
Args: domain_identifier (str): The ID of the domain where the connection exists. Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ identifier (str): The ID of the connection to retrieve. Length Constraints: Minimum length of 0. Maximum length of 128. with_secret (bool, optional): Specifies whether to include connection secrets. Defaults to False. Returns: Any: The API response containing: - connectionId (str): The ID of the connection - description (str): The connection description - domainId (str): The domain ID - domainUnitId (str): The domain unit ID - environmentId (str): The environment ID - environmentUserRole (str): The environment user role - name (str): The connection name - physicalEndpoints (list): The physical endpoints of the connection - projectId (str): The project ID - props (dict): The connection properties - type (str): The connection type - connectionCredentials (dict, optional): If with_secret is True, includes: - accessKeyId (str) - expiration (str) - secretAccessKey (str) - sessionToken (str) Example: >>> get_connection( ... domain_identifier="dzd_4p9n6sw4qt9xgn", ... identifier="conn_123456789", ... with_secret=True, ... ) |
| get_environmentA | Gets an Amazon DataZone environment. Args: domain_identifier (str): The ID of the domain where the environment exists. Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ identifier (str): The ID of the environment to retrieve. Length Constraints: Minimum length of 0. Maximum length of 128. Returns: Any: The API response containing: - awsAccountId (str): The AWS account ID associated with the environment. - awsAccountRegion (str): The AWS region where the environment is located. - createdAt (str): Timestamp when the environment was created. - createdBy (str): The identifier of the user who created the environment. - deploymentProperties (dict): Properties related to deployment, including: - endTimeoutMinutes (int): Timeout in minutes for ending the deployment. - startTimeoutMinutes (int): Timeout in minutes for starting the deployment. - description (str): Description of the environment. - domainId (str): The domain ID associated with the environment. - environmentActions (list): A list of actions for the environment, each containing: - auth (str): Authorization type for the action. - parameters (list): Parameters for the action, each including: - key (str): Parameter key. - value (str): Parameter value. - type (str): The type of environment action. - environmentBlueprintId (str): ID of the blueprint used for the environment. - environmentConfigurationId (str): ID of the environment configuration. - environmentProfileId (str): ID of the environment profile. - glossaryTerms (list): List of glossary term strings associated with the environment. - id (str): The unique ID of the environment. - lastDeployment (dict): Information about the last deployment, including: - deploymentId (str): ID of the last deployment. - deploymentStatus (str): Status of the deployment. - deploymentType (str): Type of deployment. - failureReason (dict): Details of any failure, including: - code (str): Error code for the failure. - message (str): Human-readable error message. - isDeploymentComplete (bool): Whether the deployment is complete. - messages (list): List of messages related to the deployment. - name (str): Name of the environment. - projectId (str): The project ID associated with the environment. - provider (str): Provider responsible for provisioning the environment. - provisionedResources (list): List of provisioned resources, each including: - name (str): Name of the resource. - provider (str): Resource provider. - type (str): Type of the resource. - value (str): Value associated with the resource. - provisioningProperties (dict): Additional properties used during provisioning. - status (str): Current status of the environment. - updatedAt (str): Timestamp when the environment was last updated. - userParameters (list): Parameters provided by the user, each including: - defaultValue (str): Default value of the parameter. - description (str): Description of the parameter. - fieldType (str): Type of input field. - isEditable (bool): Whether the parameter is editable. - isOptional (bool): Whether the parameter is optional. - keyName (str): Key name for the parameter. Example: >>> get_environment( ... domain_identifier="dzd_4p9n6sw4qt9xgn", identifier="conn_123456789" ... ) |
| get_environment_blueprintA | Retrieves metadata and definition of an environment blueprint. related tools:
Args: domain_identifier (str): The ID of the domain in which this blueprint exists. Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ identifier (str): The ID of the environment to retrieve. Length Constraints: Minimum length of 0. Maximum length of 128. Returns: Any: The API response containing the Amazon DataZone blueprint metadata: |
| get_environment_blueprint_configurationA | Gets an Amazon DataZone environment blueprint configuration. Retrieves the configuration schema and parameters that must be provided when provisioning an environment from a given blueprint. Args: domain_identifier (str): The ID of the domain where where this blueprint exists. Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ identifier (str): The ID of the environment blueprint. Pattern: ^[a-zA-Z0-9_-]{1,36}$ Returns: Any: The API response containing information about the Amazon DataZone environment blueprint configuration: |
| list_connectionsA | Lists connections in Amazon DataZone. This is specifically for listing DataZone connections and should be used in the DataZone MCP server. Args: domain_identifier (str): The ID of the domain where you want to list connections project_identifier (str): The ID of the project where you want to list connections max_results (int, optional): Maximum number of connections to return (1-50, default: 50) next_token (str, optional): Token for pagination environment_identifier (str, optional): The ID of the environment where you want to list connections name (str, optional): The name of the connection to filter by (0-64 characters) sort_by (str, optional): How to sort the listed connections (valid: "NAME") sort_order (str, optional): Sort order (valid: "ASCENDING" or "DESCENDING") type (str, optional): The type of connection to filter by (valid: ATHENA, BIGQUERY, DATABRICKS, etc.) Returns: Dict[str, Any]: The list of connections including: - items: Array of connection summaries - nextToken: Token for pagination if more results are available |
| list_environment_blueprintsA | Lists environment blueprints in an Amazon DataZone domain. Args: domain_identifier (str): The ID of the domain where the blueprints are listed Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ managed (bool, optional): Specifies whether to list only managed blueprints max_results (int, optional): Maximum number of blueprints to return (1-50, default: 50) name (str, optional): Filter blueprints by name (1-64 characters) Pattern: ^[\w -]+$ next_token (str, optional): Token for pagination (1-8192 characters) Returns: Dict containing: - items: List of environment blueprints, each containing: - id: Blueprint identifier - name: Blueprint name - description: Blueprint description - provider: Blueprint provider - provisioning_properties: Blueprint provisioning properties - created_at: Creation timestamp - updated_at: Last update timestamp - next_token: Token for pagination if more results are available |
| list_environment_blueprint_configurationsB | Lists environment blueprints in an Amazon DataZone domain. Args: domain_identifier (str): The ID of the domain where the blueprint configurations are listed Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ max_results (int, optional): Maximum number of blueprint configurations to return (1-50, default: 50) next_token (str, optional): Token for pagination (1-8192 characters) Returns: dict: A dictionary with the following structure: Args: items (List[dict]): A list of environment blueprint summaries, each including: - createdAt (str): The timestamp when the blueprint was created. - domainId (str): The identifier of the Amazon DataZone domain. - enabledRegions (List[str]): A list of AWS regions where the blueprint is enabled. - environmentBlueprintId (str): Unique ID of the environment blueprint. - environmentRolePermissionBoundary (str): ARN of the permission boundary used for environment roles. - manageAccessRoleArn (str): ARN of the IAM role used to manage environment access. - provisioningConfigurations (List[dict]): A list of provisioning configuration objects. (Details not expanded here — structure is custom and tool-dependent.) - provisioningRoleArn (str): ARN of the IAM role used to provision environments. - regionalParameters (dict): A dictionary mapping region names to parameter maps. Example: { "us-west-2": { "param1": "value1" } } - updatedAt (str): The timestamp when the blueprint was last updated. |
| list_environment_profilesA | Lists environment profiles within a specified Amazon DataZone domain, optionally filtered by AWS account, region, blueprint, and project. Args: domain_identifier (str): The identifier of the Amazon DataZone domain. Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ Required: Yes Returns: dict: A dictionary containing: - items (List[dict]): A list of environment profile summaries. Each item includes: - awsAccountId (str): AWS account where the profile exists. - awsAccountRegion (str): AWS region of the profile. - createdAt (str): Timestamp when the profile was created. - createdBy (str): Identifier of the user who created the profile. - description (str): Description of the profile. - domainId (str): The domain associated with the profile. - environmentBlueprintId (str): ID of the blueprint used. - id (str): Unique ID of the environment profile. - name (str): Name of the environment profile. - projectId (str): ID of the associated project. - updatedAt (str): Timestamp of last update. |
| create_glossaryA | Creates a new business glossary in Amazon DataZone. Args: domain_identifier (str): The ID of the domain where the glossary will be created name (str): The name of the glossary (1-256 characters) owning_project_identifier (str): The ID of the project that will own the glossary description (str, optional): The description of the glossary (0-4096 characters) status (str, optional): The status of the glossary (ENABLED or DISABLED, default: ENABLED) client_token (str, optional): A unique token to ensure idempotency (1-128 characters) Returns: Any: The API response containing the created glossary details Example:
|
| create_glossary_termA | Creates a new business glossary term in Amazon DataZone. Args: domain_identifier (str): The ID of the domain where the glossary term will be created Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ glossary_identifier (str): The ID of the glossary where the term will be created Pattern: ^[a-zA-Z0-9_-]{1,36}$ name (str): The name of the glossary term (1-256 characters) short_description (str, optional): A short description of the term (0-1024 characters) long_description (str, optional): A detailed description of the term (0-4096 characters) status (str, optional): The status of the term (ENABLED or DISABLED, default: ENABLED) term_relations (Dict[str, List[str]], optional): The term relations Example: { "classifies": ["term-id-1", "term-id-2"], "isA": ["term-id-3"] } client_token (str, optional): A unique token to ensure idempotency (1-128 characters) Pattern: ^[\x21-\x7E]+$ Returns: Any: The API response containing the created glossary term details Example:
|
| get_glossaryA | Retrieves detailed information about a specific business glossary in Amazon DataZone. Args: domain_identifier (str): The ID of the domain where the glossary exists Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ identifier (str): The ID of the glossary to retrieve Pattern: ^[a-zA-Z0-9_-]{1,36}$ Returns: Any: The API response containing glossary details including: - createdAt (number): Timestamp of when the glossary was created - createdBy (str): The user who created the glossary - description (str): The description of the glossary (0-4096 characters) - domainId (str): The ID of the domain - id (str): The ID of the glossary - name (str): The name of the glossary (1-256 characters) - owningProjectId (str): The ID of the project that owns the glossary - status (str): The status of the glossary (DISABLED or ENABLED) - updatedAt (number): Timestamp of when the glossary was updated - updatedBy (str): The user who updated the glossary Example:
|
| get_glossary_termA | Retrieves detailed information about a specific business glossary term in Amazon DataZone. Args: domain_identifier (str): The ID of the domain where the glossary term exists Pattern: ^dzd[-][a-zA-Z0-9-]{1,36}$ identifier (str): The ID of the glossary term to retrieve Pattern: ^[a-zA-Z0-9_-]{1,36}$ Returns: Any: The API response containing glossary term details including: - createdAt (number): Timestamp of when the term was created - createdBy (str): The user who created the term - domainId (str): The ID of the domain - glossaryId (str): The ID of the glossary containing the term - id (str): The ID of the glossary term - longDescription (str): The long description of the term (0-4096 characters) - name (str): The name of the term (1-256 characters) - shortDescription (str): The short description of the term (0-1024 characters) - status (str): The status of the term (ENABLED or DISABLED) - termRelations (dict): The relations of the term Example: { "classifies": ["term-id-1", "term-id-2"], "isA": ["term-id-3"] } - updatedAt (number): Timestamp of when the term was updated - updatedBy (str): The user who updated the term Example:
|
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/awslabs/amazon-datazone-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server