plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "clickstack",
  "version": "0.1.1",
  "description": "Connect to Managed ClickStack in ClickHouse Cloud to investigate logs, metrics, and traces and manage dashboards, alerts, and saved searches.",
  "author": {
    "name": "ClickHouse",
    "url": "https://clickhouse.com"
  },
  "homepage": "https://clickhouse.com/clickstack",
  "keywords": [
    "clickstack",
    "clickhouse",
    "observability",
    "logs",
    "metrics",
    "traces"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "ClickStack",
        "shortDescription": "Explore logs, metrics, traces",
        "longDescription": "ClickStack connects ChatGPT and Codex to Managed ClickStack, the observability stack built on ClickHouse Cloud. Sign in with your ClickHouse Cloud account using OAuth to work with the observability data your account can already access.\n\nUse ClickStack to:\n- List data sources and inspect their schemas, attributes, and metrics.\n- Check service health: throughput, error rate, and p50/p95/p99 latency compared with the previous day.\n- Search and aggregate logs, traces, and metrics, and plot trends over time.\n- Find recurring log patterns, new or disappearing signals, and attributes that distinguish slow or failing requests.\n- Open a single trace as a span waterfall and find its slowest operations.\n- Create and update dashboards, alerts, and saved searches so findings can be shared with your team.\n\nClickStack is intended for engineers, SREs, and on-call teams who use Managed ClickStack. It requires a ClickHouse Cloud service with ClickStack and MCP access enabled. It only accesses teams, sources, and data permitted for the signed-in account. It does not ingest telemetry, change ClickHouse Cloud service configuration or billing, or access data outside your ClickStack teams.",
        "developerName": "ClickHouse",
        "category": "Developer Tools",
        "capabilities": [
          "Check service health",
          "Search logs and traces",
          "Query metrics",
          "Find log patterns",
          "Inspect traces",
          "Manage dashboards",
          "Manage alerts",
          "Manage saved searches"
        ],
        "websiteURL": "https://clickhouse.com/clickstack",
        "supportURL": "https://clickhouse.com/support/program",
        "privacyPolicyURL": "https://clickhouse.com/legal/privacy-policy",
        "termsOfServiceURL": "https://clickhouse.com/legal/clickhouse-general-terms-and-conditions",
        "defaultPrompt": [
          "Show me the services with the highest error rate over the last 24 hours.",
          "What are the most common error log patterns in the last hour?",
          "Explore my ClickStack data sources and summarize what data is available."
        ],
        "composerIcon": "./assets/logo.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Discover available data sources and their schema",
              "prompt": "What data sources are available in ClickStack, and what columns does the logs source have?",
              "tools_triggered": "clickstack_list_sources, clickstack_describe_source",
              "expected_behavior": "Lists the log, trace, and metric sources available to the signed-in team, then summarizes the logs source's key columns and attribute keys."
            },
            {
              "description": "Rank services by error rate",
              "prompt": "Show me the services with the highest error rate over the last 24 hours.",
              "tools_triggered": "clickstack_list_sources, clickstack_service_health",
              "expected_behavior": "Returns services ranked by error rate with throughput and p50/p95/p99 latency, compared with the same window yesterday, and highlights the top error groups."
            },
            {
              "description": "Find recurring error log patterns",
              "prompt": "What are the most common error log patterns in the last hour?",
              "tools_triggered": "clickstack_list_sources, clickstack_describe_source, clickstack_event_patterns",
              "expected_behavior": "Groups error-level logs into templated patterns ranked by estimated count, with example messages and the services that emit them."
            },
            {
              "description": "Inspect a slow trace",
              "prompt": "Find one of the slowest traces from the last hour and show me where the time was spent.",
              "tools_triggered": "clickstack_list_sources, clickstack_search, clickstack_trace_waterfall",
              "expected_behavior": "Finds a high-duration span, opens its trace as a parent/child span waterfall, and identifies the operations that account for most of the latency."
            },
            {
              "description": "Create a dashboard from an investigation",
              "prompt": "Create a dashboard called 'Service overview' with request count and p95 latency per service over time.",
              "tools_triggered": "clickstack_list_sources, clickstack_describe_source, clickstack_save_dashboard, clickstack_query_tiles",
              "expected_behavior": "Creates a dashboard in ClickStack with request-count and p95-latency time-series tiles grouped by service, validates that the tiles return data, and returns the dashboard name and ID."
            }
          ],
          "negative": [
            {
              "description": "Request unrelated to observability data; the plugin should not call ClickStack tools.",
              "prompt": "Book me a flight from San Francisco to New York next Friday."
            },
            {
              "description": "Request to change ClickHouse Cloud infrastructure or billing, which the plugin does not support; it should explain the limitation and point to the ClickHouse Cloud console.",
              "prompt": "Upgrade my ClickHouse Cloud service to a larger tier and add more replicas."
            },
            {
              "description": "Request for data outside the signed-in account; the plugin should only use teams returned by clickstack_list_teams and explain that other organizations' data is not accessible.",
              "prompt": "Show me the error logs from another company's ClickStack account."
            }
          ]
        },
        "demo_recording_url": "https://www.youtube.com/watch?v=FaL5iOgNogg",
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments."
      },
      "publication": {
        "release_notes": "Initial release. Connects to Managed ClickStack in ClickHouse Cloud with OAuth to check service health, search and aggregate logs, metrics, and traces, find log patterns, inspect traces, and manage dashboards, alerts, and saved searches."
      },
      "apps": "./.app.json"
    }
  }
}