Agent MCP Server — KryptosAI/agent-observability

Trace AI agent execution: every tool call, every error, every dollar. Open source, local-first.

Local serverstdio

What is the Agent MCP Server?

Trace AI agent execution: every tool call, every error, every dollar. Open source, local-first.

What it actually does

This auto-detects your AI agent (opencode, Claude Code, Cursor) and configures everything: - Adds agent-obs to your MCP config - Adds the self-reporting instruction - Tells you what to do next

  • You can't estimate costs. — A session that feels quick might have burned $5 in API calls. A session that felt slow might have cost $0.50. You're operating blind
  • You can't debug failures. — The agent produced broken code — was it because it read the wrong file? Used a deprecated API? Misunderstood the task? Without traces, you're guessing
  • You can't improve your prompts. — Is the agent reading too many files? Calling too many tools? Wasting tokens on irrelevant context? You need data to tune your system instructions
  • You can't audit access. — If an agent reads a file containing secrets or API keys, you should know about it. If it makes an unexpected network call, you need to see it

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
obs_record_tool_callsessionId, toolName, serverName, duration (ms), status (success/error), input, output
obs_record_token_usagesessionId, inputTokens, outputTokens, model
obs_record_decisionsessionId, context, options, chosen, reasoning
obs_record_gradesessionId, grade (A/B/C/D/F), reasoning
obs_get_session_reportsessionId
obs_list_sessionslimit, offset

How to install the Agent MCP Server

claude mcp add agent-observability -- npx -y agent-obs

Example prompts to try

  • “Use Agent to obs record tool call.”
  • “Use Agent to obs record token usage.”
  • “Use Agent to obs record decision.”

Frequently asked questions

Trace AI agent execution: every tool call, every error, every dollar. Open source, local-first. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.