Documentation

VS Code + GitHub Copilot Integration

Connect VS Code with GitHub Copilot 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 VS Code 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 VS Code

MCP Configuration

Add the following to your VS Code + GitHub Copilot MCP config file, then replace YOUR_API_KEY_HERE with your access token. Create Access Token.

Config file location

macOS / Linux: .vscode/mcp.json (workspace) — or run "MCP: Open User Configuration"

Windows: .vscode\mcp.json (workspace) — or run "MCP: Open User Configuration"

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

Installation Steps

Make sure GitHub Copilot is set up in VS Code (MCP support is built in — no separate MCP extension is needed).
Quickest: open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server", then follow the prompts.
Or for manual setup, run "MCP: Open User Configuration" for a global file, or create .vscode/mcp.json in your workspace.
Merge the config below into that file. Note the top-level key is "servers" (this differs from other editors).
Replace the Bearer token in headers.Authorization with your Axiomry access token.
Save the file — VS Code shows a "Start" action above the server entry — then start it.

Save the file and restart VS Code + GitHub Copilot. The Axiomry tools will then be available to your AI assistant.

Example AI Conversations

Try these natural language commands with VS Code with GitHub Copilot or other AI extensions 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 →