Annie Remote MCP

Annie Remote MCP lets your AI coding assistant ask Annie about your production context, generate reports and run investigations over HTTP with OAuth authentication. No local server or API token is required. Your client handles browser-based login.

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 instead.

Setup

Reuse an existing Annie connection if you already have one. Otherwise, choose one setup method below.

Codex

codex mcp add annie --url https://api.anyshift.io/mcp/remote
codex mcp login annie

Sign in to Anyshift in the browser, then ask Codex to use Annie’s list_projects to confirm the intended project before starting an investigation.

One-command install

Install across all your editors at once using add-mcp:

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):

{
  "mcpServers": {
    "annie": {
      "type": "http",
      "url": "https://api.anyshift.io/mcp/remote"
    }
  }
}

First Use

If you have not authenticated yet, start login from your client’s MCP settings or first tool call. In Codex, use codex mcp login annie.

Log in with your Anyshift account
If you see Finish connecting your MCP client and the client runs on this computer, select Continue on this computer. Hosted clients connect automatically.
Your editor stores the credentials for subsequent tool calls.

Before reading data or starting an investigation, use list_projects to confirm the intended project. Reuse an existing connection rather than installing it again. For a complete task example, see Investigate a deployment alert.

Authenticate over SSH

When Claude Code runs on an SSH host, you can finish authentication from your local browser without forwarding a port:

Start authentication from Claude Code’s /mcp menu on the SSH host and open its authorization link in your browser.
Sign in to Anyshift. On Finish connecting your MCP client, select Copy callback URL.
Paste the full URL into Claude Code’s URL > prompt on the SSH host and submit it. Do not paste only the code, or open the callback URL in your local browser.
Close the browser tab once Claude Code confirms it is connected.

If copying is blocked, select and copy the URL manually. The URL is temporary: use it promptly, do not share it, and restart authentication from the client if it expires. Other remote clients need support for pasting a callback URL. Continue on this computer is for clients running on the same computer as your browser.

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`	Retrieve the current status or completed answer for an existing investigation.
`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, install the Annie Skills plugin 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. This is separate from the Plugin, which packages Graph MCP and a portable production-evidence workflow for compatible agent clients.

Example Prompts

Use Annie to investigate the spike in 5xx errors on the payments service

Ask Annie what changed in our infrastructure in the last 24 hours

Ask Annie to trace the dependency chain for the prod RDS instance

Ask Annie why the Lambda function can't connect to the database

Annie typically takes 30 seconds to a few minutes depending on the complexity of the question. The calling agent must retrieve the result with get_annie_response; automatic polling depends on the client.

Managing Access

You can view and revoke authorized MCP connections from your profile page under Authorized Apps.

Troubleshooting

Re-authenticate

If your session expires, reset the connection and try again:

# Claude Code
claude mcp reset annie

Your next Annie tool call will re-open the browser for login.

Browser doesn't open during auth

Make sure your default browser is set in your OS settings. For remote or SSH sessions, follow Authenticate over SSH.

Timeout waiting for response

Check the existing investigation with get_annie_response. If it is still running, continue polling that run; if it failed, report the failure. Do not start another investigation just because the first response was not final.

Get Started

Product

Manage

Setup

Codex

One-command install

Manual configuration

First Use

Authenticate over SSH

Available Tools

Asking Annie

Custom Reports

Feedback

Pre-built skills for Claude Code

Example Prompts

Managing Access

Troubleshooting

​Setup

​Codex

​One-command install

​Manual configuration

​First Use

​Authenticate over SSH

​Available Tools

​Asking Annie

​Custom Reports

​Feedback

​Pre-built skills for Claude Code

​Example Prompts

​Managing Access

​Troubleshooting

Setup

Codex

One-command install

Manual configuration

First Use

Authenticate over SSH

Available Tools

Asking Annie

Custom Reports

Feedback

Pre-built skills for Claude Code

Example Prompts

Managing Access

Troubleshooting