MCP server
by tinyfish-io
AgentQL lets you scrape any website and extract structured data to JSON easily—no custom web scraping code needed.
Extracts structured data from any web page using plain English descriptions instead of writing custom scraping code. Returns clean JSON data based on what you ask for.
AgentQL is an official MCP server published by tinyfish-io that provides AI assistants with tools and capabilities via the Model Context Protocol. AgentQL lets you scrape any website and extract structured data to JSON easily—no custom web scraping code needed. It is categorized under search web.
You can install AgentQL in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.
MIT
AgentQL is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.
Fetch and extract information from websites automatically
Example
Research competitor pricing, scrape product reviews, monitor news mentions
Automate 5-10 hours/week of manual web research
Track website changes, new content, price updates
Example
Monitor competitor blog for new posts, track stock availability, watch for pricing changes
Stay informed without manual checking, never miss important updates
Extract structured data from multiple websites
Example
Compile product listings from 10 e-commerce sites, aggregate job postings, collect real estate data
Build datasets 100x faster than manual copying
Share your MCP server with the developer community
We wired AgentQL into a staging workspace; the listing’s GitHub and npm pointers saved time versus hunting across READMEs.
According to our notes, AgentQL benefits from clear Model Context Protocol framing — fewer ambiguous “AI plugin” claims.
AgentQL is a well-scoped MCP server in the explainx.ai directory — install snippets and categories matched our Claude Code setup.
AgentQL is among the better-indexed MCP projects we tried; the explainx.ai summary tracks the official description.
AgentQL is a well-scoped MCP server in the explainx.ai directory — install snippets and categories matched our Claude Code setup.
AgentQL is among the better-indexed MCP projects we tried; the explainx.ai summary tracks the official description.
Strong directory entry: AgentQL surfaces stars and publisher context so we could sanity-check maintenance before adopting.
AgentQL is a well-scoped MCP server in the explainx.ai directory — install snippets and categories matched our Claude Code setup.
I recommend AgentQL for teams standardizing on MCP; the explainx.ai page compares cleanly with sibling servers.
AgentQL has been reliable for tool-calling workflows; the MCP profile page is a good permalink for internal docs.
showing 1-10 of 40
This is a Model Context Protocol (MCP) server that integrates AgentQL's data extraction capabilities.
extract-web-data - extract structured data from a given 'url', using 'prompt' as a description of actual data and its fields to extract.To use AgentQL MCP Server to extract data from web pages, you need to install it via npm, get an API key from our Dev Portal, and configure it in your favorite app that supports MCP.
npm install -g agentql-mcp
⌘+, (don't confuse with Claude Account Settings)claude_desktop_config.json fileagentql server inside mcpServers dictionary in the config file{
"mcpServers": {
"agentql": {
"command": "npx",
"args": ["-y", "agentql-mcp"],
"env": {
"AGENTQL_API_KEY": "YOUR_API_KEY"
}
}
}
}
Read more about MCP configuration in Claude here.
For one-click installation, click one of the install buttons below:
Click the install buttons at the top of this section for the quickest installation method. For manual installation, follow these steps:
Add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing Ctrl + Shift + P and typing Preferences: Open User Settings (JSON).
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "apiKey",
"description": "AgentQL API Key",
"password": true
}
],
"servers": {
"agentql": {
"command": "npx",
"args": ["-y", "agentql-mcp"],
"env": {
"AGENTQL_API_KEY": "${input:apiKey}"
}
}
}
}
}
Optionally, you can add it to a file called .vscode/mcp.json in your workspace. This will allow you to share the configuration with others.
{
"inputs": [
{
"type": "promptString",
"id": "apiKey",
"description": "AgentQL API Key",
"password": true
}
],
"servers": {
"agentql": {
"command": "npx",
"args": ["-y", "agentql-mcp"],
"env": {
"AGENTQL_API_KEY": "${input:apiKey}"
}
}
}
}
env AGENTQL_API_KEY=YOUR_API_KEY npx -y agentql-mcpRead more about MCP configuration in Cursor here.
~/.codeium/windsurf/mcp_config.json directlyagentql server inside mcpServers dictionary in the config file{
"mcpServers": {
"agentql": {
"command": "npx",
"args": ["-y", "agentql-mcp"],
"env": {
"AGENTQL_API_KEY": "YOUR_API_KEY"
}
}
}
}
Read more about MCP configuration in Windsurf here.
Give your agent a task that will require extracting data from the web. For example:
Extract the list of videos from the page https://www.youtube.com/results?search_query=agentql, every video should have a title, an author name, a number of views and a url to the video. Make sure to exclude ads items. Format this as a markdown table.
[!TIP] In case your agent complains that it can't open urls or load content from the web instead of using AgentQL, try adding "use tools" or "use agentql tool" hint.
Install dependencies:
npm install
Build the server:
npm run build
For development with auto-rebuild:
npm run watch
If you want to try out development version, you can use the following config instead of the default one:
{
"mcpServers": {
"agentql": {
"command": "/path/to/agentql-mcp/dist/index.js",
"env": {
"AGENTQL_API_KEY": "YOUR_API_KEY"
}
}
}
}
[!NOTE] Don't forget to remove the default AgentQL MCP server config to not confuse Claude with two similar servers.
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
npm run inspector
The Inspector will provide a URL to access debugging tools in your browser.
Interact with services that don't offer APIs
Example
Check form submissions, validate website functionality, test user flows
Automate interactions with any website, even without API
Prerequisites
Time Estimate
20-40 minutes including configuration and testing
Steps
Troubleshooting
✓ Do
✗ Don't
💡 Pro Tips
Architecture
MCP server handles HTTP requests, HTML parsing, JavaScript rendering (if headless browser), and returns structured data to Claude.
Protocols
Compatibility
✓ Use when
Use for research automation, content monitoring, data aggregation from multiple sources, and when official APIs don't exist. Best for read-only information gathering.
✗ Avoid when
Avoid for sites with APIs (use API instead), sites that explicitly forbid scraping, when data is copyrighted, or for login-required content without proper authorization.