amazon-datazone-mcp-server
MCP server for AWS DataZone service - enables LLMs to interact with DataZone for data governance, cataloging, and management
How to read this: tool names here are observed from a live tools/list handshake. The Risk label is a heuristic inferred from the tool name (write/destructive verbs), not from executing the tool — a conservative guess, not a verified capability. We never escalate risk from a description. Found one that's wrong? Tell us — we fix on report.
| Tool | Risk | Side effects | Approval |
|---|---|---|---|
| get_glossary 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:
```python
response = await get_glossary(
domain_identifier="dzd_123456789", identifier="gloss_987654321"
)
```
| read | false | unknown |
| get_glossary_term 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:
```python
response = await get_glossary_term(
domain_identifier="dzd_123456789", identifier="term_987654321"
)
```
| read | false | unknown |
| search_listings 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:
- search: Use only when the user needs general discovery across **all** entity types (e.g., glossary terms, data products).
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
| read | false | unknown |
| get_domain
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
| read | false | unknown |
| list_domain_units
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
| read | false | unknown |
| create_domain
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
| write | true | unknown |
| publish_asset 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
revision (str, optional): The specific revision of the asset to publish
client_token (str, optional): Token for idempotency
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
| write | true | unknown |
| list_domains
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)
| read | false | unknown |
| create_domain_unit
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
| write | true | unknown |
| get_domain_unit
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
| read | false | unknown |
| add_entity_owner
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
| write | true | unknown |
| add_policy_grant
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
| write | true | unknown |
| search_types
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)
managed (bool): Whether the search is for managed types. (Required)
filters (dict, optional): A FilterClause object specifying a single filter for the search.
Only one member of the union type may be used.
max_results (int, optional): The maximum number of results to return in a single call.
Valid range: 1–50. Default is service-defined.
next_token (str, optional): Token for paginating results. Used to retrieve the next page of results
when the number of results exceeds max_results.
Length constraints: 1–8192 characters.
search_in (List[dict], optional): A list of SearchInItem objects specifying search fields.
Minimum of 1 item, maximum of 10.
search_scope (str): The scope of the search. Valid values:
"ASSET_TYPE", "FORM_TYPE", "LINEAGE_NODE_TYPE". (Required)
search_text (str, optional): The free-text string to search for.
Length constraints: 1–4096 characters.
sort (dict, optional): A SearchSort object specifying how to sort the results.
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.
| read | false | unknown |
| search_user_profiles
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 `maxResults` and `nextToken`.
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
max_results (int, optional): The maximum number of user profiles to return in a single call.
Valid Range: 1–50
Required: No
next_token (str, optional): Pagination token from a previous response. Use to retrieve the next page of results.
Min length: 1, Max length: 8192
Required: No
search_text (str, optional): Text to search for in user profiles.
Max length: 1024
Required: No
user_type (str): The type of user profile to search for.
Valid values:
- "SSO_USER"
- "DATAZONE_USER"
- "DATAZONE_SSO_USER"
- "DATAZONE_IAM_USER"
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
| read | false | unknown |
| search
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:
```python
response = await search(
domain_identifier="dzd-1234567890",
search_scope="ASSET",
search_text="customer data",
search_in=[{"attribute": "name"}, {"attribute": "description"}],
sort={"attribute": "name", "order": "ASCENDING"},
max_results=25
)
```
| read | false | unknown |
| get_user_profile
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
type (str): The type of the user profile.
Valid values: "IAM" | "SSO"
Required: Yes
user_identifier (str): The identifier of the user for whom to retrieve the profile.
Pattern: r"(^([0-9a-f]{10}-|)[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]
{4}-[A-Fa-f0-9]{12}$|^[a-zA-Z_0-9+=,.@-]+$|^arn:aws:iam::\d{12}:.+$)"
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".
| read | false | unknown |
| search_group_profiles
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 `maxResults` and `nextToken`.
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
group_type (str): The type of group to search for.
Valid values:
- "SSO_GROUP"
- "DATAZONE_SSO_GROUP"
Required: Yes
max_results (int, optional): The maximum number of results to return in a single call.
Valid range: 1–50
Required: No
next_token (str, optional): Pagination token from a previous response. Use this to retrieve the next set of results.
Length: 1–8192 characters
Required: No
search_text (str, optional): Free-text string used to filter group profiles.
Max length: 1024
Required: No
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.
| read | false | unknown |
| get_asset 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:
- Full metadata (business and technical)
- Lineage information
- Forms and glossary terms
- Time-series details
- Revision history
- Access and listing info
Data asset is a specific dataset or table, while data source is a location where your data resides.
related tools:
- search: use when user is **trying to discover or explore** unknown assets based on keywords, metadata, or filters.
- get_data_source: get detailed information about one specific data source in a domain.
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
| read | false | unknown |
| create_asset 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
| write | true | unknown |
| get_listing 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
| read | false | unknown |
| start_data_source_run 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:
```python
response = await start_data_source_run(
domain_identifier='dzd-1234567890',
data_source_identifier='ds-1234567890',
client_token='unique-token-123',
)
```
| write | true | unknown |
| get_form_type 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:
```python
response = await get_form_type(
domain_identifier='dzd_123456789',
form_type_identifier='amazon.datazone.customer_profile',
revision='1.0.0',
)
```
| read | false | unknown |
| get_project 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:
- View deployment status, user roles, or configurations
- Audit metadata for compliance or review
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)
| read | false | unknown |
| create_data_source 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)
| write | true | unknown |
| get_data_source 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:
- Connection settings
- Ingestion configuration
- Authentication and scheduling details
- Last run status and errors
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:
- list_data_sources: retrieve ea list of data sources in a domain by name, status, type, etc.
- get_asset: get detailed information about one specific data asset in a data source.
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
| read | false | unknown |
| create_subscription_request 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
| write | true | unknown |
| create_form_type 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:
```python
response = await create_form_type(
domain_identifier='dzd_123456789',
name='amazon.datazone.customer_profile',
model={
'schema': {
'type': 'object',
'properties': {
'customer_id': {'type': 'string'},
'customer_name': {'type': 'string'},
'email': {'type': 'string', 'format': 'email'},
},
'required': ['customer_id', 'customer_name'],
}
},
owning_project_identifier='prj_987654321',
description='Form type for customer profile information',
status='ENABLED',
)
```
| write | true | unknown |
| list_projects 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
| read | false | unknown |
| accept_subscription_request 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
| read | false | unknown |
| get_subscription 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
| read | false | unknown |
| create_project 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
| write | true | unknown |
| list_data_sources 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 `get_data_source` in that case.
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)
- nextToken (str): Token to retrieve the next page of results, if any.
| read | false | unknown |
| create_project_membership 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.
| write | true | unknown |
| list_project_profiles 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
| read | false | unknown |
| list_environments 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",
... )
| read | false | unknown |
| create_project_profile 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
| write | true | unknown |
| get_project_profile 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"
| read | false | unknown |
| get_connection 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:
- get_data_source: get detailed information about one specific data source (a data locatin)
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,
... )
| read | false | unknown |
| list_project_memberships 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
project_identifier (str): The identifier of the project whose memberships you want to list.
Pattern: ^[a-zA-Z0-9_-]{1,36}$
Required: Yes
max_results (int, optional): The maximum number of memberships to return in a single call (1–50).
next_token (str, optional): A token for pagination. Use this token from a previous response to retrieve the next set of memberships.
Length: 1–8192 characters
sort_by (str, optional): The attribute by which to sort the memberships.
Valid Values: "NAME"
sort_order (str, optional): The sort order for the results.
Valid Values: "ASCENDING" | "DESCENDING"
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).
- nextToken (str, optional): A token to retrieve the next page of results if more memberships exist.
Length: 1–8192 characters
| read | false | unknown |
| create_connection 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",
... )
| write | true | unknown |
| get_environment_blueprint_configuration 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:
- createdAt (str): Timestamp indicating when the blueprint was created.
- domainId (str): ID of the DataZone domain associated with the blueprint.
- Pattern: ^dzd[-_][a-zA-Z0-9_-]{1,36}$
- enabledRegions (list of str): List of AWS regions where the blueprint is enabled.
- Each region string must follow the pattern: ^[a-z]{2}-?(iso|gov)?-{1}[a-z]*-{1}[0-9]$
- Length constraints: 4–16 characters.
- environmentBlueprintId (str): Unique ID of the blueprint.
- Pattern: ^[a-zA-Z0-9_-]{1,36}$
- environmentRolePermissionBoundary (str): ARN of the IAM policy that defines the permission boundary for environment roles.
- Pattern: r"^arn:aws[^:]*:iam::(aws|\d{12}):policy/[\w+=,.@-]*$"
- manageAccessRoleArn (str): ARN of the IAM role used to manage access to the blueprint.
- Pattern: ^arn:aws[^:]*:iam::\d{12}:(role|role/service-role)/[\w+=,.@-]*$
- provisioningConfigurations (list of dict): Provisioning configurations associated with the blueprint.
- Each item is a `ProvisioningConfiguration` object describing how resources are provisioned.
- provisioningRoleArn (str): ARN of the IAM role used for provisioning resources.
- Pattern: ^arn:aws[^:]*:iam::\d{12}:(role|role/service-role)/[\w+=,.@-]*$
- regionalParameters (dict): A nested map of region-specific parameters.
- Outer keys: Region codes (e.g., "us-west-2")
- Constraints: 4–16 characters, pattern: ^[a-z]{2}-?(iso|gov)?-{1}[a-z]*-{1}[0-9]$
- Inner dicts: Key-value pairs of configuration parameters for that region.
- updatedAt (str): Timestamp indicating when the blueprint was last updated.
| read | false | unknown |
| get_environment 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"
... )
| read | false | unknown |
| get_environment_blueprint Retrieves metadata and definition of an environment blueprint.
related tools:
- get_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 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:
- createdAt (str): Timestamp indicating when the blueprint was created.
- deploymentProperties (dict): Deployment-related configuration, including:
- endTimeoutMinutes (int): Timeout in minutes for ending deployment.
- startTimeoutMinutes (int): Timeout in minutes for starting deployment.
- description (str): A description of the blueprint.
- Constraints: 0–2048 characters.
- glossaryTerms (list of str): Glossary terms associated with the blueprint.
- Constraints: 1–20 items.
- Pattern: ^[a-zA-Z0-9_-]{1,36}$
- id (str): Unique ID of the blueprint.
- Pattern: ^[a-zA-Z0-9_-]{1,36}$
- name (str): Name of the blueprint.
- Constraints: 1–64 characters.
- Pattern: r"^[\w -]+$"
- provider (str): The provider of the blueprint.
- provisioningProperties (dict): Provisioning configuration for the blueprint.
- Note: This is a union object—only one configuration type may be present.
- updatedAt (str): Timestamp indicating when the blueprint was last updated.
- userParameters (list of dict): Custom parameters defined by the user, each including:
- defaultValue (str): Default value for the parameter.
- description (str): Description of the parameter.
- fieldType (str): Type of input field (e.g., string, boolean).
- isEditable (bool): Whether the parameter is user-editable.
- isOptional (bool): Whether the parameter is optional.
- keyName (str): Key name for the parameter.
| read | false | unknown |
| list_environment_blueprint_configurations 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.
nextToken (str): Token for paginated results. Use in subsequent requests to retrieve the next set of environment blueprints.
| read | false | unknown |
| list_connections 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
| read | false | unknown |
| create_glossary 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:
```python
response = await create_glossary(
domain_identifier="dzd_123456789",
name="Sales Glossary",
owning_project_identifier="prj_987654321",
description="Glossary for sales-related terms",
status="ENABLED",
)
```
| write | true | unknown |
| list_environment_blueprints 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
| read | false | unknown |
| create_glossary_term 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:
```python
response = await create_glossary_term(
domain_identifier="dzd_123456789",
glossary_identifier="gloss_987654321",
name="Customer",
short_description="A person or organization that purchases goods or services",
long_description="In business, a customer is an individual or organization that purchases goods or services from a company. Customers are vital to the success of any business as they provide revenue and feedback.",
status="ENABLED",
term_relations={"classifies": ["term_123", "term_456"], "isA": ["term_789"]},
)
```
| write | true | unknown |
| list_environment_profiles 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
aws_account_id (str, optional): The AWS account ID to filter results.
Pattern: r"^\d{12}$"
aws_account_region (str, optional): The AWS region to filter results.
Pattern: ^[a-z]{2}-[a-z]{4,10}-\d$
environment_blueprint_identifier (str, optional): The identifier of the blueprint used to create the environment profiles.
Pattern: ^[a-zA-Z0-9_-]{1,36}$
max_results (int, optional): Maximum number of results to return (1–50).
name (str, optional): Filter environment profiles by name.
Length: 1–64 characters
Pattern: ^[\w -]+$
next_token (str, optional): A pagination token returned from a previous call to retrieve the next set of results.
Length: 1–8192 characters
project_identifier (str, optional): The identifier of the Amazon DataZone project.
Pattern: ^[a-zA-Z0-9_-]{1,36}$
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.
- nextToken (str): Token for retrieving the next page of results, if any.
| read | false | unknown |
- repohttps://github.com/awslabs/amazon-datazone-mcp-server
- packagehttps://pypi.org/project/amazon-datazone-mcp-server
- homepagehttps://github.com/awslabs/amazon-datazone-mcp-server
- licenseNOASSERTION
- adoption6 stars · 5 forks
The access this server can exercise, inferred from its verified tools — not a declared OAuth scope.
Add the “as seen on MCPExplorer” badge to your README.
This is one server. A loadout combines the right servers, governance, and proven plays for a whole job — assembled deliberately, not tool-dumped.
Explore loadouts →