Connect Claude and other AI assistants

Amiril runs an MCP server, so an AI assistant can work in your workspace for you. It can find the runs that stood out, read their traces, build a dashboard from a sentence and write a rule as text. You add one address to your assistant and sign in once.

Server address

https://api.amiril.ai/mcp
https://api.amiril.ai/mcp/readonly

Add it to your assistant

Run this in a terminal. Then type /mcp in Claude Code and choose Amiril to sign in.

claude mcp add --transport http amiril https://api.amiril.ai/mcp

What the assistant can do

  • Read anomalies, traces, agents and rules in the workspace you sign in to.
  • Build dashboards and Agent Systems, and give you a link to each one.
  • Write rules as text, test them on past runs and save them in shadow mode.
  • Upload trace files and review anomalies.

It acts as you, with your role. API keys, members, invitations and workspace settings stay in the web app.

Signing in

The first time your assistant connects, it opens the Amiril sign-in page. Sign in with your Amiril account. If you belong to more than one workspace, the assistant works in the one you choose there. To switch, remove the connection from your assistant and add it again.

The assistant acts as you. A member can read and review, and an admin can also publish rules and change agents. Anything it does is recorded under your name.

Uploading trace files

Ask the assistant to import a Langfuse export or an Amiril JSONL file. It gets an upload address from Amiril and sends the file there with curl, so the file never passes through the conversation. Files can be up to 2 GiB.

Claude Code and Cursor upload from your terminal. In Claude on the web or desktop, allow storage.googleapis.com in Settings under Capabilities first.

Trace data and safety

Traces can hold text written by your own users. Amiril marks that text as data when it hands it to your assistant, and tells the assistant never to follow instructions found in it. Tools that change live agents, such as publishing a rule or turning enforcement on, are marked so your assistant asks you first.

If the assistant should only look, use the read-only address. It offers no tools that change anything.