Autoeq MCP

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.