Skip to main content

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.

The remote MCP server lets AI coding assistants connect to Annie over HTTP with OAuth authentication. No local dependencies, no API tokens to manage — your editor handles login automatically.
The remote server gives you the full Annie experience: infrastructure investigation, log analysis, incident debugging, and more. It replaces the need for a locally running MCP server.

​
Setup

​
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

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

ToolDescription
ask_annieAsk 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_responsePoll for Annie’s answer (called automatically by your editor)
list_projectsList your Anyshift projects
set_projectSwitch 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.
ToolDescription
save_report_definitionSave a report-shaped answer as a named definition
list_report_definitionsList the report definitions in the active project
list_report_instancesList past runs of a specific definition
get_report_instanceFetch a generated report as markdown or JSON
generate_reportTrigger 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.
ToolDescription
submit_answer_feedbackThumbs up or down on a chat or RCA answer
submit_hypothesis_feedbackThumbs up or down on a single hypothesis inside an RCA. The rating reaches the agent as a live update.

​
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. Your editor will poll automatically until the answer is ready.

​
Managing Access

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

​
Troubleshooting

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