Documentation

Cursor IDE Integration

Connect Cursor to Axiomry using Model Context Protocol for seamless AI-powered task management

Security Notice

Only connect to your development/staging Axiomry instances. Never use production access tokens with AI tools. Always review AI-generated changes before applying.

Quick Start

Get up and running with Axiomry MCP integration in Cursor in 2 simple steps.

1. Create Access Token

Go to Settings → MCP Server Access in your Axiomry dashboard and create a new access token

2. Configure Your Code Editor

Follow the configuration instructions below to set up MCP in Cursor

MCP Configuration

Add the following to your Cursor MCP config file, then replace YOUR_API_KEY_HERE with your access token. Create Access Token.

Config file location

macOS / Linux: ~/.cursor/mcp.json (or .cursor/mcp.json in project root)

Windows: %USERPROFILE%\.cursor\mcp.json (or .cursor\mcp.json in project root)

{
  "mcpServers": {
    "axiomry": {
      "url": "https://axiomry.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Installation Steps

Click the "Install in Cursor" button above for one-click installation (recommended).
Or via the UI: Cursor → Settings → Tools & MCP → New MCP Server.
Or manually: open (or create) the MCP config file at the path shown above — globally at ~/.cursor/mcp.json, or per-project at .cursor/mcp.json. This is a dedicated MCP file, not Cursor’s general settings.json.
Merge the config below into that file, keeping any servers you already have.
Replace the Bearer token in headers.Authorization with your Axiomry access token.
Save the file and restart Cursor.

Save the file and restart Cursor. The Axiomry tools will then be available to your AI assistant.

Example AI Conversations

Try these natural language commands with Cursor's AI assistant to manage your Axiomry tasks.

Task Management

"What projects do I have in Axiomry?"

Shows all your projects with current status

"Show me available tasks I can work on project X"

Lists unblocked tasks ready to begin for a specific project

"Create a new task for implementing feature X"

Creates a new task in your project

Project Operations

"Mark the database migration task as complete"

Updates task status and unblocks dependent tasks

"What's the current status of my project?"

Shows project overview with task completion status

"Show me tasks that are blocked by others"

Lists tasks waiting for dependencies to complete

Next Steps

Explore Available Tools

Discover all the MCP tools available in Axiomry and learn how to use them effectively.

View Supported Tools →