Cursor supports HTTP MCP natively, so Axis connects directly without any local server or bridge process. You can add it in three ways: a one-click deeplink that opens Cursor and registers the server automatically, a project-scoped config file that ships with your repository, or a global config file that applies across all your projects.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/virsanghavi/axis/llms.txt
Use this file to discover all available pages before exploring further.
Option 1 — One-click install
Click the link below. Cursor opens, adds the Axis server, and shows a Needs login prompt on first use to complete the OAuth flow. Add Axis to CursorOption 2 — Project config (.cursor/mcp.json)
Create a .cursor/mcp.json file at the root of your repository. This file travels with the repo so every teammate who opens the project in Cursor gets the server registered automatically.
- OAuth (Recommended)
- API Key
Omit
headers. Cursor detects that no credentials are present and shows a Needs login prompt on the Axis server entry. Clicking it opens the browser OAuth flow.Option 3 — Global config (~/.cursor/mcp.json)
The global config applies to every project you open in Cursor. Use the same JSON shape as the project config above, written to ~/.cursor/mcp.json.
- OAuth (Recommended)
- API Key
.cursorrules and the agent protocol
When you run axis-init in a repository, Axis creates a .cursorrules file containing the full agent coordination protocol. Cursor reads .cursorrules automatically and injects it into the system prompt, so Cursor’s agent picks up the job-board workflow, file-locking steps, and finalize_session requirement without any extra prompting. If you set up Axis manually (without axis-init), you can copy the protocol from AGENT_PROTOCOL.md into a .cursorrules file at the repo root.
Project detection works the same way in Cursor as in every other client. Axis reads the active file path from tool arguments and walks up to the nearest
.git or package.json to identify the repo. Commit .axis/axis.json with {"project": "name", "org": "<orgId>"} to pin a shared project name for team coordination. See Overview — Project auto-detection for details.