# verIdyia/autoeq-mcp [Health: Active]

**Category:** 🎥 Multimedia Process  
**Repository:** https://github.com/verIdyia/autoeq-mcp  
**GitHub Stars:** 4  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/veridyia-autoeq-mcp

## Description
Headphone/IEM equalization database with 8,800+ models from AutoEQ. Search by name or sound signature, get parametric EQ settings, compare headphones band-by-band, and browse Harman preference score rankings. Includes automatic sound signature classification (Neutral, Warm, Bright, Dark, V-shaped, etc.).

## Tools
Capabilities this server exposes over MCP:

- **eq_search** — Search by name, type (over-ear/in-ear/earbud), sound signature, or measurement source
- **eq_profile** — Get full EQ profile — parametric EQ, fixed band EQ, per-band analysis with visual bars
- **eq_compare** — Side-by-side comparison of two headphones across all frequency bands
- **eq_recommend** — Recommendations by preference (neutral, warm, bright, bass, vocal, fun, analytical)
- **eq_ranking** — Harman headphone listener preference score rankings
- **eq_targets** — List all 61 available target curves (Harman, Diffuse Field, etc.)
- **eq_sync** — Pull latest data from AutoEQ GitHub and rebuild the database

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "autoeq-mcp": {
    "command": "uvx",
    "args": ["autoeq-mcp"],
    "env": {
      "AUTOEQ_DATA_DIR": "",
      "AUTOEQ_MCP_PORT": "",
      "AUTOEQ_MCP_HOST": "",
      "AUTOEQ_MCP_ALLOWED_HOSTS": ""
    }
  }
}
```

**Requires environment variables:** `AUTOEQ_DATA_DIR`, `AUTOEQ_MCP_PORT`, `AUTOEQ_MCP_HOST`, `AUTOEQ_MCP_ALLOWED_HOSTS` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What verIdyia/autoeq-mcp MCP server does

The verIdyia/autoeq-mcp MCP server exposes AutoEQ data for headphones, IEMs, and earbuds through MCP tools. Its dataset contains more than 8,800 profiles from 22 measurement sources, along with 61 target curves and more than 2,300 Harman preference scores.

Search can be narrowed by product name, device type, sound signature, or measurement source. A profile includes parametric EQ settings, fixed-band EQ values, the measurement source, Harman score where available, and an analysis of frequency-response deviation across eight bands. Signature labels include Neutral, Warm, Bright, Dark, V-shaped, U-shaped, Bass-heavy, Mid-forward, and Harman-like.

## How it works

The server keeps a local SQLite database built from the AutoEQ repository. During analysis, frequency-response errors are grouped into eight ranges, including sub-bass, bass, mids, presence, and air. Those deviations support both the signature classification and the visual per-band output returned for a profile.

The available MCP tools cover several workflows:

- `eq_search` finds matching headphones and IEMs.
- `eq_profile` returns full EQ and band-analysis details.
- `eq_compare` compares two products across frequency bands.
- `eq_recommend` filters recommendations by preferences such as neutral, warm, bright, bass, vocal, fun, or analytical.
- `eq_ranking` retrieves Harman listener-preference rankings.
- `eq_targets` lists the available target curves.
- `eq_sync` downloads current AutoEQ data and rebuilds the local database.

## Setup and configuration

Install the Python package with `pip install autoeq-mcp`. An initial `autoeq-mcp --sync` operation clones the AutoEQ repository and builds the SQLite database. The server can then run over stdio, including through Claude Desktop, or in SSE mode for remote or multi-client use.

For Claude Desktop, configure the server command as `autoeq-mcp`. Claude Code can add the same executable as an MCP server. The verIdyia/autoeq-mcp MCP server also supports source installation with `pip install -e .` after cloning the repository.

Configuration is controlled through environment variables. `AUTOEQ_DATA_DIR` changes the location of the repository clone and database. SSE deployments can set `AUTOEQ_MCP_PORT`, `AUTOEQ_MCP_HOST`, and `AUTOEQ_MCP_ALLOWED_HOSTS`; the latter accepts a comma-separated host list.

## Limitations and notes

Results depend on the measurements and target curves supplied by AutoEQ. The source data comes from the upstream AutoEQ project, and updates are not automatic unless `eq_sync` or the command-line sync operation is run. The server provides EQ and analysis data; the supplied material does not indicate that it applies EQ changes directly to operating systems, players, or headphones.

The verIdyia/autoeq-mcp MCP server is released under the MIT license. No API credentials or paid external service are described in the supplied material.

_Full upstream README: https://allmcps.com/mcp/veridyia-autoeq-mcp/readme_