list_apps
Retrieve and filter Scout APM applications based on activity, using an optional ISO 8601 timestamp to show apps with data since a specific time.
Instructions
List available Scout APM applications. Provide an optional `active_since` ISO 8601
to filter to only apps that have reported data since that time. Defaults to the
metric retention period of thirty days.
Args:
active_since (str): ISO 8601 datetime string to filter apps active since that
time.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| active_since | No |
Implementation Reference
- scout_mcp/server.py:122-159 (handler)The main handler function for the 'list_apps' tool, decorated with @mcp.tool(name="list_apps"). It fetches apps from Scout API, filters by active_since, and handles errors.@mcp.tool(name="list_apps") async def list_scout_apps(active_since: str | None = None) -> list[dict[str, Any]]: """ List available Scout APM applications. Provide an optional `active_since` ISO 8601 to filter to only apps that have reported data since that time. Defaults to the metric retention period of thirty days. Args: active_since (str): ISO 8601 datetime string to filter apps active since that time. """ active_time = ( scout_api._parse_time(active_since) if active_since else datetime.now(tz=timezone.utc) - timedelta(days=30) ) def parse_reported_at(reported_at: str) -> datetime: parsed = ( scout_api._parse_time(reported_at) if reported_at else datetime.min.replace(tzinfo=timezone.utc) ) return parsed try: async with api_client as scout_client: apps = await scout_client.get_apps() filtered = [ app for app in apps if parse_reported_at(app["last_reported_at"]) >= active_time ] return filtered except scout_api.ScoutAPMError as e: return [{"error": str(e)}]