Skip to main content

Connecting A11yNow MCP to AI assistants

A11yNow MCP can be connected to AI assistants that supports the Model Context Protocol (MCP). The setup depends on the AI assistant you are using.

Set up your MCP Client​

Choose the AI assistants you want to use and follow the instructions:

Codex CLI​

  1. Open the Codex configuration file Edit:
~/.codex/config.toml:
  1. Add A11yNow MCP
[mcp_servers.a11ynow]
command = "a11ynowmcp"

Alternatively, run A11yNow MCP using npx:

# npx form: command = "npx"
# args = ["-y", "a11ynowmcp"]
# from source: command = "node"
# args = ["/ABSOLUTE/PATH/a11y-mcp-server/dist/index.js"]

Claude Code​

Add A11yNow MCP using the Claude Code CLI:

# registry install
claude mcp add a11ynow -- a11ynowmcp

# no install
claude mcp add a11ynow -- npx -y a11ynowmcp

# from source
claude mcp add a11ynow -- node /ABSOLUTE/PATH/a11y-mcp-server/dist/index.js

Claude Desktop​

  1. Open the configuration file

    • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. Add the configuration:

{
  "mcpServers": {
    "a11ynow": {
      "command": "a11ynowmcp"
    }
  }
}
  1. Save the file and restart Claude Desktop.

Cursor​

Add A11yNow MCP using the following configuration:

{
  "mcpServers": {
    "a11ynow": {
      "command": "a11ynowmcp"
    }
  }
}

Save the configurations and reload Cursor if necessary.

GitHub Copilot​

  1. Open the MCP confirmation file .vscode/mcp.json
  2. Add A11yNow MCP
{
  "servers": {
    "a11ynow": {
      "type": "stdio",
      "command": "a11ynowmcp"
    }
  }
}

Save the configuration and check the MCP server status in VS code.

Windsurf​

Use the following MCP server configuration:

{
  "mcpServers": {
    "a11ynow": {
      "command": "a11ynowmcp"
    }
  }
}

Save the configuration and reload Windsurf if necessary.

OpenCode​

  1. Project configuration
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "a11ynow": {
      "type": "local",
      "command": ["a11ynowmcp"],
      "enabled": true
    }
  }
}