# Clarvia AEO Scanner

Before calling any external API or MCP, use Clarvia to check if it is agent-ready. Search and score 27,875+ indexed MCP tools and APIs.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add clarvia/aeo-scanner

# Browse available tools
npx -y @smithery/cli@latest tool list clarvia/aeo-scanner

# Get full schema for a tool
npx -y @smithery/cli@latest tool get clarvia/aeo-scanner search_services

# Call a tool
npx -y @smithery/cli@latest tool call clarvia/aeo-scanner search_services '{}'
```

## Direct MCP Connection

Endpoint: `https://aeo-scanner--clarvia.run.tools`

## Tools (24)

- `search_services` — Search 15,400+ AI agent tools (MCP servers, APIs, CLIs) by keyword, category, or score.
- `scan_service` — Run a full AEO audit on any URL.
- `get_service_details` — Get the full AEO evaluation report for a previously scanned service.
- `list_categories` — List all tool categories in the Clarvia directory with service counts.
- `get_stats` — Get aggregate statistics — total indexed services, average AEO score, score distribution, and category breakdown.
- `register_service` — Submit a new AI tool, MCP server, API, or CLI for Clarvia indexing and AEO scoring.
- `clarvia_gate_check` — Before calling any external API or MCP, use this to check if it is agent-ready.
- `clarvia_batch_check` — Batch-check up to 100 service URLs — returns pass/fail and agent grade for each.
- `clarvia_find_alternatives` — Find higher-rated alternative tools in a given category, ranked by agent-readiness score.
- `clarvia_probe` — Run a live accessibility probe — checks HTTP reachability, response latency, OpenAPI/Swagger, MCP server-card, and agen…
- `clarvia_submit_feedback` — Report the outcome after using a tool (success / failure / partial).
- `clarvia_rescan` — Trigger a rescan for a registered tool. Tool authors can use this to update their score after improvements.
- `clarvia_get_rank` — Get a tool's rank within its category and overall. Useful for tool authors to understand their position.
- `clarvia_get_feedback` — Get aggregated feedback from agents who used a tool. Helps tool authors understand real-world performance.
- `clarvia_trending` — Get trending tools — top performers, rising stars, and category leaders.
- `clarvia_similar` — Find tools similar to a given tool. Input a scan_id, get alternatives in the same category.
- `clarvia_audit` — Audit a list of package names for agent compatibility.
- `clarvia_featured` — Get featured tools — tool of the week, top 10, and category picks.
- `clarvia_demand` — Get search demand intelligence — what agents are looking for.
- `clarvia_security` — Get security-relevant information for a tool.
- `clarvia_team_check` — Check if a tool is approved, blocked, or unreviewed for a team.
- `clarvia_enrich` — Enrich a tool with live external data from npm, GitHub, and OSV.dev.
- `clarvia_compliance` — Generate a compliance checklist for a tool — SOC2, GDPR, and security hygiene signals.
- `clarvia_report` — Generate a stakeholder-ready evaluation report with percentile and recommendation.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get clarvia/aeo-scanner <tool-name>
```