MCP Directory

How to add AgentQL MCP to Cursor

Turn any web page into structured data — AgentQL's prompt-driven extraction as a single MCP tool. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 15, 2026 · 400★ · stdio · apikey · official

Cursor config for AgentQL MCP

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

Setup steps

  1. 1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the AgentQL MCP config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of AgentQL MCP's tools to confirm it's connected.

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)

What AgentQL MCP can do in Cursor

extract-web-data

Extract structured data from a given URL, using a natural-language prompt to describe the fields to extract.

Security

Needs an AGENTQL_API_KEY that bills against your AgentQL account; store it in env and rotate if leaked. Pages are fetched and parsed through AgentQL's service, and extracted data flows back to your model as untrusted content.

AgentQL MCP + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the AgentQL MCP config there under the "mcpServers" key and restart the client.

Is AgentQL MCP safe to use with Cursor?

Needs an AGENTQL_API_KEY that bills against your AgentQL account; store it in env and rotate if leaked. Pages are fetched and parsed through AgentQL's service, and extracted data flows back to your model as untrusted content.

How do I authenticate?

Create an API key in the AgentQL Dev Portal and pass it as the AGENTQL_API_KEY environment variable in your MCP client's server config.

What tools does it expose?

Just one: `extract-web-data`, which takes a `url` and a `prompt` describing the data and fields to extract, and returns structured data.

The agent isn't calling AgentQL — what do I do?

Add an explicit hint to your prompt such as "use tools" or "use the agentql tool" so the model invokes the extraction tool.

View repo Full AgentQL MCP page