list_experiments
Retrieve all AWS Fault Injection Service experiments in a specified region to monitor and manage chaos engineering tests.
Instructions
List all AWS FIS experiments in the specified region.
Args:
region: AWS region to query (default: us-east-1)
Returns:
JSON string containing experiments information
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| region | No | us-east-1 |
Implementation Reference
- aws_fis_mcp/tools.py:120-152 (handler)The handler function for the 'list_experiments' tool. It creates a boto3 FIS client, calls list_experiments(), formats the results into a list of dictionaries with key fields, serializes datetimes manually, and returns a JSON string.def list_experiments(region: str = "us-east-1") -> str: """ List all AWS FIS experiments in the specified region. Args: region: AWS region to query (default: us-east-1) Returns: JSON string containing experiments information """ try: fis = boto3.client('fis', region_name=region) response = fis.list_experiments() if not response.get('experiments'): return "No experiments found in region " + region # Format the response for better readability experiments = [] for experiment in response['experiments']: experiments.append({ 'id': experiment.get('id'), 'experimentTemplateId': experiment.get('experimentTemplateId'), 'state': experiment.get('state', {}).get('status'), 'startTime': experiment.get('startTime').isoformat() if experiment.get('startTime') else None, 'endTime': experiment.get('endTime').isoformat() if experiment.get('endTime') else None, 'tags': experiment.get('tags', {}) }) return json.dumps(experiments, indent=2) except Exception as e: return f"Error listing experiments: {str(e)}"
- aws_fis_mcp/server.py:27-27 (registration)Registration of the list_experiments tool function with the FastMCP app using the @tool decorator equivalent.app.tool()(list_experiments)
- aws_fis_mcp/server.py:10-10 (registration)Import of the list_experiments function from tools module, prerequisite for registration.list_experiments,