quickstart

connect in 60 seconds — no api key

axis is the control plane for parallel agent workflows — distributed shared memory, file locking, and a job board so multiple agents collaborate on one project without stepping on each other. it runs as a hosted mcp server: connect by url and log in through the browser. nothing to install, nothing to update.

step 1: create an account

sign up at useaxis.dev. that's all you need for the one-click flow below — no api key to copy.

step 2: add the server (no secret in the command)

point your mcp client at the hosted url. in claude code:

bash
claude mcp add --scope project --transport http axis https://useaxis.dev/api/mcp

step 3: authenticate

run /mcp, select axis, and click authenticate — you'll log in once in the browser (oauth). your client stores the token for you.

bash
claude /mcp     # → axis → Authenticate

step 4: index your codebase

populate the search index so search_codebase and deep_search can find your code. one command — incremental and content-hashed, so re-running after edits is near-instant:

bash
AXIS_API_KEY=sk_sc_your_key npx @virsanghavi/axis-server index

agents can also keep it fresh themselves by calling the index_codebase tool after editing files.

step 5: verify

ask your agent to call search_codebase (e.g. "where is auth handled?"). if it returns ranked results with file:line, you're live.

prefer an api key (or your client doesn't do oauth)? grab one from your dashboard (keys start with sk_sc_) and see the mcp config tab for the header-based and local-install options.