aa-mcp

MCP server for artificialanalysis.ai — live AI model benchmarks, pricing, speed, context/parameter specs, provider endpoints and the image/video/speech/music arenas. Every benchmark and index AA publishes is covered — the leaderboard suite, the Decision Models, the Multilingual Index, the on-device benchmark set and the eval-chart breakdowns — shaped for agents that pay per token.

No API key needed. One keyless data source: the site’s Next.js RSC flight payloads, scraped and cached locally — no quota, no backend selection, no fallback logic. Every response header shows aa:rsc.

Install

One line, no clone (uv fetches and runs it for you):

uvx --from git+https://github.com/HenryGetz/aa-mcp aa-mcp

Or install the aa-mcp executable once:

uv tool install --from git+https://github.com/HenryGetz/aa-mcp aa-mcp   # -> ~/.local/bin/aa-mcp

Local checkout / development:

git clone  && cd aa-mcp
uv sync                      # creates .venv with the mcp SDK
uv run aa-mcp                # serve on stdio

Register with an MCP client (omp, Claude Code, Codex, …):

{
  "mcpServers": {
    "aa": {
      "type": "stdio",
      "command": "/home/USER/.local/bin/aa-mcp",
      "timeout": 120000
    }
  }
}

Skills and MCP install

The JSON above installs the MCP server (callable tools, exposed as mcp__aa_). A skill is a different thing — markdown instructions an agent reads on demand via skill://, installed by copying a directory (or npx skills add …) into a skills root such as ~/.agents/skills/ or /.agents/skills/; it adds no tools, and omp only notices it after a restart. This repo ships one at skills/aa-mcp/SKILL.md.

Full commands, paths and troubleshooting for both: docs/SKILLS.md.

No MCP client? The same tools are reachable from a plain shell as aa-mcp-cli (same install as aa-mcp; python -m aa_mcp.cli from a checkout) — e.g. aa-mcp-cli call aa_leaderboard '{"top":3}' prints exactly what the MCP tool returns.

Tools