Which integrations are available for this server?

Enables auditing of npm package dependencies to evaluate their agent-readiness and quality scores using the AEO (Agent Engine Optimization) standard. Allows for auditing Python package dependencies to assess their compatibility, accessibility, and trust signals for use by AI agents.

Clarvia

The AEO (Agent Engine Optimization) Standard for AI Agent Tools

Score, discover, and validate 15,400+ AI agent tools for quality, accessibility, and agent-readiness.

npm version npm downloads License: MIT MCP Tools Python Tools Services Indexed API Endpoints Website

Website · npm · API Docs · Leaderboard

Install (one command)

npx -y clarvia-mcp-server

Or add to any MCP client config:

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

No install needed? Use the remote endpoint directly:

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

What is Clarvia?

Clarvia assigns an AEO Score (0-100) to any AI tool, API, or MCP server — measuring how easily AI agents can discover, integrate, and trust it. Think of it as "Lighthouse for AI agent tools."

4 scoring dimensions (25 points each):

Dimension	What it measures
API Accessibility	Endpoint existence, response speed, auth documentation
Data Structuring	Schema definition, pricing clarity, error structure
Agent Compatibility	MCP server presence, robots.txt, sitemap/discovery
Trust Signals	Uptime, documentation quality, update frequency

Plus an optional Onchain Bonus (+25) for web3 services.

For Agents

Before calling any external tool, check if it's agent-ready.

Clarvia gives your agent a quality gate for tool selection:

Agent workflow:
  Need a payment API?
  -> search_services("payment API")
  -> clarvia_gate_check(top_result)
  -> PASS? Use it. FAIL? clarvia_find_alternatives("payment")
  -> After use: clarvia_submit_feedback(result)

Agent Grades:

AGENT_NATIVE (80+) — Built for agents, full MCP/OpenAPI support
AGENT_FRIENDLY (60-79) — Good API, minor gaps
AGENT_POSSIBLE (40-59) — Usable with effort
AGENT_HOSTILE (0-39) — Avoid for autonomous use

For Tool Makers

See your tool the way AI agents see it.

Your AEO score — how agent-ready your tool is today
Specific gaps — missing OpenAPI spec? No MCP server? Poor error messages?
Category ranking — how you compare to alternatives
Actionable fixes — each dimension tells you exactly what to improve

Quick Start by Framework

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

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

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

Add to .cursor/mcp.json:

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

Add to .windsurf/mcp.json:

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

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

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

Add to ~/.continue/config.json:

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "clarvia-mcp-server"]
        }
      }
    ]
  }
}

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

No local installation required. Works with any MCP client supporting Streamable HTTP transport.

See examples/ for ready-to-copy config files.

MCP Tools — Node.js Server (16 tools)

Discovery & Search

Tool	Description
`search_services`	Search 15,400+ indexed AI tools by keyword, category, or minimum AEO score
`list_categories`	List all tool categories with service counts
`get_stats`	Platform-wide statistics — total services, score distributions

Scanning & Evaluation

Tool	Description
`scan_service`	Full AEO audit on any URL — agent discoverability, API quality, docs, MCP readiness
`get_service_details`	Detailed scoring breakdown for a scanned service
`register_service`	Submit a new service for indexing and scoring

Agent Safety & Gating

Tool	Description
`clarvia_gate_check`	Pass/fail safety check — agent grade with boolean result
`clarvia_batch_check`	Batch-check up to 10 URLs in one call
`clarvia_find_alternatives`	Find higher-rated alternatives in a category
`clarvia_probe`	Live probe — HTTP reachability, latency, OpenAPI, MCP, agents.json

Setup Management

Tool	Description
`register_my_setup`	Register your tool setup for AEO scoring per tool
`compare_my_setup`	Compare your setup against higher-scored alternatives
`recommend_upgrades`	Personalized upgrade recommendations

Feedback & Support

Tool	Description
`clarvia_submit_feedback`	Report tool usage outcomes for reliability data
`clarvia_report_issue`	Report bugs, request features, flag issues
`clarvia_list_issues`	List existing tickets and known issues

Python MCP Server (24 tools)

The backend also runs a Python-based MCP server with extended capabilities:

Tool	Description
`search_services`	Search indexed tools with advanced filters
`scan_service`	Full AEO audit
`get_service_details`	Detailed scoring breakdown
`list_categories`	Browse categories
`get_stats`	Platform statistics
`register_service`	Submit new service
`clarvia_gate_check`	Pass/fail safety gate
`clarvia_batch_check`	Batch URL checking
`clarvia_find_alternatives`	Category alternatives
`clarvia_probe`	Live accessibility probe
`clarvia_submit_feedback`	Report usage outcomes
`clarvia_rescan`	Trigger rescan of a profiled service
`clarvia_get_rank`	Get category ranking for a service
`clarvia_get_feedback`	Get community feedback for a service
`clarvia_trending`	Trending tools by score changes
`clarvia_similar`	Find similar tools to a given service
`clarvia_audit`	Audit npm/pip package dependencies
`clarvia_featured`	Get featured/curated tools
`clarvia_demand`	See most-requested tool categories

Access via remote endpoint: https://clarvia-api.onrender.com/mcp/

Claude Code Skills

Pre-built skills for Claude Code that use Clarvia MCP tools:

Skill	Command	Description
Scan	`/clarvia-scan <url-or-name>`	Run a full AEO audit on any tool
Compare	`/clarvia-compare <tool-A> vs <tool-B>`	Head-to-head dimension comparison
Recommend	`/clarvia-recommend <use-case>`	Get top tool picks for a use case

Quick setup:

claude mcp add clarvia -- npx -y clarvia-mcp-server
cp .claude/skills/clarvia-*.md /your/project/.claude/skills/

See SKILLS.md for full installation and usage details.

REST API (110+ endpoints)

Full OpenAPI spec: /openapi.json

Key endpoints:

Method	Endpoint	Description
`GET`	`/v1/services`	Search and filter services
`GET`	`/v1/search`	Full-text search
`GET`	`/v1/score`	Quick score lookup
`GET`	`/v1/leaderboard`	Top-scored services
`GET`	`/v1/categories`	Browse categories
`POST`	`/v1/audit`	Run AEO audit
`GET`	`/v1/recommend`	Intent-based recommendations
`GET`	`/v1/similar/{id}`	Find similar tools
`GET`	`/v1/trending`	Trending services
`GET`	`/v1/featured`	Curated picks
`GET`	`/v1/stats`	Platform statistics
`GET`	`/v1/compare`	Compare up to 4 tools
`POST`	`/v1/profiles`	Create service profile
`GET`	`/v1/demand`	Most-demanded categories
`GET`	`/v1/feed/registry`	Machine-readable feed for registries

Rate limits: 10 scans/hour (free) · 100/hour (with X-API-Key)

Agent Discovery Endpoints

Clarvia is designed to be discovered by AI agents:

Endpoint	URL
OpenAPI Spec	`https://clarvia-api.onrender.com/openapi.json`
agents.json	`https://clarvia.art/.well-known/agents.json`
llms.txt	`https://clarvia.art/llms.txt`
llms-full.txt	`https://clarvia.art/llms-full.txt`
robots.txt	`https://clarvia.art/robots.txt`
Sitemap	`https://clarvia.art/sitemap.xml`
MCP Endpoint	`https://clarvia-api.onrender.com/mcp/`

Architecture

scanner/
  backend/           # FastAPI (Python 3.12+) — 110+ API endpoints + MCP server
    app/
      checks/        # 13 scoring sub-factors
      routes/        # REST API endpoints
      services/      # Supabase, PDF generation, enrichment
      mcp_server.py  # Python MCP server (24 tools)
  frontend/          # Next.js + Tailwind — clarvia.art
  mcp-server/        # Node.js MCP server (TypeScript, 16 tools)
  cli/               # CLI scanner tool
  examples/          # Framework integration configs
  github-action/     # GitHub Actions for CI/CD AEO checks

Development

# Backend
cd backend && pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000

# Frontend
cd frontend && npm install && npm run dev

# MCP Server
cd mcp-server && npm install && npm run dev

# Docker (full stack)
docker compose up --build

Integrations

Platform	Type	Link
npm	MCP Server	clarvia-mcp-server
PyPI	LangChain integration	clarvia-langchain
GitHub Actions	CI/CD AEO check	github-action/
Smithery	MCP Registry	smithery.yaml
MCP Registry	Official registry	`io.github.digitamaz/clarvia`
Glama.ai	MCP Directory	glama.ai/mcp/servers
mcp.so	MCP Directory	mcp.so

License

MIT

clarvia-mcp-server