mtc-gooda11y-mcp API

Comprehensive accessibility analysis API with 8 powerful tools.

Part of the gooda11y.de accessibility toolkit.

About the MCP Server

This server implements the Model Context Protocol (MCP), enabling AI assistants like Claude, ChatGPT, and Cursor to perform real-time accessibility analysis on code and websites. The server provides both direct API access and MCP protocol integration.

IDE Integration

Connect this MCP server to your IDE or AI assistant:

Cursor IDE

Add to your mcp-config.json:

{
  "mcpServers": {
    "mtc-gooda11y-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.gooda11y.de/mcp", "--header", "X-API-Key:YOUR_API_KEY"]
    }
  }
}

Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "accessibility-checker": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.gooda11y.de/mcp", "--header", "X-API-Key:YOUR_API_KEY"]
    }
  }
}

Custom Integration

MCP endpoint: https://mcp.gooda11y.de/mcp
API key: gda_your_api_key_here (get from gooda11y.de account settings)

For local development: http://localhost:3009/mcp

API Authentication

Include your API key in the X-API-Key header or as Authorization: Bearer YOUR_API_KEY

Supported API Key Formats:

Available Endpoints

Authentication Endpoints

POST /api/auth/validate-api-key

Validate a gooda11y API key

{"apiKey": "gda_your_api_key_here"}
GET /api/user/by-api-key

Get user and organization data using API key authentication

Headers: Authorization: Bearer gda_your_api_key_here

Accessibility Analysis Endpoints

POST /api/check-html

Analyze HTML/JSX/TSX code for accessibility issues

{"code": "<img src='test.jpg'>", "fileType": "html"}
POST /api/check-patterns

Check code for framework-specific accessibility patterns

{"code": "<div onclick='...'>", "framework": "svelte"}
POST /api/validate-aria

Validate ARIA attributes and usage

{"code": "<div role='button' aria-invalid='maybe'>"}
POST /api/check-contrast

Analyze color contrast ratios for WCAG compliance

{"foreground": "#333", "background": "#fff", "fontSize": 16}
POST /api/analyze-structure

Analyze semantic HTML structure and heading hierarchy

{"html": "<h1>Title</h1><h3>Subtitle</h3>"}
POST /api/suggest-improvements

Get accessibility improvement suggestions

{"code": "your code", "fileType": "svelte"}
POST /api/analyze-webpage

Analyze live webpage with axe-core

{"url": "http://localhost:3000", "includeScreenshot": false}
POST /api/analyze-all

Comprehensive analysis - Run all accessibility tests in one request

{"code": "your code", "fileType": "svelte", "framework": "svelte"}
{"url": "http://localhost:3000"}
{"code": "<div>test</div>", "url": "http://localhost:3000"}

Service: mtc-gooda11y-mcp API v1.0.0