AgentQL MCP Server

Official AgentQL MCP server: extracts structured data from a web page based on a field description

MCP serverMedium risk

tinyfish-io/agentql-mcp

Install

{
  "mcpServers": {
    "agentql": {
      "command": "npx",
      "args": ["-y", "agentql-mcp"],
      "env": {
        "AGENTQL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

The same snippet works for Windsurf in ~/.codeium/windsurf/mcp_config.json.

This is third-party code. Review the repository files before installing.

What it does

The server gives the agent a single extract-web-data tool. The agent passes a page URL and a description of the data it needs, such as a product list with names and prices, and AgentQL returns it in structured form. The AgentQL cloud service loads and parses the page, so the agent needs no browser of its own. It fits tables from catalogs, search results and lists of posts.

Who it is for. For analysts, marketers and developers who need page data quickly without writing a scraper.

Good fit when

  • You need a table of products, prices or articles from a specific page
  • The agent cannot open the page with a plain request
  • You need a one-off data pull without writing a scraper

Not a fit when

  • You need scheduled crawling of a whole site
  • The data must not pass through a third-party cloud service

Example request

Extract the job list from this page: title, company, city and link, as a table

Limitations

Requires an AgentQL API key from the Dev Portal; requests are processed in the AgentQL cloud and use account quota. There is one tool, with no navigation or clicks. Sometimes you need to tell the agent explicitly to use the AgentQL tool. Access from Russia is unverified.

How to disable. Remove the agentql block from the MCP config and restart the client. npm uninstall -g agentql-mcp removes the global package.

MCP

Transport
stdio
Authentication
API key
Environment variables
Environment variables
AGENTQL_API_KEY
required, secret
Key from the AgentQL Dev Portal

Security check

  • Sends URLs and prompts to the AgentQL cloud service
  • Keeps an API key in the client config

README in short

The README describes the server's single tool and npm installation. It gives configs for Claude Desktop, VS Code, Cursor and Windsurf with the key in AGENTQL_API_KEY. It includes a sample test prompt and debugging tips with MCP Inspector. MIT licensed.

FAQ

The agent says it cannot open the URL. What now?

Add a hint to use the agentql tool in your request, as the README suggests.

Editors’ pick

CLI, skill and Python library for browser control: the agent clicks, fills forms and reads pages over CDP

CLIHigh risk114.6K
Editors’ pick

A skill that gathers the last 30 days of discussion on a topic from Reddit, X, YouTube, HN, Polymarket and GitHub into one brief

SkillHigh risk62K
Editors’ pick

The Chrome DevTools team's official MCP server: the agent drives a live Chrome, reads network and console, and records performance traces

MCP serverMedium risk52K
Editors’ pick

A fast Rust CLI for agent browser automation: accessibility snapshots with element refs, an MCP server and skills

CLIHigh risk42.6K