Repository avatar
AI Tools
v0.1.0
active

a11y-probe-mcp

io.github.MartinSwiss/a11y-probe-mcp

Paid WCAG scans for AI agents over MCP, settled with x402 USDC on Base.

Documentation

A11y Probe

Paid WCAG scans for AI agents. A Cloudflare Worker exposes an MCP server at /mcp and the same calls over HTTP. Callers pay per call with x402 (USDC on Base). Automated checks find roughly 57% of WCAG issues. A report is a template: not legal advice, no compliance guarantee.

Our code is MIT. The unmodified axe-core dependency is MPL-2.0 (see NOTICE). The product name does not use that dependency's name.

Nothing in this repository is deployed. DEPLOY.md is the owner's checklist.

Prices

Set in src/config.ts:

CallUSDRoute
get_pricing0GET /api/v1/pricing
check_contrast0.01POST /api/v1/check/contrast
scan_page0.05POST /api/v1/scan/page
check_links_meta0.05POST /api/v1/check/links-meta
scan_site0.50POST /api/v1/scan/site
report1.00POST /api/v1/report

The home page states the same numbers, how a 402 is paid, and the limits. Draft terms, privacy, and imprint are under /legal. Terms are under Swiss law and cap liability for a paid call at the amount paid for that call. The privacy notice names Cloudflare and Coinbase as processors in the United States.

Demo

Against a local npx wrangler dev (see DEPLOY.md) or the deployed origin https://a11y.aiagentpay.cloud:

ORIGIN=http://127.0.0.1:8787

curl -s "$ORIGIN/api/v1/pricing"

curl -s -D - -o /tmp/a11y-402.json -X POST "$ORIGIN/api/v1/scan/page" \
  -H 'content-type: application/json' \
  -d '{"url":"https://example.com/","authorized":true}'

The second call is 402 with a payment-required header when the URL is allowed. It does not settle. A client that understands x402 signs USDC on Base Sepolia (eip155:84532 in the default config) and retries with PAYMENT-SIGNATURE. Settlement happens only after the scan succeeds.

Blocked cases never return 402:

  • authorized is not true
  • the URL is not public http(s) on port 80 or 443
  • robots.txt disallows A11yProbe/1.0 or *
  • 10 paid calls in a minute for that payer or IP
  • 50 pages today for that domain, or the global daily cap

Try the MCP endpoint with MCP Inspector:

npx @modelcontextprotocol/inspector

Connect to $ORIGIN/mcp over Streamable HTTP. get_pricing is free. Paid tools advertise their price and the x402 Bazaar schema.

A local stdio process for Glama proxies the paid tools. get_pricing runs without a network:

A11Y_PROBE_URL=https://a11y.aiagentpay.cloud node --experimental-strip-types src/stdio.ts

Configuration

NameWherePurpose
PAY_TOvarPublic Base address that receives USDC. Set in wrangler.jsonc for testnet and production. Override with a PAY_TO secret to swap it, including for a Stripe crypto address, without a code change.
X402_NETWORKvareip155:84532 (Base Sepolia) by default. eip155:8453 in env.production.
FACILITATOR_URLvarhttps://x402.org/facilitator for tests. CDP https://api.cdp.coinbase.com/platform/v2/x402 in production.
CDP_API_KEY_ID, CDP_API_KEY_SECRETsecretsCDP JWT auth for the mainnet facilitator. Required only under env.production. The testnet config does not list them.
INFO_URLvarPublic origin used in the user agent and legal links. https://a11y.aiagentpay.cloud/ in both environments.
GLOBAL_DAILY_PAGE_CAPvarDefault 20, to stay inside Browser Run's free daily minutes.

server.json publishes the server as io.github.MartinSwiss/a11y-probe-mcp. The remote URL is https://a11y.aiagentpay.cloud/mcp. Do not publish before the Worker answers.

Develop

npm ci
npx wrangler types
npm test
npm run typecheck

Tests do not spend USDC. Payment tests use a local facilitator and a throwaway signing key.

No installation packages available.