AutoEQ MCP Server

Instructions

Implementation Reference

• autoeq_mcp.py:719-744 (handler)

  The eq_profile handler function retrieves EQ data for a specific headphone from the database and returns a formatted string profile.

  async def eq_profile(
      name: str = Field(..., description="Headphone/IEM model name (e.g., HIFIMAN HE400se, Sony WF-1000XM5)"),
      source: str = Field(
          default="",
          description="Measurement source (e.g., oratory1990). Empty = best scored source",
      ),
  ) -> str:
      """Get detailed EQ profile for a headphone. Includes parametric EQ, fixed band EQ, and per-band sound analysis."""
      conn = get_db()
      hp = _find_headphone(conn, name, source)
  
      if not hp:
          conn.close()
          return f"'{name}' not found. Try eq_search to find the correct name."
  
      peq = conn.execute(
          "SELECT * FROM parametric_eq WHERE headphone_id = ? ORDER BY filter_num",
          (hp["id"],),
      ).fetchall()
      fbeq = conn.execute(
          "SELECT * FROM fixed_band_eq WHERE headphone_id = ? ORDER BY filter_num",
          (hp["id"],),
      ).fetchall()
      conn.close()
  
      return format_profile(hp, peq, fbeq)

• autoeq_mcp.py:709-718 (registration)

  The eq_profile tool is registered with the MCP server using the @mcp_server.tool decorator.

  @mcp_server.tool(
      name="eq_profile",
      annotations={
          "title": "Get EQ profile",
          "readOnlyHint": True,
          "destructiveHint": False,
          "idempotentHint": True,
          "openWorldHint": False,
      },
  )