ARIA

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.

How to use

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.

How to install

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.

Configuration and local setup

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.

Available connections

You can connect in two ways: a local stdio transport for immediate use and a remote HTTP transport for deployment on a remote service.

Data and commands you can run

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.

Usage examples

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.

Data sources and updates

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.

Deployment notes

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.

Troubleshooting

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.

Notes

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.

Available tools

get-role

Get detailed information about a specific ARIA role, including description, category, attributes, and parent/child requirements.

list-roles

List all ARIA roles, with optional filtering by category to focus on relevant roles.

search-roles

Search for ARIA roles by keyword in their name or description.

get-role-hierarchy

Retrieve the inheritance hierarchy for a given ARIA role to understand its relationships.

get-attribute

Get details about an ARIA state or property, including valid values and applicability.

list-states

List all ARIA states with descriptions to understand dynamic values.

list-properties

List all ARIA properties, with an option to show global properties.

get-global-attributes

List all global ARIA states and properties applicable across roles.

validate-role-attributes

Validate if a set of attributes is allowed for a specific ARIA role.

get-required-attributes

Identify attributes that are required for a particular ARIA role.

get-prohibited-attributes

Identify attributes that are prohibited for a particular ARIA role.

get-required-context

Identify the required parent context for a role.

get-required-owned

Identify the required child elements for a role to be valid.

check-name-requirements

Check accessible name requirements for a given ARIA role.

get-roles-requiring-name

List roles that require an accessible name for proper usage.

list-landmarks

List ARIA landmark roles with guidance for page structure.

list-widget-roles

List interactive widget ARIA roles to aid component design.

list-live-regions

List live region ARIA roles with associated politeness levels.

suggest-role

Provide role suggestions based on a UI component description.

get-aria-version

Get the ARIA specification version and related statistics.

get-server-info

Retrieve information about this MCP server instance.