clarvia-aeo-check

[](https://github.com/marketplace/actions/clarvia-aeo-check) [](https://opensource.org/licenses/MIT)

A GitHub Action that analyzes your MCP (Model Context Protocol) server configurations for AEO (AI Engine Optimization) readiness. It auto-detects configs in your repository, scores them via the Clarvia API, and posts results as PR comments.

AEO (AI Engine Optimization) measures how well your API or MCP server is optimized for AI agent consumption. Clarvia evaluates four dimensions:

| Dimension | What it measures | |-----------|-----------------| | API Accessibility | Can AI agents discover and reach your API? | | Data Structuring | Is your data formatted for machine consumption? | | Agent Compatibility | Does your API support agentic workflows? | | Trust Signals | Does your API provide verifiable trust indicators? |

name: AEO Check
on: [pull_request]

jobs:
  aeo:
    runs-on: ubuntu-latest
    permissions:
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
      - uses: clarvia/aeo-check@v1

The action automatically finds MCP config files (mcp.json, server.json, claude_desktop_config.json, etc.) and scans any URLs defined in them.

- uses: clarvia/aeo-check@v1
  with:
    url: 'https://api.example.com'
    fail-under: '60'

- uses: clarvia/aeo-check@v1
  with:
    config-paths: 'config/mcp.json,server.json'

| Input | Required | Default | Description | |-------|----------|---------|-------------| | url | No | — | URL to scan. If omitted, auto-detects MCP configs in the repo. | | config-paths | No | — | Comma-separated config file paths to scan. Ov