Connect Claude, Cursor and your agents to Certvo

Quickstart

Claude Code

claude mcp add --transport http certvo https://certvo.com/api/mcp/ \
  --header "Authorization: Bearer crv_live_..."

Generate the key at /dashboard/settings/api-keys. Public tools work without a key — pass an empty string or skip the header.

Claude Desktop

Open ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) and add:

{
  "mcpServers": {
    "certvo": {
      "transport": "http",
      "url": "https://certvo.com/api/mcp/",
      "headers": { "Authorization": "Bearer crv_live_..." }
    }
  }
}

Cursor / any MCP client

Point your client at https://certvo.com/api/mcp/ with transport http and the bearer header above. Certvo uses standard JSON-RPC 2.0.

Public tools (no API key)

These four tools work without authentication. Rate-limited by IP.

• check_contrast

  WCAG contrast ratio for any foreground/background hex pair.

• wcag_criterion

  Plain-language explanation of any WCAG 2.1 success criterion.

• scan_public

  Quick anonymous accessibility scan of one URL (rate-limited by IP).

• agent_ready_check

  14-protocol check for whether a site is reachable by AI agents.

Account-bound tools

These require Authorization: Bearer crv_live_.... Tools that consume an AI credit are noted.

• list_my_sites

  List the websites the authenticated user owns in Certvo.

• add_site

  Add a new website to your account (idempotent).

• start_scan

  Kick off a fresh accessibility scan on one of your sites.

• get_scan_status

  Poll the progress and result of a scan.

• list_issues

  Cross-site issues feed with filters (severity, WCAG level, site).

• explain_issue

  AI explanation for a specific issue. Costs 1 credit.

• fix_issue

  AI-generated code fix for an issue. Costs 1 credit.

• generate_alt_text

  Generate alt text for an image URL in any language. Costs 1 credit.

• generate_statement

  Produce an EU-template accessibility statement. Costs 2 credits.

• scan_all_my_sites

  Start scans on every idle site you own (max 3 per call).

Example prompts

Authentication & limits

• API keys live under your account at /dashboard/settings/api-keys.
• Plain-text keys are shown once at creation. Certvo stores only a SHA-256 hash; if you lose the key, generate a new one.
• Up to 10 active keys per account. Revoke unused keys to make room.
• AI tools consume credits from your monthly plan budget (Free: 10/month, Pro: 100, Enterprise: 500).
• Rate limits are applied per key and per IP. If you hit one, the tool returns an error you can show the user.

Raw JSON-RPC

For custom clients, this is the wire protocol. Send POST requests to https://certvo.com/api/mcp/:

POST https://certvo.com/api/mcp/
Authorization: Bearer crv_live_...
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "check_contrast",
    "arguments": {
      "foreground_hex": "#525252",
      "background_hex": "#ffffff"
    }
  }
}