Tactual MCP

by tactual-dev

1 stars

317 downloads

Not rated

GitHub Website

Description

Screen-reader navigation cost analyzer that measures the actual navigation effort for assistive-technology users by building a weighted graph from Playwright accessibility snapshots and scoring each target under real assistive-technology profiles (NVDA, JAWS, VoiceOver…

About

Details

Author: tactual-dev
GitHub stars: 1
Downloads: 317
Categories: Developer Tools, Other

- Measures navigation cost (keystrokes) for screen-reader users
- Supports AT profiles: NVDA, JAWS, VoiceOver
- Explores hidden UI with keyboard probing (menus, dialogs, tabs)
- Simulates screen-reader announcements and transcripts
- Outputs JSON, Markdown, and SARIF formats
- Diff analysis for before/after verification
- Optional validation against virtual screen reader

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Tactual MCP

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "tactual mcp": {
            "tactual": {
                "command": "npx",
                "args": [
                    "tactual-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tactual mcp": {
            "tactual": {
                "command": "npx",
                "args": [
                    "tactual-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tactual mcp": {
            "tactual": {
                "command": "npx",
                "args": [
                    "tactual-mcp"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "tactual mcp": {
            "tactual": {
                "command": "npx",
                "args": [
                    "tactual-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tactual mcp": {
            "tactual": {
                "command": "npx",
                "args": [
                    "tactual-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tactual mcp": {
            "tactual": {
                "command": "npx",
                "args": [
                    "tactual-mcp"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "tactual mcp": {
            "tactual": {
                "command": "npx",
                "args": [
                    "tactual-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tactual mcp": {
            "tactual": {
                "command": "npx",
                "args": [
                    "tactual-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tactual mcp": {
            "tactual": {
                "command": "npx",
                "args": [
                    "tactual-mcp"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "tactual mcp": {
            "tactual": {
                "command": "npx",
                "args": [
                    "tactual-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tactual mcp": {
            "tactual": {
                "command": "npx",
                "args": [
                    "tactual-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tactual mcp": {
            "tactual": {
                "command": "npx",
                "args": [
                    "tactual-mcp"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "tactual mcp": {
            "tactual": {
                "command": "npx",
                "args": [
                    "tactual-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tactual mcp": {
            "tactual": {
                "command": "npx",
                "args": [
                    "tactual-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "tactual mcp": {
            "tactual": {
                "command": "npx",
                "args": [
                    "tactual-mcp"
                ]
            }
        }
    }
}

From the repository

Install the tactual npm package (requires Node.js 20+). The MCP server runs as tactual-mcp and is included with the package. After installation, configure your MCP client to invoke the tactual-mcp command. Tools such as analyze-url, diff-results, transcript, and validate-url are available via the CLI and can be used through the MCP server.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "tactual mcp": {
            "tactual": {
                "command": "npx",
                "args": [
                    "tactual-mcp"
                ]
            }
        }
    }
}

McpServers

{
    "tactual": {
        "command": "npx",
        "args": [
            "tactual-mcp"
        ]
    }
}

Tactual

Screen-reader navigation cost analyzer. Measures how many keystrokes a screen-reader user needs to discover, reach, and operate every interactive target on your page — under a specific AT profile (NVDA, JAWS, VoiceOver).

What it does

Existing accessibility tools check conformance — is the ARIA correct? Is the contrast ratio sufficient?

Tactual measures navigation cost — how many actions does it take a screen-reader user to reach the checkout button? What happens if they overshoot? Can they even discover it exists? Does the menu actually open on Enter, or only on click? Does focus land on the first menuitem or stay stuck on the trigger?

How it works:

- Captures Playwright accessibility snapshots + screen-reader announcement simulation
- Optionally explores hidden branches (menus, dialogs, tabs, disclosures) and probes them with real keyboard events, including APG-style widget contracts and form-error flows
- Builds a navigation graph with entry points (landmarks, headings, linear Tab) and scores every target
- Optionally validates predicted paths against @guidepup/virtual-screen-reader for calibration

Tactual is a developer tool for analyzing your own sites and staging environments. Run it locally, in CI, or via the MCP server in your editor. It is not a public scanning service.

How it fits

Tactual complements conformance scanners such as axe-core, Lighthouse, and Pa11y. Those tools are still the right first pass for broad WCAG and ARIA rule coverage. Tactual is aimed at the next question: after a page has valid markup, how expensive is it for an AT user to discover, reach, and operate the important targets?

Use Tactual for screen-reader navigation-cost triage, path tracing, measured keyboard/widget evidence, before/after diffs, CI prioritization, and MCP workflows where an agent needs compact findings with source selectors and remediation candidates. Use real screen readers and manual testing for final validation of critical journeys, timing-sensitive flows, browser/AT settings, and implementation patterns that intentionally differ from a common APG example.

Agent quick path: this README is a product overview plus reference. Agents should start with docs/AGENT-RECIPES.md for task patterns and docs/MCP-TOOLS.md for full MCP schemas, then come back here only for product context, install notes, and release-surface examples.

Install

Requires Node.js 20 or later.

npm install tactual

Tactual installs Playwright as a runtime dependency so one-off npx tactual@latest ... commands work without separately installing Playwright into the npx cache. The MCP SDK also ships as a runtime dependency, so tactual-mcp works from an installed tactual package without a separate SDK install.

Quick start

CLI

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Description

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Tactual

What it does

How it fits

Install

Quick start

CLI

Install

More like this

Sequential Thinking

Sentry

Github

Filesystem

EverArt

Google Drive