AgentQL MCP

Add to your client

Copy the config for your MCP client and paste it into its config file.

{
  "mcpServers": {
    "agentql-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "agentql-mcp"
      ],
      "env": {
        "AGENTQL_API_KEY": "<your-agentql-api-key>"
      }
    }
  }
}

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

• Node.js with npm (run via `npx -y agentql-mcp` or install globally)
• An AgentQL API key from the AgentQL Dev Portal (https://dev.agentql.com) set as AGENTQL_API_KEY
• An MCP-compatible client (Claude Desktop, Cursor, VS Code, or Windsurf)

About AgentQL MCP

Tools & capabilities (1)

When to use it

• Use it when you need structured data (price, title, specs, reviews) from a product or listing page without writing selectors.
• Use it when an agent must read a page and return clean JSON fields described in plain English.
• Use it when target sites change layout often and you want prompt-driven extraction instead of brittle scrapers.
• Use it when prototyping a scraping workflow quickly inside Claude, Cursor, or another MCP client.
• Use it when you want a single, low-maintenance extraction tool rather than a full crawling framework.

Quick setup

1. 1Sign up at the AgentQL Dev Portal (dev.agentql.com) and create an API key.
2. 2Add the server to your client config with command `npx` and args `-y agentql-mcp`.
3. 3Set the `AGENTQL_API_KEY` environment variable in the server's env block.
4. 4Restart your MCP client so it picks up the new server.
5. 5Verify by asking the agent to extract fields from a sample URL; add a hint like "use the agentql tool" if it doesn't fire.

AgentQL MCP FAQ