Axiomry LogoAxiomry
Documentation
Back to MCP Integration

Windsurf Integration

Connect Windsurf 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 Windsurf 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 Windsurf

MCP Configuration

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

Config file location

macOS / Linux: ~/.codeium/windsurf/mcp_config.json

Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

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

Installation Steps

  1. To open the config from inside Windsurf, click the MCPs icon in the top-right of the Cascade panel, then "Configure" (the MCP Marketplace there also offers one-click installs).
  2. Or open/create the config file directly at the path shown above (~/.codeium/windsurf/mcp_config.json).
  3. Merge the config below into the mcpServers section. Windsurf uses serverUrl (not url) for remote servers.
  4. Replace the Bearer token in headers.Authorization with your Axiomry access token.
  5. Save the file, then fully quit Windsurf and reopen it — a window reload does not reload MCP servers.

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

Example AI Conversations

Try these natural language commands with Windsurf'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 →