> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentops.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> MCP server for accessing AgentOps trace and span data

<iframe width="100%" height="300" src="https://www.youtube.com/embed/lTa3Sk8C4f0?si=3r7GO8N1Csh0P9C5RR" title="AgentOps MCP Server" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

# MCP Server

AgentOps provides a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that exposes the Public API as a set of tools for AI assistants. This allows AI models to directly query your AgentOps data during conversations and debug AI agents with greater context.

### Configuration & Installation

Add the AgentOps MCP to your MCP client's configuration file.

**npx configuration:**

```json theme={null}
{
  "mcpServers": {
    "agentops": {
      "command": "npx",
      "args": [
        "agentops-mcp"
      ],
      "env": {
        "AGENTOPS_API_KEY": ""
      }
    }
  }
}
```

**Cursor Deeplink:**

Add the AgentOps MCP to Cursor with Deeplink.

[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=agentops\&config=eyJjb21tYW5kIjoibnB4IGFnZW50b3BzLW1jcCIsImVudiI6eyJBR0VOVE9QU19BUElfS0VZIjoiIn19)

**Smithery:**

To install agentops-mcp for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@AgentOps-AI/agentops-mcp):

```bash theme={null}
npx -y @smithery/cli install @AgentOps-AI/agentops-mcp --client claude
```

### Available Tools

The MCP server exposes the following tools that mirror the Public API endpoints:

#### `auth`

Authorize using an AgentOps project API key.

* **Parameters**: `api_key` (string) - Your AgentOps project API key
* **Usage**: The server will automatically prompt for authentication when needed

#### `get_trace`

Get trace information by ID.

* **Parameters**: `trace_id` (string) - The trace identifier
* **Returns**: Trace details and metrics

#### `get_span`

Get span information by ID.

* **Parameters**: `span_id` (string) - The span identifier
* **Returns**: Span attributes and metrics

#### `get_complete_trace`

Get complete trace information by ID.

* **Parameters**: `span_id` (string) - The trace identifier
* **Returns**: Complete trace and associated span details.

### Environment Variables

The MCP server supports the following environment variables:

* `AGENTOPS_API_KEY`: Your AgentOps project API key
* `HOST`: API endpoint (defaults to `https://api.agentops.ai`)