Last9

{
  "mcp": {
    "servers": {
      "last9": {
        "type": "stdio",
        "command": "/opt/homebrew/bin/last9-mcp",
        "env": {
          "LAST9_REFRESH_TOKEN": "<your_refresh_token>"
        }
      }
    }
  }
}

Untuk NPM: gunakan "command": "npx" dan tambahkan "args": ["-y", "@last9/mcp-server@latest"].

Setelah mengunduh dari GitHub Releases, ekstrak dan arahkan ke path lengkap:

{
  "mcpServers": {
    "last9": {
      "command": "C:\\Users\\<user>\\AppData\\Local\\Programs\\last9-mcp-server.exe",
      "env": {
        "LAST9_REFRESH_TOKEN": "<your_refresh_token>"
      }
    }
  }
}

Rute NPM lebih mudah di Windows — tidak perlu mengelola path.

Jalankan dalam Mode HTTP

export LAST9_REFRESH_TOKEN="your_refresh_token"
export LAST9_HTTP=true
export LAST9_PORT=8080
./last9-mcp-server

Server dimulai di http://localhost:8080/mcp.

Uji dengan curl

Handler Streamable HTTP berjalan dalam mode stateless, sehingga setiap permintaan dilayani secara independen. Jabat tangan initialize dan header Mcp-Session-Id bersifat opsional — klien yang mengirimnya tetap berfungsi (header diterima dan diabaikan), dan klien juga dapat langsung melompat ke tools/list / tools/call. Setiap tool adalah kueri request/response yang independen; server tidak mengeluarkan notifikasi server→klien, sehingga GET /mcp (aliran SSE) mengembalikan 405.

# List tools — a session handshake is optional in stateless mode
curl -s -X POST http://localhost:8080/mcp \
    -H "Content-Type: application/json" \
    -H "Accept: application/json, text/event-stream" \
    -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}'

# Call a tool
curl -s -X POST http://localhost:8080/mcp \
    -H "Content-Type: application/json" \
    -H "Accept: application/json, text/event-stream" \
    -d '{
      "jsonrpc": "2.0",
      "id": 2,
      "method": "tools/call",
      "params": {
        "name": "get_service_logs",
        "arguments": {
          "service_name": "your-service-name",
          "lookback_minutes": 30,
          "limit": 10
        }
      }
    }'

Membangun dari Sumber

git clone https://github.com/last9/last9-mcp-server.git
cd last9-mcp-server
go build -o last9-mcp-server
LAST9_HTTP=true ./last9-mcp-server

LAST9_HTTP=true digunakan untuk pengembangan lokal. Untuk penggunaan aktual, endpoint HTTP yang di-hosting lebih mudah.

Input Waktu

• Waktu absolut (start_time_iso/end_time_iso, atau time_iso) diutamakan daripada lookback_minutes.
• Untuk jendela relatif: gunakan lookback_minutes.
• Untuk jendela absolut: gunakan RFC3339/ISO8601 — 2026-02-09T15:04:05Z.
• YYYY-MM-DD HH:MM:SS lama diterima hanya untuk kompatibilitas.

get_exceptions

• limit (integer, opsional): Maksimum exception. Default: 20.
• lookback_minutes (integer, opsional): Default: 60.
• start_time_iso / end_time_iso (string, opsional): Rentang waktu absolut.
• service_name (string, opsional): Filter berdasarkan layanan.
• span_name (string, opsional): Filter berdasarkan nama span.
• env (string, opsional): Filter berdasarkan lingkungan.

get_service_summary

• start_time_iso / end_time_iso (string, opsional)
• env (string, opsional): Regex PromQL. Default: .*. Pencocokan tepat memerlukan jangkar (mis. ^prod$).
• sort_by (string, opsional): request_count (default), throughput_rpm, http_4xx_count, http_5xx_count, atau grpc_error_count.
• limit (integer, opsional): Maksimum baris yang diperingkat. Hilangkan atau 0 berarti 10; nilai di atas 100 dibatasi ke 100.

get_service_environments

• start_time_iso / end_time_iso (string, opsional)

Semua alat APM lainnya memerlukan nilai env. Gunakan "" jika ini mengembalikan kosong.

get_service_performance_details

• service_name (string, wajib)
• lookback_minutes (integer, opsional): Default: 60.
• start_time_iso / end_time_iso (string, opsional)
• env (string, opsional): Default: prod.

get_service_operations_summary

• service_name (string, wajib)
• lookback_minutes (integer, opsional): Default: 60.
• start_time_iso / end_time_iso (string, opsional)
• env (string, opsional): Default: prod.

get_service_dependency_graph

• service_name (string, opsional)
• lookback_minutes (integer, opsional): Default: 60.
• start_time_iso / end_time_iso (string, opsional)
• env (string, opsional): Default: prod.

get_apm_service_deviations

• service_name (string, opsional): Hilangkan untuk cakupan fleet; sediakan untuk satu layanan dan korelasi operasinya.
• lookback_minutes (integer, opsional): Jendela saat ini. Default: 60.
• start_time_iso / end_time_iso (string, opsional): Jendela saat ini eksplisit.
• baseline_start_time_iso / baseline_end_time_iso (string, opsional): Baseline eksplisit. Default: jendela dengan durasi sama yang tepat sebelumnya.
• datasource (string, opsional): Batasi perbandingan ke satu sumber data.
• env (string, opsional): Default: prod.
• max_services / max_operations (integer, opsional): Default 10, maksimum 10 masing-masing.

get_databases

• env (string, opsional): Filter berdasarkan lingkungan. Default: semua.
• lookback_minutes (integer, opsional): Default: 60.
• start_time_iso / end_time_iso (string, opsional)

get_database_slow_queries

• db_system (string, opsional): mis. postgresql, mysql, mongodb, redis.
• host (string, opsional): Host database (net_peer_name).
• service_name (string, opsional): Nama layanan pemanggil.
• env (string, opsional)
• min_duration_ms (float, opsional): Durasi kueri minimum dalam ms.
• lookback_minutes (integer, opsional): Default: 60.
• start_time_iso / end_time_iso (string, opsional)
• limit (integer, opsional): Default: 20.

get_database_queries

• db_system (string, opsional)
• host (string, opsional)
• service_name (string, opsional)
• env (string, opsional)
• lookback_minutes (integer, opsional): Default: 60.
• start_time_iso / end_time_iso (string, opsional)
• limit (integer, opsional): Default: 20.

get_database_server_metrics

• db_system (string, wajib): mis. postgresql, mysql, mongodb, redis, aerospike.
• host (string, opsional)
• lookback_minutes (integer, opsional): Default: 60.
• start_time_iso / end_time_iso (string, opsional)

prometheus_range_query

• query (string, wajib): Kueri PromQL.
• start_time_iso / end_time_iso (string, opsional): Default: 60 menit terakhir.
• lookback_minutes (float, opsional): Default: 60.

prometheus_instant_query

• query (string, wajib)
• time_iso (string, opsional): Default: sekarang.
• lookback_minutes (float, opsional)

prometheus_label_values

• match_query (string, opsional): Filter PromQL.
• label (string, wajib): Nama label.
• start_time_iso / end_time_iso (string, opsional)

prometheus_labels

• match_query (string, opsional): Filter PromQL.
• start_time_iso / end_time_iso (string, opsional)

get_logs

• logjson_query (array, wajib): Kueri pipeline JSON.
• lookback_minutes (integer, opsional): Default: 5.
• start_time_iso / end_time_iso (string, opsional)
• limit (integer, opsional): Default server: 5000.
• index (string, opsional): physical_index:<name> atau rehydration_index:<block_name>.

Untuk inventaris layanan berbasis log, kueri physical_index_service_count terlebih dahulu:

sum by (name, service_name, env) (physical_index_service_count{destination="logs"})

Gunakan service_name sebagai ServiceName, env sebagai lingkungan jika tersedia, dan name sebagai nama indeks fisik. Jika name="default", hilangkan index; untuk indeks fisik non-default yang dipilih oleh pengguna, berikan index: "physical_index:<name>". Jika backend menolak pemfilteran indeks fisik eksplisit, coba lagi tanpa index dan laporkan bahwa pemfilteran indeks fisik eksplisit tidak tersedia untuk backend tersebut.

get_service_logs

• service_name (string, wajib)
• lookback_minutes (integer, opsional): Default: 60.
• limit (integer, opsional): Default: 20.
• env (string, opsional)
• severity_filters (array, opsional): mis. ["error", "warn"]. Logika OR.
• body_filters (array, opsional): mis. ["timeout", "failed"]. Logika OR.
• start_time_iso / end_time_iso (string, opsional)
• index (string, opsional)

Beberapa jenis filter digabungkan dengan AND. Setiap array menggunakan OR secara internal. Gunakan get_logs untuk hitungan agregat yang luas terlebih dahulu; gunakan get_service_logs hanya setelah mempersempit ke layanan/env/index dan kumpulan sampel kecil.

get_log_attributes

• lookback_minutes (integer, opsional): Default: 15.
• start_time_iso / end_time_iso (string, opsional)
• region (string, opsional)
• index (string, opsional)

get_log_attributes_for_pipeline

• pipeline (array, wajib): Tahap filter sebelumnya untuk membatasi penemuan, mis. [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}].
• lookback_minutes (integer, opsional): Default: 15.
• start_time_iso / end_time_iso (string, opsional)
• region (string, opsional)
• index (string, opsional)

get_drop_rules

Tidak ada parameter. Menampilkan aturan drop melalui GET /otel_settings/drop?region=....

add_drop_rule

• name (string, wajib)
• filters (array, wajib): Setiap filter: key, value, operator (equals/not_equals), conjunction (and).
• Kunci filter harus menggunakan attributes["key_name"] atau resource.attributes["key_name"] (wajib oleh API Last9).
• Membuat aturan melalui POST /otel_settings/drop?region=...&cluster_id=....

get_traces

Gunakan untuk pencarian dan agregasi yang luas. Untuk pencarian ID trace yang tepat, gunakan get_service_traces.

• tracejson_query (array, wajib)
• start_time_iso / end_time_iso (string, opsional)
• lookback_minutes (integer, opsional): Default: 60.
• limit (integer, opsional): Default: 5000.

get_service_traces

Tepat satu dari trace_id atau service_name wajib diisi.

• trace_id (string, opsional): Default lookback: 72 jam.
• service_name (string, opsional): Default lookback: 60 menit.
• lookback_minutes (integer, opsional)
• start_time_iso / end_time_iso (string, opsional)
• limit (integer, opsional): Default: 10.
• env (string, opsional)

get_trace_attributes

• lookback_minutes (integer, opsional): Default: 15.
• start_time_iso / end_time_iso (string, opsional)
• region (string, opsional)

get_trace_attributes_for_pipeline

• pipeline (array, wajib): Tahap filter sebelumnya untuk membatasi penemuan, mis. [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}].
• lookback_minutes (integer, opsional): Default: 15.
• start_time_iso / end_time_iso (string, opsional)
• region (string, opsional)

get_trace_attribute_values

• tag_name (string, wajib): Nama atribut dari get_trace_attributes (mis. resource_department atau attributes['http.method']).
• pipeline (array, opsional): Tahap filter sebelumnya untuk membatasi nilai; hilangkan untuk nilai global.
• region (string, opsional)

get_trace_attribute_deviations

• comparison_mode (string, wajib): latency, errors, atau time.
• service_name (string, wajib)
• environment (string, wajib): Nilai deployment.environment yang tepat.
• operation (string, opsional)
• filters (array, opsional): Kondisi filter JSON trace.
• candidate_attributes (array, opsional): Maksimum 8; hilangkan untuk penemuan terbatas.
• latency_threshold_ms (number, opsional): Wajib untuk mode latency; ditolak untuk mode lainnya.
• start_time_iso / end_time_iso (string, opsional)
• lookback_minutes (integer, opsional): Default: 15. Maksimum: 15.
• baseline_start_time_iso / baseline_end_time_iso (string, opsional): Wajib untuk mode time; tidak tumpang tindih dan sama durasinya dengan jendela target.
• minimum_cohort_size (integer, opsional): Default: 100. Minimum: 20.
• minimum_value_support (integer, opsional): Default: 20. Minimum: 10.
• limit (integer, opsional): Default: 10. Maksimum: 10.

Memerlukan kapabilitas backend pendamping yang diaktifkan.

get_trace_waterfall

• trace_id (string, wajib)
• environment (string, opsional)
• start_time_iso / end_time_iso (string, opsional)
• lookback_minutes (integer, opsional): Default: 4320 (72 jam).
• selected_span_id (string, opsional): Mengembalikan atribut, peristiwa, dan tautan untuk span tersebut saja.
• max_spans (integer, opsional): Default: 500. Maksimum: 1000.

Mengembalikan envelope investigation-evidence/v1; waterfall berada di bawah data.

get_change_events

• start_time_iso / end_time_iso (string, opsional)
• lookback_minutes (integer, opsional): Default: 60.
• service_name (string, opsional)
• env (string, opsional)
• event_name (string, opsional): Panggil tanpa ini terlebih dahulu untuk mendapatkan available_event_names.

get_alert_config

• search_term (string, opsional): Pencarian teks bebas di seluruh nama, grup, sumber data, dan tag.
• rule_name (string, opsional)
• severity (string, opsional)
• rule_type (string, opsional): static atau anomaly.
• alert_group_name / alert_group_type / data_source_name (string, opsional)
• tags (array, opsional): Semua harus cocok (logika AND).

get_alerts

• time_iso (string, opsional): Waktu evaluasi dalam RFC3339.
• window (integer, opsional): Jangka waktu mundur dalam detik. Default: 900. Rentang: 60–86400.
• lookback_minutes (integer, opsional): Rentang: 1–1440.

get_alert_rule_state

• start_time (integer, wajib): Awal rentang waktu Unix epoch (inklusif).
• end_time (integer, wajib): Akhir rentang waktu Unix epoch (inklusif).
• step (integer, wajib): Resolusi dalam detik antar sampel. Jumlah sampel ((end_time - start_time) / step + 1) dibatasi maksimal 100.
• alert_group_id (string, opsional): Filter berdasarkan ID grup alert.
• rule_name (string, opsional): Filter regex pada nama aturan.
• alert_group_name (string, opsional): Filter regex pada nama grup alert.
• label_filters (string, opsional): Filter label key=value yang dipisahkan koma.
• state (string, opsional): Filter berdasarkan status (mis. firing).

Mengembalikan peta JSON dari rule_id -> [{timestamp, is_firing}]. Stempel waktu saat suatu aturan tidak ada dalam respons upstream dilaporkan sebagai is_firing=0 — ini berarti "tidak teramati sedang aktif", bukan status normal yang terkonfirmasi.

get_notification_channels

Tidak ada parameter. Mengembalikan semua saluran notifikasi yang dikonfigurasi (Slack, PagerDuty, email, webhooks, dll.).

did_you_mean

• query (string, wajib): Nama yang dicari — sebagian, salah eja, atau disingkat.
• type (string, opsional): Batasi ke tipe entitas: service, environment, host, database, k8s_deployment, k8s_namespace, job.

Mengembalikan hingga 3 kecocokan terdekat dengan skor kemiripan. Gunakan ini sebelum pemanggilan tool apa pun saat nama entitas tidak pasti. Jika panggilan sebelumnya mengembalikan hasil kosong, coba ini sebelum mencoba ulang.

list_dashboards

Tidak ada parameter. Mengembalikan semua dashboard kustom dalam org sebagai array JSON dengan id, name, dan metadata.

get_dashboard

• id (string, wajib): UUID dashboard.
• region (string, opsional): Region untuk pengisian kueri panel. Defaultnya adalah region sumber data yang dikonfigurasi.

create_dashboard

• dashboard (object, wajib): Definisi dashboard dengan name dan panels[]. Setiap panel memerlukan name, version, layout (x, y, w, h), visualization.type, dan queries[].
• metadata (object, opsional): Metadata dashboard — field _category dan _type (mis. {"_category":"custom","_type":"metrics"}).

update_dashboard

• id (string, wajib): UUID dashboard yang akan diperbarui.
• dashboard (object, wajib): Badan dashboard pengganti lengkap (bentuk yang sama dengan create).
• metadata (object, opsional): Metadata pengganti. Dashboard sistem yang bersifat read-only mengembalikan error 403.

delete_dashboard

• id (string, wajib): UUID dashboard yang akan dihapus. Dashboard sistem yang bersifat read-only tidak dapat dihapus.

list_dashboard_snapshots

• dashboard_id (string, wajib): UUID dashboard yang snapshot-nya akan didaftar.

Mengembalikan metadata saja (id, name, expires_at, dll.). Gunakan get_dashboard_snapshot untuk data panel yang dibekukan.

get_dashboard_snapshot

• id (string, wajib): UUID snapshot.

Mengembalikan snapshot beku lengkap termasuk dashboard_definition, panel_data, time_range, dan variables.

delete_dashboard_snapshot

• id (string, wajib): UUID snapshot yang akan dihapus.