Scout Monitoring MCP

Instructions

Get recent error_groups for an app, optionally filtered to a specific endpoint or
group.

Args:
    app_id (int): The ID of the Scout APM application.
    endpoint_id (str | None): The ID of the endpoint to filter errors. If None,
                              fetches all errors for the app.
    error_group_id (str | None): The ID of the error group to filter errors.

Implementation Reference

• scout_mcp/server.py:305-336 (handler)

  The primary handler function for the MCP tool 'get_app_error_groups'. It retrieves error groups for a given Scout APM application within a time range, optionally filtered by endpoint_id or a specific error_group_id. Uses the scout_api client to fetch the data and handles errors gracefully.

  @mcp.tool(name="get_app_error_groups")
  async def get_app_error_groups(
      app_id: int,
      from_: str,
      to: str,
      endpoint_id: str | None = None,
      error_group_id: str | None = None,
  ) -> list[dict[str, Any]] | dict[str, Any]:
      """
      Get recent error_groups for an app, optionally filtered to a specific endpoint or
      group.
  
      Args:
          app_id (int): The ID of the Scout APM application.
          endpoint_id (str | None): The ID of the endpoint to filter errors. If None,
                                    fetches all errors for the app.
          error_group_id (str | None): The ID of the error group to filter errors.
      """
      try:
          duration = scout_api.make_duration(from_, to)
          async with api_client as scout_client:
              if error_group_id:
                  errors = await scout_client.get_error_group(app_id, error_group_id)
                  errors = [errors] if errors else []
              else:
                  errors = await scout_client.get_error_groups(
                      app_id, duration, endpoint_id
                  )
          return errors
      except scout_api.ScoutAPMError as e:
          return [{"error": str(e)}]