MCP server wrapping the Artificial Analysis API for LLM and multimodal model data queries
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"aa-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# aa-mcp MCP server wrapping the [Artificial Analysis](https://artificialanalysis.ai/) public API. Enables AI agents to query LLM and multimodal model benchmarks, pricing, speed data, and track model updates via structured diffs. The PyPI package is `aa-mcp`; it installs the `aa-mcp` console command. ## Requirements - Python 3.10+ - [uv](https://docs.astral.sh/uv/) (for installation and running) - An Artificial Analysis API key ([get one free](https://artificialanalysis.ai/account)) ## Installation & Running Use `uvx` as the standard runtime path: ```bash export ARTIFICIAL_ANALYSIS_API_KEY="aa_your_key_here" uvx aa-mcp ``` ## Environment Variables | Variable | Required | Default | Description | |---|---|---|---| | `ARTIFICIAL_ANALYSIS_API_KEY` | Yes | - | Your AA API key | | `AA_MCP_SNAPSHOT_DIR` | No | `~/.local/share/aa-mcp/snapshots/` | Directory for update snapshots | | `AA_MCP_LOG_LEVEL` | No | `INFO` | Log level (DEBUG, INFO, WARNING, ERROR) | ## Official API Coverage This server wraps the current free Artificial Analysis API endpoints documented at <https://artificialanalysis.ai/api-reference>: | Artificial Analysis endpoint | MCP tool | |---|---| | `GET /api/v2/data/llms/models` | `aa_list_llms`, `aa_get_model`, `aa_compare_models`, `aa_list_recent_updates`, `aa_healthcheck` | | `GET /api/v2/data/media/text-to-image` | `aa_list_media_models(modality="text-to-image")` | | `GET /api/v2/data/media/image-editing` | `aa_list_media_models(modality="image-editing")` | | `GET /api/v2/data/media/text-to-speech` | `aa_list_media_models(modality="text-to-speech")` | | `GET /api/v2/data/media/text-to-video` | `aa_list_media_models(modality="text-to-video")` | | `GET /api/v2/data/media/image-to-video` | `aa_list_media_models(modality="image-to-video")` | | `POST /api/v2/critpt/evaluate` | `aa_evaluate_critpt` | ## MCP Tools ### `aa_list_llms` List LLM models with filtering and sorting. - **Filters**: `creator`, `name`, `slug` (substring match) - **Sort by…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.