Agent docs

MCP

Run the local stdio server from any MCP-compatible agent.

Configure the server

The package is a local stdio MCP server. Put the show token in the environment that starts your agent, then add this server entry to the client's MCP configuration.

{
  "mcpServers": {
    "audioreality": {
      "command": "npx",
      "args": ["-y", "@audioreality/mcp"],
      "env": {
        "AUDIOREALITY_TOKEN": "${AUDIOREALITY_TOKEN}",
        "AUDIOREALITY_INCLUDE_DETAILS": "false"
      }
    }
  }
}

Tools

submit_reportFile one outcome after long-running or scheduled work completes.

submit_reportsFile a batch of up to 100 outcomes.

get_show_statusRead delivery timing, latest episode metadata, and queue counts.

render_nowRender the current queue as a Brief when the human asks.

Use needs_decision only when work is blocked on a human choice or approval. Reuse the same run_id when reporting the eventual resolution.

Environment

AUDIOREALITY_TOKEN selects the default show.
AUDIOREALITY_TOKENS=work=ar_show_...,personal=ar_show_... enables the optional show tool argument.
AUDIOREALITY_API_URL overrides the public API base URL.
AUDIOREALITY_INCLUDE_DETAILS defaults to false; details are discarded locally unless it is explicitly true.