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

# Annie Remote MCP

> Run Annie investigations from an AI coding assistant.

Annie Remote MCP lets AI coding assistants run Annie investigations over HTTP with OAuth authentication. No local dependencies or API tokens are required. Your editor handles login automatically.

<Note>
  Use Annie Remote MCP when you want the AI SRE agent to investigate infrastructure, analyze logs, debug incidents, and produce recommendations. If your agent needs fast, deterministic production graph evidence while it performs another task, use [Graph MCP](/pages/product/integration/graph_mcp) instead.
</Note>

## Setup

### One-command install

Install across all your editors at once using [add-mcp](https://github.com/neondatabase/add-mcp):

```bash theme={null}
npx add-mcp https://api.anyshift.io/mcp/remote -n annie -g
```

This auto-detects your installed editors (Claude Code, Cursor, Windsurf, VS Code, Claude Desktop, etc.) and configures them all.

### Manual configuration

Add to your editor's MCP config file (e.g. `.cursor/mcp.json`, `~/.claude.json`, `claude_desktop_config.json`):

```json theme={null}
{
  "mcpServers": {
    "annie": {
      "type": "http",
      "url": "https://api.anyshift.io/mcp/remote"
    }
  }
}
```

## First Use

On your first Annie tool call, your editor will open a browser window:

1. Log in with your Anyshift account
2. The connection is established automatically
3. No tokens to copy — your editor stores the credentials

That's it. All subsequent tool calls are authenticated automatically.

## Available Tools

### Asking Annie

| Tool                 | Description                                                                                                                                                                                                                              |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ask_annie`          | Ask a question about your cloud infrastructure. Pass `mode="rca"` to run a multi-step root-cause investigation instead of a chat. Pass `hint="report"` to format the answer as report blocks, or `hint="diagram"` for a Mermaid diagram. |
| `get_annie_response` | Poll for Annie's answer (called automatically by your editor)                                                                                                                                                                            |
| `list_projects`      | List your Anyshift projects                                                                                                                                                                                                              |
| `set_project`        | Switch the active project for queries                                                                                                                                                                                                    |

### Custom Reports

After an `ask_annie` call with `hint="report"`, you can save the answer as a reusable report definition and re-run it later.

| Tool                      | Description                                                                                  |
| ------------------------- | -------------------------------------------------------------------------------------------- |
| `save_report_definition`  | Save a report-shaped answer as a named definition                                            |
| `list_report_definitions` | List the report definitions in the active project                                            |
| `list_report_instances`   | List past runs of a specific definition                                                      |
| `get_report_instance`     | Fetch a generated report as markdown or JSON                                                 |
| `generate_report`         | Trigger a fresh run of a definition. The backend dedupes if a generation is already pending. |

### Feedback

Ratings flow back into Annie so future investigations can take your judgment into account.

| Tool                         | Description                                                                                            |
| ---------------------------- | ------------------------------------------------------------------------------------------------------ |
| `submit_answer_feedback`     | Thumbs up or down on a chat or RCA answer                                                              |
| `submit_hypothesis_feedback` | Thumbs up or down on a single hypothesis inside an RCA. The rating reaches the agent as a live update. |

## Pre-built skills for Claude Code

If your agent runs in [Claude Code](https://docs.anthropic.com/en/docs/claude-code), install the [Annie Skills plugin](/pages/product/integration/skills) to skip the prompt-engineering work. The plugin ships ready-made skills that teach Claude Code when to call which MCP tool, how to chain calls, and how to recover from auth or staleness failures. Source: [`anyshift-io/annie-skills`](https://github.com/anyshift-io/annie-skills).

This is separate from [Production Intelligence for AI Agents](/pages/product/integration/production_intelligence_agent_plugin), which packages Graph MCP and a portable production-evidence workflow for compatible agent clients.

## Example Prompts

```text theme={null}
Use Annie to investigate the spike in 5xx errors on the payments service
```

```text theme={null}
Ask Annie what changed in our infrastructure in the last 24 hours
```

```text theme={null}
Ask Annie to trace the dependency chain for the prod RDS instance
```

```text theme={null}
Ask Annie why the Lambda function can't connect to the database
```

<Tip>
  Annie typically takes 30 seconds to a few minutes depending on the complexity of the question. Your editor will poll automatically until the answer is ready.
</Tip>

## Managing Access

You can view and revoke authorized MCP connections from your [profile page](https://app.anyshift.io/my-profile) under **Authorized Apps**.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Re-authenticate">
    If your session expires, reset the connection and try again:

    ```bash theme={null}
    # Claude Code
    claude mcp reset annie
    ```

    Your next Annie tool call will re-open the browser for login.
  </Accordion>

  <Accordion title="Browser doesn't open during auth">
    Make sure your default browser is set in your OS settings. If using a remote/SSH session, you may need to use the local stdio server instead.
  </Accordion>

  <Accordion title="Timeout waiting for response">
    This is normal — Annie is still working. The `get_annie_response` tool is called automatically by your editor until the answer is ready. Complex investigations can take a few minutes.
  </Accordion>
</AccordionGroup>