Setup in Cursor

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard
Not for use with personal data

Axe MCP server can be added at either the project or global level.

Choose scope

  • Project-level: Create a file at .cursor/mcp.json in your project's root directory
  • Global-level: Open Cursor settings, go to Features > MCP, and click Add New MCP Server. This will open your global configuration file.

Adding configuration JSON

Add the following configuration JSON.

info

If you already have other servers defined, add the axe-mcp-server block inside the existing mcpServers object.

{
  "mcpServers": {
    "axe-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--add-host=host.docker.internal:host-gateway",
        "-i",
        "--rm",
        "-e",
        "AXE_SERVER_URL",
        "-e",
        "AXE_API_KEY",
        "dequesystems/axe-mcp-server:latest"
      ],
      "env": {
        "AXE_API_KEY": "${env:AXE_API_KEY}"
      }
    }
  }
}
note

The configuration uses "AXE_API_KEY": "${env:AXE_API_KEY}" for secure input handling. The ${env:AXE_API_KEY} syntax instructs Cursor to pull the value from your system variables. For more information, see the Cursor MCP documentation.

Usage and verification

Once added, the status indicator in Cursor Settings should show that the server is running:

  1. Open Cursor Settings
  2. Go to Features > MCP
  3. You should see axe-mcp-server listed under Installed MCP Servers with the analyze and remediate tools available.