AgentQL

AgentQL

Enable AI agents to get structured data from unstructured web with AgentQL.

123
Stars
29
Forks
1
Releases

Overview

This MCP server exposes AgentQL's data-extraction capabilities as a reusable tool called extract-web-data. It enables clients to obtain structured data from unstructured web content by supplying a URL and a prompt that describes the data and fields to extract. The server is installable via npm (npm install -g agentql-mcp) and requires an AGENTQL_API_KEY for authentication, configured in the hosting environment or within IDE-specific settings. The README provides multiple integration paths across popular MCP-enabled environments: Claude, VS Code, Cursor, and Windsurf. Each platform includes concrete configuration blocks or steps to register the agentql MCP server under a named entry (e.g., agentql) with the appropriate command, arguments, and environment variables. Manual installation options include JSON blocks for Claude desktop settings, VS Code user settings (mcp.json), and a shared workspace file (.vscode/mcp.json). A sample usage demonstrates extracting a list of YouTube videos with title, author, views, and URL, formatted as a markdown table. Development and debugging guidance include building, watching for changes, and using the MCP Inspector for debugging over stdio.

Details

Owner
tinyfish-io
Language
JavaScript
License
MIT License
Updated
2025-12-07

Features

extract-web-data tool

A dedicated MCP tool that extracts structured data from a provided URL using a prompt describing the data and fields to extract.

Cross-platform MCP configuration

Guides to configure the AgentQL MCP server across Claude, VS Code, Cursor, and Windsurf for seamless integration.

Manual and JSON-based MCP configuration

JSON blocks and guides for Claude desktop settings, VS Code mcp.json, and workspace sharing to configure agentql as an MCP server.

API key authentication

Uses AGENTQL_API_KEY to authorize requests, typically supplied via environment variables in various configurations.

Development and debugging workflow

Build, watch/rebuild, and debug using the MCP Inspector to troubleshoot MCP server interactions.

Tags

AgentQLMCPweb data extractionstructured dataextract-web-datanpmAPI keyClaudeVS CodeCursorWindsurf