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

# Connect your agent

> Use the AgentCat MCP server from Cursor, Claude, VS Code, and more.

The AgentCat MCP server lets you query your usage analytics and debug issues directly from your coding agent. It runs at:

```
https://mcp.agentcat.com/mcp
```

Authentication uses OAuth — **you never copy an API key**. The first time your client connects, it opens a browser to sign in to your AgentCat account, then caches the token.

## Claude Code

```bash theme={null}
claude mcp add --transport http agentcat https://mcp.agentcat.com/mcp
```

Run `/mcp` inside a session to complete the browser sign-in.

## Claude Desktop

Open **Settings → Connectors → Add custom connector**, paste `https://mcp.agentcat.com/mcp`, and sign in. The same custom-connector flow works across Claude's desktop apps (Claude Desktop and Cowork) — remote servers are supported directly, no proxy needed.

## Codex

```bash theme={null}
codex mcp add agentcat --url https://mcp.agentcat.com/mcp
```

## Cursor

[Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=agentcat\&config=eyJ1cmwiOiJodHRwczovL21jcC5hZ2VudGNhdC5jb20vbWNwIn0=) — or add manually to `~/.cursor/mcp.json`:

```json theme={null}
{ "mcpServers": { "agentcat": { "url": "https://mcp.agentcat.com/mcp" } } }
```

## VS Code

Add to `.vscode/mcp.json` (or run `code --add-mcp '{"name":"agentcat","type":"http","url":"https://mcp.agentcat.com/mcp"}'`):

```json theme={null}
{
  "servers": {
    "agentcat": { "type": "http", "url": "https://mcp.agentcat.com/mcp" }
  }
}
```

## Windsurf

Add to `~/.codeium/windsurf/mcp_config.json`:

```json theme={null}
{ "mcpServers": { "agentcat": { "serverUrl": "https://mcp.agentcat.com/mcp" } } }
```

## Other clients

Most clients accept the standard config:

```json theme={null}
{
  "mcpServers": {
    "agentcat": { "type": "http", "url": "https://mcp.agentcat.com/mcp" }
  }
}
```

## Tools available

`list_projects`, `get_project_overview`, `search_sessions`, `get_session`, `search_issues`, `get_issue`, `get_metric_trend`, `get_metric_breakdown`, `list_skills`, `load_skill`.

## Example prompts

* "What are my top tools in the last 7 days?"
* "Investigate issue PROJ-42."
* "Summarize session ses\_abc123 and tell me why it errored."