clarvia-mcp-server

MCP server for Clarvia — search, evaluate, and gate-check 27,843+ AI agent tools

Quick Start

{
  "mcpServers": {
    "clarvia": {
      "command": "npx",
      "args": ["-y", "clarvia-mcp-server"]
    }
  }
}

Or use the remote endpoint (no install needed):

https://clarvia-api.onrender.com/mcp/

Configure

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "clarvia": {
      "command": "npx",
      "args": ["-y", "clarvia-mcp-server"]
    }
  }
}

Claude Code

claude mcp add clarvia -- npx -y clarvia-mcp-server

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "clarvia": {
      "command": "npx",
      "args": ["-y", "clarvia-mcp-server"]
    }
  }
}

Windsurf

Add to .windsurf/mcp.json:

{
  "mcpServers": {
    "clarvia": {
      "command": "npx",
      "args": ["-y", "clarvia-mcp-server"]
    }
  }
}

Cline

Add to VS Code settings or .cline/mcp.json:

{
  "mcpServers": {
    "clarvia": {
      "command": "npx",
      "args": ["-y", "clarvia-mcp-server"]
    }
  }
}

Tools

Discovery & Search

| Tool | Description | |------|-------------| | search_services | Search 27,906+ indexed AI tools (MCP servers, APIs, CLIs) by keyword, category, or minimum AEO score | | list_categories | List all tool categories in the directory with service counts | | get_stats | Get platform-wide statistics — total services, average scores, distributions |

Scanning & Evaluation

| Tool | Description | |------|-------------| | scan_service | Run a full AEO audit on any URL — evaluates agent discoverability, API quality, docs, MCP readiness | | get_service_details | Get detailed scoring breakdown for a previously scanned service | | register_service | Submit a new service for indexing and AEO scoring |

Agent Safety & Gating

| Tool | Description | |------|-------------| | clarvia_gate_check | Quick pass/fail safety check — returns agent grade (NATIVE/FRIENDLY/POSSIBLE/HOSTILE) with boolean result | | clarvia_batch_check | Batch-check up to 10 URLs in one call — compare tool candidates side-by-side | | clarvia_find_alternatives | Find higher-rated alternative tools in a category, ranked by agent-readiness | | clarvia_probe | Live accessibility probe — HTTP reachability, latency, OpenAPI, MCP server-card, agents.json |

Setup Management

| Tool | Description | |------|-------------| | register_my_setup | Register your tool setup to get AEO scores and category rankings for each tool | | compare_my_setup | Compare your setup against higher-scored alternatives in each category | | recommend_upgrades | Get personalized upgrade recommendations based on your registered setup |

Feedback & Support

| Tool | Description | |------|-------------| | clarvia_submit_feedback | Report tool usage outcomes (success/failure/partial) to improve reliability data | | clarvia_report_issue | Report bugs, request features, or flag security issues | | clarvia_list_issues | List existing tickets — check status or find known issues |

Usage Examples

Search for AI tools:

Use search_services with query "code assistant" to find coding tools

Gate-check before calling a tool:

Use clarvia_gate_check with url "https://api.example.com" and min_rating "AGENT_FRIENDLY"

Scan a new service:

Use scan_service with url "https://example.com" to get a full AEO audit

Find alternatives when a tool fails:

Use clarvia_find_alternatives with category "payment" and min_score 70

Benchmark your agent's toolchain:

Use register_my_setup with tools ["dune-mcp", "notion-mcp", "telegram-bot"]
Then use compare_my_setup with the returned setup_id

Report usage outcome:

Use clarvia_submit_feedback with profile_id, outcome "success", and latency_ms

Add Your AEO Score Badge

If you're an MCP server developer, add your Clarvia AEO score to your README:

[![AEO Score](https://clarvia.art/api/badge/YOUR-TOOL-NAME)](https://clarvia.art/profile/YOUR-TOOL-NAME)

Example output: Clarvia: AEO 87/100 — shows your agent-readiness score, auto-updates when scores change.

Check your tool's score →

Development

npm install
npm run dev    # Watch mode
npm run build  # Production build
npm start      # Run server

Links

• Website: clarvia.art
• GitHub: clarvia-project/scanner
• npm: clarvia-mcp-server
• GitHub Action: clarvia-project/clarvia-aeo-check — AEO check in CI/CD pipelines
• MCP Registry: io.github.digitamaz/clarvia
• Remote Endpoint: https://clarvia-api.onrender.com/mcp/

License

MIT