Skip to content

AI Agents

BlizzHacker edited this page Nov 17, 2026 · 1 revision

AI Agents

ROMarr includes an MCP server, so Claude, Codex, Hermes, Antigravity and other MCP clients can read your library and activity. Open Hub → AI Agents for a ready-to-copy connection example for your client.

Endpoint

https://YOUR-ROMARR/api/v1/mcp

It requires your ROMarr API key (Settings → General), sent as X-Api-Key or a bearer token. Use HTTPS or an SSH tunnel for connections from other machines.

What agents can do

  • Read-only by default: cached library, activity, history, platforms and counts.
  • A server owner can explicitly allow two writes: adding a Wanted entry and requesting a background library refresh.
  • The connector never runs shell commands, browses files, controls your desktop, or forwards arbitrary API calls.

Example: Claude Code

{
  "mcpServers": {
    "romarr": {
      "type": "http",
      "url": "https://YOUR-ROMARR/api/v1/mcp",
      "headers": { "X-Api-Key": "<YOUR_ROMARR_API_KEY>" }
    }
  }
}

A portable stdio bridge is available for clients that don't speak HTTP, such as Claude Desktop.

Full guide with Codex, Hermes and Antigravity examples: MCP.md.

Clone this wiki locally