AWS‑IReveal‑MCP

Instructions

Fetch configuration snapshots for a resource between two ISO timestamps.

Parameters:
  aws_region (str): The AWS region - use 'us-east-1' if not specified.
  resource_type (str): e.g. 'AWS::S3::Bucket'.
  resource_id (str): the resource's ARN or ID.
  start_time (str): ISO timestamp, e.g. '2025-04-01T00:00:00Z'.
  end_time   (str): ISO timestamp.
  limit (int): Maximum number of configuration items to return.

Returns:
  JSON list of ConfigurationItem objects.

Implementation Reference

• server.py:722-761 (handler)

  The handler function implementing the 'config_get_resource_config_history' tool. It uses the AWS Config boto3 client to fetch historical configuration snapshots for a specific resource within a time range, serializing the results as JSON.

  @mcp.tool()
  def config_get_resource_config_history(
      aws_region: str,
      resource_type: str,
      resource_id: str,
      start_time: str,
      end_time: str,
      limit: int = 10
  ) -> str:
      """
      Fetch configuration snapshots for a resource between two ISO timestamps.
  
      Parameters:
        aws_region (str): The AWS region - use 'us-east-1' if not specified.
        resource_type (str): e.g. 'AWS::S3::Bucket'.
        resource_id (str): the resource's ARN or ID.
        start_time (str): ISO timestamp, e.g. '2025-04-01T00:00:00Z'.
        end_time   (str): ISO timestamp.
        limit (int): Maximum number of configuration items to return.
  
      Returns:
        JSON list of ConfigurationItem objects.
      """
      client = boto3.client('config', region_name=aws_region)
      # Parse ISO timestamps into datetime (with UTC)
      try:
          start_dt = datetime.datetime.fromisoformat(start_time.replace('Z', '+00:00'))
          end_dt   = datetime.datetime.fromisoformat(end_time.replace('Z', '+00:00'))
      except Exception as e:
          return f"Error parsing timestamps: {e}"
  
      resp = client.get_resource_config_history(
          resourceType=resource_type,
          resourceId=resource_id,
          earlierTime=start_dt,
          laterTime=end_dt,
          limit=limit
      )
      items = resp.get("configurationItems", [])
      return json.dumps(items, indent=2, cls=DateTimeEncoder)

• server.py:616-620 (helper)

  Helper class for JSON encoding datetime objects to ISO strings, used in the tool's response serialization.

  class DateTimeEncoder(json.JSONEncoder):
      def default(self, o):
          if isinstance(o, datetime.datetime):
              return o.isoformat()  # Convert datetime to ISO-format string.
          return super().default(o)

• server.py:722-722 (registration)

  The @mcp.tool() decorator registers this function as an MCP tool, automatically inferring input schema from type hints and docstring.

  @mcp.tool()