1. Home
  2. AgentQL MCP Server
  3. AgentQL MCP Server for Claude Desktop: Setup & Config

Data as of

AgentQL MCP Server for Claude Desktop: Setup & Config

Claude Desktop: AgentQL MCP Server extracts structured JSON from a web page using a natural-language description of the desired fields.

What you can do with AgentQL in Claude Desktop

A compact URL-and-prompt interface for turning web pages into structured JSON inside MCP workflows.

  • Extract named fields from a page into JSON.
  • Collect video-result metadata as illustrated in the README.

Before you start: AgentQL in Claude Desktop

  • Node.js with npm / npx
  • AgentQL API key
  • An MCP-compatible host

The README also documents npm install -g agentql-mcp. Restart the host after adding its configuration. Development builds should replace, rather than duplicate, the default server entry.

AgentQL Claude Desktop configuration

  1. Choose Claude Desktop configuration scope

    For AgentQL MCP Server, open macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json. Merge under mcpServers via Settings → Developer → Edit Config when available.

  2. Add AgentQL MCP Server to Claude Desktop

    Use the agentql-mcp entry below in mcpServers. Keep AgentQL MCP Server's documented stdio connection fields and your other Claude Desktop entries.

  3. Check AgentQL MCP Server in Claude Desktop

    AgentQL MCP Server: Fully quit and reopen Claude Desktop; check developer diagnostics.

Config file · macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

JSON
{
  "mcpServers": {
    "agentql-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "agentql-mcp"
      ],
      "env": {
        "AGENTQL_API_KEY": "<API key from the AgentQL developer portal>"
      }
    }
  }
}

AgentQL tools available to Claude Desktop

AgentQL's stored tool list documents 1 tool; compare it with Claude Desktop's connected tool list, because the stored list is not a live check.

extract-web-data

When Claude Desktop requests extract-web-data from AgentQL, review the action before approving it.

Extract JSON fields from a page URL using a natural-language description.

AgentQL: full stored tool descriptions

Troubleshooting AgentQL in Claude Desktop

  • Fully quit and reopen Claude Desktop for AgentQL MCP Server. If npx agentql-mcp (Node.js/npm) is missing, check the desktop process's PATH, which may differ from your terminal.
  • In Claude Desktop's AgentQL MCP Server entry, check AGENTQL_API_KEY. Keep secrets out of shared screenshots and repositories.
  • AgentQL MCP Server uses stdio here: Claude Desktop must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
  • Known limitation: Requires an AgentQL API key.
  • Known limitation: Only one extraction tool is documented.
  • Known limitation: Pricing and usage limits are not stated in the README.
  • General Claude Desktop troubleshooting lives in the /clients/claude-desktop guide.

AgentQL MCP Server — details. Claude Desktop guide

Frequently asked questions

Claude Desktop loads AgentQL MCP Server from claude_desktop_config.json: ~/Library/Application Support/Claude/ on macOS, or %APPDATA%\Claude\ on Windows. Open it via Settings → Developer → Edit Config when available.

Claude Desktop's agentql-mcp example uses stdio.

AgentQL MCP Server's Claude Desktop configuration invokes npx agentql-mcp (Node.js/npm).

Claude Desktop's AgentQL MCP Server example references AGENTQL_API_KEY. Check these names if startup or authentication fails; the example alone does not distinguish required from optional values.

AgentQL MCP Server's stored list contains 1 tool, including extract-web-data. Compare those names with Claude Desktop's connected tool list; the stored list is not a live check.

The tool accepts a page URL and a prompt describing the desired data and fields.

The supplied tool facts identify structured JSON output.

The README directs users to the AgentQL developer portal at https://dev.agentql.com.