# Agentql MCP (MCP server)

> Agentql MCP is an MCP server that integrates AgentQL's data extraction capabilities. It has 181 GitHub stars, is released under the MIT license and runs locally with npx -y agentql-mcp. It works with Claude Desktop, Claude Code, Cursor and VS Code and needs an API key.

This is a Model Context Protocol (MCP) server that integrates AgentQL's data extraction capabilities. 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.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/tinyfish-io/agentql-mcp |
| GitHub stars | 181 |
| License | MIT |
| Language | TypeScript |
| Transport | stdio |
| Packages | npm: agentql-mcp |
| Remote URL | none |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Other |
| Latest release | v1.0.0 (Mar 13, 2025) |
| Last commit | Oct 22, 2026 |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "agentql-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "agentql-mcp"
      ],
      "env": {
        "AGENTQL_API_KEY": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env AGENTQL_API_KEY=your-value --transport stdio agentql-mcp -- npx -y agentql-mcp
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "agentql-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "agentql-mcp"
      ],
      "env": {
        "AGENTQL_API_KEY": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "agentql_api_key",
      "description": "AGENTQL_API_KEY",
      "password": true
    }
  ],
  "servers": {
    "agentql-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "agentql-mcp"
      ],
      "env": {
        "AGENTQL_API_KEY": "${input:agentql_api_key}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `AGENTQL_API_KEY` (secret): Shown in the README's example configuration.

## Similar MCP servers

- [MCP Slim Guard](https://appsgit.com/mcp-servers/mcp-slim-guard): 76% fewer MCP tokens in our standard benchmark. (182 stars, MIT)
- [Shodan](https://appsgit.com/mcp-servers/shodan): MCP server for Shodan API — device search, IP lookup, DNS, and CVE/CPE queries. (178 stars, MIT, needs API key)
- [Illustrator MCP Server](https://appsgit.com/mcp-servers/illustrator-mcp-server): Adobe Illustrator MCP with 66 tools — more than the official Illustrator MCP. (183 stars, MIT)
- [Hostinger API MCP](https://appsgit.com/mcp-servers/hostinger-api-mcp): Model Context Protocol (MCP) server for Hostinger API. (164 stars, MIT, official)
- [EasyEDA Copilot](https://appsgit.com/mcp-servers/easyeda-copilot): AI tools for EasyEDA Pro schematics, PCB placement and routing, SPICE simulation, and DRC. (187 stars, MIT)
- [Pubmed MCP Server](https://appsgit.com/mcp-servers/pubmed-mcp-server): Search PubMed/Europe PMC, fetch articles and full text (PMC/EPMC/Unpaywall), citations, MeSH terms. (163 stars, Apache-2.0, needs API key)

---

Canonical page: https://appsgit.com/mcp-servers/agentql-mcp
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed daily.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.