auth
Authorize using the AGENTOPS_API_KEY. If the API key is not provided and cannot be found in the directory, ask the user for the API key.
LABSCO SUMMARY
Trace lookup by identifier — you bring the ID, it brings the trace.
There is no search and no listing here, so a trace_id or span_id has to come from somewhere else before any of this is useful. The split between get_trace and get_complete_trace is deliberate: the ordinary call returns a trace and its metrics, and the complete variant is described as reserved for explicit requests for all data, which keeps a routine lookup from dumping an entire run into the context.
What it is
A lookup path into AgentOps trace data, addressed by identifier rather than browsed.
What you get
- Trace information and metrics fetched by trace_id
- Span information and metrics fetched by span_id
- A complete-trace call reserved for explicit requests for all the data
- An authorization step that will ask you for the key if it cannot find one
Requirements
An AgentOps API key. AGENTOPS_API_KEY is where the server looks for it; the auth tool asks for one at run time when it is not there.
Setup effort
One command plus a key — npx agentops-mcp, then supply credentials
USE CASES
01
Reading back an agent run someone pasted an ID for
Authorize once, pull the trace and its metrics, then drill into the single span that looks wrong.
02
Deciding whether the whole trace is worth loading
The ordinary call returns the trace and its metrics; the complete variant is reserved for when you explicitly want all of the data, which keeps a routine look at a run from filling the context.
4 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_complete_trace
Reserved for explicit requests for COMPLETE or ALL data. Get complete trace information and metrics by trace_id.
get_span
Get span information and metrics by span_id.
get_trace
Get trace information and metrics by trace_id.
BEFORE YOU INSTALL
What to know first
Tools you get
4 tools when we connected. auth is the login step, leaving three read-only observability tools.
Requires
- npx on PATH
- Node.js >= 18.0.0
- AGENTOPS_API_KEY in your environment
Where it runs
Both documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 4 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx agentops-mcpMCP Clients
Claude Desktop, Cursor
JSON
{
"mcpServers": {
"agentops-mcp": {
"command": "npx",
"args": [
"agentops-mcp"
],
"env": {
"AGENTOPS_API_KEY": ""
}
}
}
}
