Command Palette

Search for a command to run...

UnylyUnyly
Весь каталог

Kalmia Plugin

БесплатноНе проверен

Kalmia for coding agents: the Kalmia MCP server and the skill that sets up Kalmia tracing in a codebase.

GitHubEmbed

Описание

Kalmia for coding agents: the Kalmia MCP server and the skill that sets up Kalmia tracing in a codebase.

README

Kalmia traces your AI agents and finds what went wrong. It triages every run, investigates failures down to the root cause, and alerts you.

This repository connects Kalmia to your coding agent. It contains two things:

  • The Kalmia MCP server. Your agent can query traces, read root-cause verdicts and grouped issues, compare variants and eval runs, and start investigations and sweeps.
  • The kalmia-setup skill. Your agent adds Kalmia tracing to a codebase: it installs the SDK, wraps the LLM client, groups runs into traces, checks that a trace arrived, and sets up issue digests.

Kalmia works with OpenTelemetry, the Vercel AI SDK, the OpenAI and Anthropic SDKs, and plain HTTP.

Before you start

You need a Kalmia API key. Sign up free, then create a read-and-write key under Settings > API keys. It starts with kal_live_.

Install

Claude Code

/plugin marketplace add KalmiaAI/kalmia-plugin
/plugin install kalmia@kalmia

Claude Code asks for your API key when the plugin is enabled. The setup skill is then available as /kalmia:kalmia-setup.

To add only the MCP server, without the plugin:

claude mcp add --transport http kalmia https://www.kalmia.dev/api/mcp \
  --header "Authorization: Bearer $KALMIA_API_KEY"

Cursor

Add this to .cursor/mcp.json in your project, or to ~/.cursor/mcp.json for every project, and set KALMIA_API_KEY in your environment:

{
  "mcpServers": {
    "kalmia": {
      "url": "https://www.kalmia.dev/api/mcp",
      "headers": { "Authorization": "Bearer ${env:KALMIA_API_KEY}" }
    }
  }
}

Any agent that supports skills

npx skills add KalmiaAI/kalmia-plugin

Any other MCP client

  • URL: https://www.kalmia.dev/api/mcp
  • Transport: streamable HTTP
  • Header: Authorization: Bearer <your API key>

What the MCP server can do

Group Tools
Read your traces query_traces, aggregate_traces, compare_metrics, get_trace, search_trace_content, get_span_detail, get_monitoring_settings
Read what Kalmia found get_verdict, list_anomaly_findings, list_issues, get_issue, compare_variants, list_recent_runs, get_run_results, get_case_diagnosis, compare_runs
Take action (each asks for your approval) analyze_trace, investigate_trace, annotate_trace, run_sweep, configure_monitoring, connect_slack, connect_teams

Some actions use credits from your plan. See pricing.

Where your data goes

Everything goes to Kalmia's own service at www.kalmia.dev, and nowhere else.

  • The MCP server sends your agent's requests to https://www.kalmia.dev/api/mcp, with your API key. It reads traces already stored in your Kalmia workspace. The action tools write back to that workspace: labels, investigations, and monitoring settings.
  • The kalmia-setup skill changes your codebase so your app sends its traces to Kalmia (https://www.kalmia.dev/api/v1/traces/ingest, or https://www.kalmia.dev/api/otel/v1/traces for OpenTelemetry). It sends one test request to check that a trace arrived. It installs the Kalmia SDK from npm or PyPI.
  • Digests, if you turn them on, go to the email, Slack or Microsoft Teams destination you choose.

Traces can contain whatever your agent handled, including personal data. Kalmia keeps them for your workspace's retention period. See the privacy policy.

Things to try

  • "Set up Kalmia tracing in this repo."
  • "What are the most common issues in my agent's traces this week?"
  • "Why did trace <id> fail? Show me the root cause and the suggested fix."
  • "Compare failure rates between my two prompt variants."

Links

License

MIT. See LICENSE.

from github.com/KalmiaAI/kalmia-plugin

Установка Kalmia Plugin

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/KalmiaAI/kalmia-plugin

FAQ

Kalmia Plugin MCP бесплатный?

Да, Kalmia Plugin MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для Kalmia Plugin?

Нет, Kalmia Plugin работает без API-ключей и переменных окружения.

Kalmia Plugin — hosted или self-hosted?

Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.

Как установить Kalmia Plugin в Claude Desktop, Claude Code или Cursor?

Открой Kalmia Plugin на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Похожие MCP

Compare Kalmia Plugin with

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории development