# Artificial Analysis MCP Server
An MCP (Model Context Protocol) server that provides LLM model pricing, speed metrics, and benchmark scores from [Artificial Analysis](https://artificialanalysis.ai).
## Features
- Get real-time pricing for 300+ LLM models (input/output/blended rates)
- Compare speed metrics (tokens/sec, time to first token)
- Access benchmark scores (Intelligence Index, Coding Index, MMLU-Pro, GPQA, and more)
- Filter by provider (OpenAI, Anthropic, Google, etc.)
- Sort by any metric
## Installation
### Claude Code
```bash
claude mcp add artificial-analysis -e AA_API_KEY=your-key -- npx -y artificial-analysis-mcp
```
Or install from GitHub:
```bash
claude /mcp add https://github.com/davidhariri/artificial-analysis-mcp
```
### Manual Configuration
Add to your Claude settings (`~/.claude/settings.json`):
```json
{
"mcpServers": {
"artificial-analysis": {
"command": "npx",
"args": ["-y", "artificial-analysis-mcp"],
"env": {
"AA_API_KEY": "your-api-key"
}
}
}
}
```
## Configuration
| Environment Variable | Required | Description |
|---------------------|----------|-------------|
| `AA_API_KEY` | Yes | Your Artificial Analysis API key |
Get your API key at [artificialanalysis.ai](https://artificialanalysis.ai).
## Tools
### `list_models`
List all available LLM models with optional filtering and sorting.
**Parameters:**
| Name | Type | Required | Description |
|------|------|----------|-------------|
| `creator` | string | No | Filter by model creator (e.g., "OpenAI", "Anthropic") |
| `sort_by` | string | No | Sort field (see below) |
| `sort_order` | string | No | "asc" or "desc" (default: "desc") |
| `limit` | number | No | Maximum results to return |
**Sort fields:** `price_input`, `price_output`, `price_blended`, `speed`, `ttft`, `intelligence_index`, `coding_index`, `math_index`, `mmlu_pro`, `gpqa`, `release_date`
**Example usage:**
- "List the top 5 fastest models"
- "Show me Anthropic models sorted by price"
- "What are the cheapest models with high intelligence scores?"
### `get_model`
Get detailed information about a specific model.
**Parameters:**
| Name | Type | Required | Description |
|------|------|----------|-------------|
| `model` | string | Yes | Model name or slug (e.g., "gpt-4o", "claude-4-5-sonnet") |
**Returns:** Complete model details including pricing, speed metrics, and all benchmark scores.
**Example usage:**
- "Get pricing for GPT-4o"
- "What are Claude 4.5 Sonnet's benchmark scores?"
## Model Data
Each model includes:
- **Pricing**: Input/output/blended rates per 1M tokens (USD)
- **Speed**: Output tokens per second, time to first token
- **Benchmarks**: Intelligence Index, Coding Index, Math Index, MMLU-Pro, GPQA, LiveCodeBench, and more
## Development
```bash
# Install dependencies
npm install
# Build
npm run build
# Run locally
AA_API_KEY=your-key node dist/index.js
```
## License
MIT
