Log inSubmit server
Agentql MCP logo

Agentql MCP

by tinyfish-io

Extracts structured data from web pages by sending a URL and field-focused prompt to AgentQL.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Agentql MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "tinyfish-io-agentql-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "agentql-mcp"
      ],
      "env": {
        "AGENTQL_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y agentql-mcp

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

The tinyfish-io/agentql-mcp MCP server exposes AgentQL web data extraction through MCP. Its `extract-web-data` tool accepts a page URL and a prompt describing the fields or records to collect, then extracts structured results from that page. It requires an AgentQL API key and runs locally over stdio through the `agentql-mcp` npm package. Reach for it when an MCP-compatible agent needs to turn web page content into structured data.

Use cases

  • Extract fields from web search results
  • Collect structured records from a page
  • Describe target fields in a natural-language prompt
  • Exclude unwanted items such as advertisements

Key features

  • Structured web data extraction
  • URL and prompt-based requests
  • Single MCP tool: extract-web-data
  • stdio execution through npm
  • AgentQL API key authentication

Tools1

What Agentql MCP lets your agent do. Expand a tool for its parameters.

Self-reported~33 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

19/20 checks healthy over the last 80d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10d ago via OSV.dev · agentql-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars181Stargazers on the source repository.
npm downloads811Package downloads in the last 30 days.
Last commit7d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed1Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Agentql MCP works

What tinyfish-io/agentql-mcp does

The tinyfish-io/agentql-mcp MCP server connects an MCP client to AgentQL's web data extraction capability. It provides one tool, extract-web-data, for requesting structured information from a specified web page.

A tool call includes a url and a prompt. The URL identifies the page to inspect, while the prompt describes the data to extract and the fields each result should contain. For example, an agent can ask for video titles, authors, view counts, and links from a search results page, while excluding advertisement items.

This fits workflows where an agent needs page-level data in a structured form rather than only a text summary. The repository does not document additional tools for navigation, browser control, writing data to another system, or general-purpose web search.

How it works

The server communicates with MCP clients over standard input and output. An MCP-compatible application starts the local agentql-mcp process, and the process exposes extract-web-data to the agent. The server uses the configured AgentQL credential when handling extraction requests.

The extraction request is expressed in natural language through the prompt. Developers can state which records to return, which fields to include, and which items to leave out. The README recommends explicitly telling the agent to use the AgentQL tool if it attempts to open URLs or load web content without invoking the server.

The tinyfish-io/agentql-mcp repository documents configuration examples for Claude Desktop, VS Code, Cursor, and Windsurf. Only Claude Desktop, Cursor, and Windsurf are listed as compatible clients in this directory's client taxonomy.

Setup and configuration

Install the npm package globally with npm install -g agentql-mcp, or configure an MCP client to start it with npx -y agentql-mcp. An AgentQL API key is required and can be obtained from the AgentQL developer portal.

Set the key in the AGENTQL_API_KEY environment variable. Claude Desktop, VS Code, and Windsurf examples place that variable in the server configuration. Cursor's documented command also supplies the variable before starting the package. Keep the value out of shared configuration files where possible; the README's VS Code setup supports a password-style input for the key.

For a typical stdio configuration, the relevant shape is:

config.json
{
  "command": "npx",
  "args": ["-y", "agentql-mcp"],
  "env": {
    "AGENTQL_API_KEY": "your-key"
  }
}

The development workflow uses npm install, npm run build, and npm run watch. The repository also documents npm run inspector for launching the MCP Inspector during debugging.

Tools and capabilities

  • extract-web-data: extracts structured data from a URL according to a natural-language field description.
  • Accepts prompts that define the expected data fields.
  • Can be used for lists of records, such as search results, when the requested page exposes those records.
  • Supports MCP clients configured to launch the server through npm and stdio.

Limitations and notes

The documented interface contains one extraction tool; there is no material here supporting separate tools for clicking, form submission, crawling multiple pages, or exporting results.

The tinyfish-io/agentql-mcp server is intended to be selected explicitly by the agent for web extraction.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Agentql MCP

Install the npm package with `npm install -g agentql-mcp`, or configure an MCP client to run `npx -y agentql-mcp`.

It requires an AgentQL API key from the AgentQL developer portal, provided through the `AGENTQL_API_KEY` environment variable.

It provides `extract-web-data`, which takes a URL and a prompt describing the data fields to extract.

Yes. The README provides Claude Desktop configuration using `npx -y agentql-mcp` and `AGENTQL_API_KEY`.

Yes. The README includes configuration instructions for both Cursor and Windsurf.

Related MCP servers

All in Search & Data Extraction All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewAgentql MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/tinyfish-io-agentql-mcp?style=directory)](https://allmcps.com/mcp/tinyfish-io-agentql-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/tinyfish-io-agentql-mcp"><img src="https://allmcps.com/api/badge/tinyfish-io-agentql-mcp?style=directory" alt="Agentql MCP on AllMCPs" /></a>