AutoEQ MCP Server

Instructions

Implementation Reference

• autoeq_mcp.py:896-924 (handler)

  The eq_targets tool handler, which queries the database for target curves and formats them by category.

  async def eq_targets() -> str:
      """List all available EQ target curves (Harman, Diffuse Field, etc.)."""
      conn = get_db()
      rows = conn.execute("SELECT name FROM targets ORDER BY name").fetchall()
      conn.close()
  
      if not rows:
          return "No target data. Run eq_sync first."
  
      lines = ["## Available target curves"]
      categories = {"Harman": [], "Diffuse Field": [], "AutoEq": [], "Other": []}
      for r in rows:
          name = r["name"]
          if "Harman" in name or "harman" in name:
              categories["Harman"].append(name)
          elif "Diffuse" in name:
              categories["Diffuse Field"].append(name)
          elif "AutoEq" in name:
              categories["AutoEq"].append(name)
          else:
              categories["Other"].append(name)
  
      for cat, names in categories.items():
          if names:
              lines.append(f"\n### {cat}")
              for n in names:
                  lines.append(f"- {n}")
  
      return "\n".join(lines)

• autoeq_mcp.py:886-895 (registration)

  Registration of the eq_targets tool using the mcp_server.tool decorator.

  @mcp_server.tool(
      name="eq_targets",
      annotations={
          "title": "List target curves",
          "readOnlyHint": True,
          "destructiveHint": False,
          "idempotentHint": True,
          "openWorldHint": False,
      },
  )