Connect / mcp

Coding agents over MCP

Connect Claude Code or any MCP client to read the model and propose changes.

Create a token

In your workspace, open Agents & MCP, name a token and choose Create token. Copy it now: it is shown once and stored only as a hash. Revoke it from the same page.

Connect Claude Code

claude mcp add --transport http arq https://<your Arq address>/api/mcp \
  --header "Authorization: Bearer <token>"

Other MCP clients connect to the same address over Streamable HTTP with the token as a bearer token.

Tools

arq_list_modelsModels in the workspace, with notation and element count
arq_searchFind elements by name, optionally of one kind
arq_get_contextThe context pack for a model: summary, text projection, interfaces and constraints
arq_validateCheck proposed operations against the metamodel without proposing them
arq_propose_changesetPropose changes with a summary and rationale; they wait in the model's Inbox for a person to accept
arq_check_modelWhole-model validation: errors, warnings and suggestions with the elements involved

Agents cannot change a model directly. Everything they propose is reviewed in the Inbox.