AgentQL MCP Server
Official AgentQL MCP server: extracts structured data from a web page based on a field description
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 tableLimitations
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 | |
|---|---|
| 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.
Related
CLI, skill and Python library for browser control: the agent clicks, fills forms and reads pages over CDP
A skill that gathers the last 30 days of discussion on a topic from Reddit, X, YouTube, HN, Polymarket and GitHub into one brief
The Chrome DevTools team's official MCP server: the agent drives a live Chrome, reads network and console, and records performance traces
A fast Rust CLI for agent browser automation: accessibility snapshots with element refs, an MCP server and skills