Provides ARIA 1.3 data, role/state/property details, and validation guidance for accessibility.
Configuration
View docs{
"mcpServers": {
"joe-watkins-aria-mcp": {
"url": "https://your-site.netlify.app/mcp"
}
}
}You can query and validate ARIA roles, states, and accessibility guidance locally or remotely through a dedicated MCP server. It provides complete ARIA 1.3 data, role validation, naming guidance, and smart role suggestions to help developers, accessibility professionals, and AI agents build accessible components and audits.
Set up your MCP client to connect to the ARIA MCP server, then start querying roles, states, properties, and guidance. You can perform actions like looking up a specific role, listing all roles, validating attributes for a role, asking for role suggestions from a UI description, and retrieving accessibility name requirements. Use the available endpoints through your MCP client to get detailed role information, validate ARIA attributes, and obtain usage guidance.
Prerequisites: Node.js and npm or npx available on your system.
Install dependencies for the ARIA MCP server project (if you are setting up locally, ensure you have the project checked out and its dependencies installed). Use your project’s standard package manager to install.
Start the ARIA MCP server locally using the provided runtime command. The runtime uses a stdio transport for local use.
Configure your MCP client to connect to the ARIA MCP server in your environment. The following local and remote connection options are provided:
Local stdio setup uses an inline command to run the MCP server with npx and a package name. Remote usage can connect to a Netlify-hosted MCP endpoint.
You can connect in two ways: a local stdio transport for immediate use and a remote HTTP transport for deployment on a remote service.
The ARIA MCP server exposes a wide range of tools for querying and validation. You can retrieve detailed information about ARIA roles, list roles and states, validate attributes for roles, and obtain name-related guidance and role suggestions.
Query a role and retrieve its full details including description, category, and attribute requirements. Validate attributes for a role. Get role suggestions from a UI component description. List landmarks and accessibility guidance.
The server’s data originates from the W3C ARIA specification and related sources. You can update parsed ARIA data to the latest version as needed using the provided update and parse commands to regenerate the data set.
For remote deployment, you can host the MCP on a platform and point your MCP client to the remote URL. For local development, run the MCP server with stdio transport and query it from your editor or IDE.
If you encounter connection issues, verify that your MCP client is pointing to the correct server endpoint (local or remote), ensure dependencies are installed, and confirm that the server process is running. Check the transport type you configured (stdio vs http) and adjust your client accordingly.
This MCP server covers ARIA roles, states, properties, and guidance. It supports comprehensive role information, validations, and accessibility recommendations to aid development and auditing workflows.
Get detailed information about a specific ARIA role, including description, category, attributes, and parent/child requirements.
List all ARIA roles, with optional filtering by category to focus on relevant roles.
Search for ARIA roles by keyword in their name or description.
Retrieve the inheritance hierarchy for a given ARIA role to understand its relationships.
Get details about an ARIA state or property, including valid values and applicability.
List all ARIA states with descriptions to understand dynamic values.
List all ARIA properties, with an option to show global properties.
List all global ARIA states and properties applicable across roles.
Validate if a set of attributes is allowed for a specific ARIA role.
Identify attributes that are required for a particular ARIA role.
Identify attributes that are prohibited for a particular ARIA role.
Identify the required parent context for a role.
Identify the required child elements for a role to be valid.
Check accessible name requirements for a given ARIA role.
List roles that require an accessible name for proper usage.
List ARIA landmark roles with guidance for page structure.
List interactive widget ARIA roles to aid component design.
List live region ARIA roles with associated politeness levels.
Provide role suggestions based on a UI component description.
Get the ARIA specification version and related statistics.
Retrieve information about this MCP server instance.