About

Imported from administrakt0r/AI-Agents-Safe-Coding-Skills (plugins/AI-Agents-Safe-Coding-Skills-claude/skills/clarvia-aeo-check/SKILL.md). Install upstream with npx skills add administrakt0r/AI-Agents-Safe-Coding-Skills --skill clarvia-aeo-check. Copyright stays with the author.

Clarvia AEO Check

Name: clarvia-aeo-check
Author: administrakt0r

Overview

Before adding any MCP server, API, or CLI tool to your agent workflow, use Clarvia to score its agent-readiness. Clarvia evaluates 15,400+ AI tools across four AEO dimensions: API accessibility, data structuring, agent compatibility, and trust signals.

Prerequisites

Add Clarvia MCP server to your config:

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

When to Use This Skill

Use when evaluating a new MCP server before adding it to your config
Use when comparing two tools for the same job
Use when building an agent that selects tools dynamically
Use when you want to find the highest-quality tool in a category

How It Works

Step 1: Score a specific tool

Ask Claude to score any tool by URL or name:

Score https://github.com/example/my-mcp-server for agent-readiness

Clarvia returns a 0-100 AEO score with breakdown across four dimensions.

Step 2: Search tools by category

Find the top-rated database MCP servers using Clarvia

Returns ranked results from 15,400+ indexed tools.

Step 3: Compare tools head-to-head

Compare supabase-mcp vs firebase-mcp using Clarvia

Returns side-by-side score breakdown with a recommendation.

Step 4: Check leaderboard

Show me the top 10 MCP servers for authentication using Clarvia

Examples

Example 1: Evaluate before installing

Before I add this MCP server to my config, score it:
https://github.com/example/new-tool

Use the clarvia aeo_score tool and tell me if it's agent-ready.

Example 2: Find best tool in category

I need an MCP server for web scraping. Use Clarvia to find the 
top-rated options and compare the top 3.

Example 3: CI/CD quality gate

Add to your CI pipeline using the GitHub Action:

- uses: clarvia-project/clarvia-action@v1
  with:
    url: https://your-api.com
    fail-under: 70

AEO Score Interpretation

Score	Rating	Meaning
90-100	Agent Native	Built specifically for agent use
70-89	Agent Friendly	Works well, minor gaps
50-69	Agent Compatible	Works but needs improvement
30-49	Agent Partial	Significant limitations
0-29	Not Agent Ready	Avoid for agentic workflows

Best Practices

✅ Score tools before adding them to long-running agent workflows
✅ Use Clarvia's leaderboard to discover alternatives you haven't considered
✅ Re-check scores periodically — tools improve over time
❌ Don't skip scoring for "well-known" tools — even popular tools can score poorly
❌ Don't use tools scoring below 50 in production agent pipelines without understanding the limitations

Common Pitfalls

Problem: Clarvia returns "not found" for a tool Solution: Try scanning by URL directly with aeo_score — Clarvia will score it on-demand
Problem: Score seems low for a tool I trust Solution: Use get_score_breakdown to see which dimensions are weak and decide if they matter for your use case

Related Skills

@mcp-builder - Build a new MCP server that scores well on AEO
@agent-evaluation - Broader agent quality evaluation framework

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/administrakt0r-ai-agents-safe-coding-skills-clarvia-aeo-check/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

administrakt0r-ai-agents-safe-coding-skills-clarvia-aeo-check.ocm.jsonjson

{
  "ocm": "1",
  "id": "administrakt0r-ai-agents-safe-coding-skills-clarvia-aeo-check",
  "kind": "skill",
  "name": "clarvia-aeo-check",
  "description": "Score any MCP server, API, or CLI for agent-readiness using Clarvia AEO (Agent Experience Optimization). Search 15,400+ indexed tools before adding them to your workflow.",
  "publisher": "administrakt0r",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding",
      "math"
    ],
    "tags": [
      "skill-md",
      "mcp",
      "aeo",
      "tool-quality",
      "agent-readiness",
      "api-scoring",
      "clarvia",
      "github"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Score any MCP server, API, or CLI for agent-readiness using Clarvia AEO (Agent Experience Optimization). Search 15,400+ indexed tools before adding them to your workflow."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github",
      "repository": "https://github.com/administrakt0r/AI-Agents-Safe-Coding-Skills",
      "path": "plugins/AI-Agents-Safe-Coding-Skills-claude/skills/clarvia-aeo-check/SKILL.md",
      "ref": "7520423ac6a34031f80ea8400ebb60909074c2e8",
      "url": "https://github.com/administrakt0r/AI-Agents-Safe-Coding-Skills/blob/7520423ac6a34031f80ea8400ebb60909074c2e8/plugins/AI-Agents-Safe-Coding-Skills-claude/skills/clarvia-aeo-check/SKILL.md",
      "key": "administrakt0r/AI-Agents-Safe-Coding-Skills/plugins/AI-Agents-Safe-Coding-Skills-claude/skills/clarvia-aeo-check/SKILL.md"
    }
  },
  "instructions": "# Clarvia AEO Check\n\n## Overview\n\nBefore adding any MCP server, API, or CLI tool to your agent workflow, use Clarvia to score its agent-readiness. Clarvia evaluates 15,400+ AI tools across four AEO dimensions: API accessibility, data structuring, agent compatibility, and trust signals.\n\n## Prerequisites\n\nAdd Clarvia MCP server to your config:\n\n```json\n{\n  \"mcpServers\": {\n    \"clarvia\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"clarvia-mcp-server\"]\n    }\n  }\n}\n```\n\n## When to Use This Skill\n\n- Use when evaluating a new MCP server before adding it to your config\n- Use when comparing two to",
  "cost": {
    "context_tokens": 815
  }
}

Fetch it by URL: GET /api/v1/registry/administrakt0r-ai-agents-safe-coding-skills-clarvia-aeo-check/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.