{"_id":"agentql-mcp","_rev":"5-c6ea35a29ff89b11c8b59f2271f23ff7","name":"agentql-mcp","dist-tags":{"latest":"1.0.1"},"versions":{"0.0.1":{"name":"agentql-mcp","version":"0.0.1","keywords":["mcp","agentql","data-extraction","web-scraping","content-extraction"],"license":"MIT","_id":"agentql-mcp@0.0.1","maintainers":[{"name":"tinyfish-agentql","email":"js-sdk-developers@tinyfish.io"}],"homepage":"https://github.com/tinyfish-io/mcp-agentql#readme","bugs":{"url":"https://github.com/tinyfish-io/mcp-agentql/issues"},"bin":{"agentql-mcp":"dist/index.js"},"dist":{"shasum":"c81d2638ea56edaa1fa66db1b667e20bb9527d81","tarball":"https://registry.npmjs.org/agentql-mcp/-/agentql-mcp-0.0.1.tgz","fileCount":4,"integrity":"sha512-rhwvCEgDpFdksgwYyRezZCHzNyepUrdGUSkij0i/m/PWTXxPcUA5sJTz2QvctpnTup8lAkhrdjiyPRG4ztKMaA==","signatures":[{"sig":"MEYCIQC7x8Nx7e0+WmCeFzhZe4oCv4PQ8vUMdfQw3+nmwdzRkgIhAN5ueUENySQkdYf+92Yxu+L28CiejmeqOiW+dGbM3t1M","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8971},"type":"module","gitHead":"fa53e5e778d51abad93de8bfcc0d72fb0d4a6841","scripts":{"build":"tsc && node -e \"require('fs').chmodSync('dist/index.js', '755')\"","watch":"tsc --watch","prepare":"npm run build","inspector":"npx @modelcontextprotocol/inspector dist/index.js"},"_npmUser":{"name":"tinyfish-agentql","email":"js-sdk-developers@tinyfish.io"},"repository":{"url":"git+https://github.com/tinyfish-io/mcp-agentql.git","type":"git"},"_npmVersion":"10.9.2","description":"Model Context Protocol (MCP) server that integrates AgentQL data extraction capabilities.","directories":{},"_nodeVersion":"23.7.0","dependencies":{"node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"1.6.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.24","@types/node-fetch":"^2.6.12"},"_npmOperationalInternal":{"tmp":"tmp/agentql-mcp_0.0.1_1741714598143_0.33156709220250646","host":"s3://npm-registry-packages-npm-production"}},"0.0.2":{"name":"agentql-mcp","version":"0.0.2","keywords":["mcp","agentql","data-extraction","web-scraping","content-extraction"],"license":"MIT","_id":"agentql-mcp@0.0.2","maintainers":[{"name":"tinyfish-agentql","email":"js-sdk-developers@tinyfish.io"}],"homepage":"https://github.com/tinyfish-io/mcp-agentql#readme","bugs":{"url":"https://github.com/tinyfish-io/mcp-agentql/issues"},"bin":{"agentql-mcp":"dist/index.js"},"dist":{"shasum":"dd6fc0df0c5140fa1ffbe4a8fa6727bf5b93b780","tarball":"https://registry.npmjs.org/agentql-mcp/-/agentql-mcp-0.0.2.tgz","fileCount":4,"integrity":"sha512-ecILiYKsFMamnNp5NvWf7OxFCSaT04DxZZB1rJtcBfK8n3et6s7LPej56tVlFX7wOdl0kMtSeatN0anS14eJzA==","signatures":[{"sig":"MEUCIQDrWLTjnYQT8kn6Oy55EXCVIz43CAmdahVzBPnmXzezagIgEql4QyeNN2uIsNp0a2AN0tr2eVElbck0xp5mTUD8eEY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9661},"gitHead":"f29fe702852bf7476a6970933cdbd69d0a60c6e8","scripts":{"lint":"eslint --config .eslintrc.js src","build":"tsc && node -e \"require('fs').chmodSync('dist/index.js', '755')\"","watch":"tsc --watch","format":"prettier --write src","prepare":"npm run build","lint:fix":"npm run lint -- --fix","inspector":"npx @modelcontextprotocol/inspector dist/index.js"},"_npmUser":{"name":"tinyfish-agentql","email":"js-sdk-developers@tinyfish.io"},"repository":{"url":"git+https://github.com/tinyfish-io/mcp-agentql.git","type":"git"},"_npmVersion":"10.8.2","description":"Model Context Protocol (MCP) server that integrates AgentQL data extraction capabilities.","directories":{},"_nodeVersion":"20.18.3","dependencies":{"node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"1.6.1"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^8.57.0","prettier":"^3.4.2","typescript":"^5.3.3","@types/node":"^20.11.24","@types/node-fetch":"^2.6.12","eslint-config-prettier":"^9.1.0","@typescript-eslint/eslint-plugin":"^8.4.0","@trivago/prettier-plugin-sort-imports":"^4.3.0"},"_npmOperationalInternal":{"tmp":"tmp/agentql-mcp_0.0.2_1741801430837_0.8841124360198087","host":"s3://npm-registry-packages-npm-production"}},"1.0.0":{"name":"agentql-mcp","version":"1.0.0","keywords":["mcp","agentql","data-extraction","web-scraping","content-extraction"],"license":"MIT","_id":"agentql-mcp@1.0.0","maintainers":[{"name":"tinyfish-agentql","email":"js-sdk-developers@tinyfish.io"}],"homepage":"https://github.com/tinyfish-io/agentql-mcp#readme","bugs":{"url":"https://github.com/tinyfish-io/agentql-mcp/issues"},"bin":{"agentql-mcp":"dist/index.js"},"dist":{"shasum":"f22d88df23b49027e13a921153bf76d6b06c224e","tarball":"https://registry.npmjs.org/agentql-mcp/-/agentql-mcp-1.0.0.tgz","fileCount":4,"integrity":"sha512-bDDQK1efkr+xsMi+wrPmok/hPwBIgxi8wYQz1pE78Zr+Zzpw4JRTLDGIX8eoi80sBZvRCwqV1QEnp7iJ0FDTWQ==","signatures":[{"sig":"MEUCIG3ayDfOMO+3FDpYw6bbtcNL9ari0gXK7kTTB8rbnd1GAiEAtzkIl7g1WjZdwJy6mWtPAbPmpIRCtcVYXPTvj1KwvAo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9388},"type":"module","gitHead":"b3de3549406f56c0743d81b254baf5104a98beca","scripts":{"lint":"eslint src","build":"tsc && node -e \"require('fs').chmodSync('dist/index.js', '755')\"","watch":"tsc --watch","format":"prettier --write src","prepare":"npm run build","lint:fix":"npm run lint -- --fix","inspector":"npx @modelcontextprotocol/inspector dist/index.js"},"_npmUser":{"name":"tinyfish-agentql","email":"js-sdk-developers@tinyfish.io"},"repository":{"url":"git+https://github.com/tinyfish-io/agentql-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Model Context Protocol (MCP) server that integrates AgentQL data extraction capabilities.","directories":{},"_nodeVersion":"20.18.3","dependencies":{"node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"1.6.1"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^8.57.0","prettier":"^3.4.2","typescript":"^5.3.3","@types/node":"^20.11.24","@types/node-fetch":"^2.6.12","eslint-config-prettier":"^9.1.0","@typescript-eslint/eslint-plugin":"^8.4.0","@trivago/prettier-plugin-sort-imports":"^4.3.0"},"_npmOperationalInternal":{"tmp":"tmp/agentql-mcp_1.0.0_1741826345423_0.5136114379837766","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"agentql-mcp","version":"1.0.1","description":"Model Context Protocol (MCP) server that integrates AgentQL data extraction capabilities.","license":"MIT","repository":{"type":"git","url":"git+https://github.com/tinyfish-io/agentql-mcp.git"},"type":"module","bin":{"agentql-mcp":"dist/index.js"},"scripts":{"build":"tsc && node -e \"require('fs').chmodSync('dist/index.js', '755')\"","prepare":"npm run build","watch":"tsc --watch","inspector":"npx @modelcontextprotocol/inspector dist/index.js","lint":"eslint src","lint:fix":"npm run lint -- --fix","format":"prettier --write src"},"dependencies":{"@modelcontextprotocol/sdk":"^1","node-fetch":"^3.3.2"},"devDependencies":{"@trivago/prettier-plugin-sort-imports":"^4.3.0","@types/node":"^20.11.24","@types/node-fetch":"^2.6.12","@typescript-eslint/eslint-plugin":"^8.4.0","eslint":"^8.57.0","eslint-config-prettier":"^9.1.0","prettier":"^3.4.2","typescript":"^5.3.3"},"keywords":["mcp","agentql","data-extraction","web-scraping","content-extraction"],"gitHead":"affb3a5c5eb817beac6a1aaa86e0ecd8a012f937","_id":"agentql-mcp@1.0.1","bugs":{"url":"https://github.com/tinyfish-io/agentql-mcp/issues"},"homepage":"https://github.com/tinyfish-io/agentql-mcp#readme","_nodeVersion":"24.13.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-K2CsCfLysqSQ2iQTgLN2UGx/lrEdkpNKVsUa/+8fNseBHztn3W+jQ58ma/Vn2iCTZVcJ6PDAX+BFNcMI/IrciA==","shasum":"c6834a054476de1346ba8dd2d40a32b46ff006ad","tarball":"https://registry.npmjs.org/agentql-mcp/-/agentql-mcp-1.0.1.tgz","fileCount":4,"unpackedSize":11979,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/agentql-mcp@1.0.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQD5cDk97JWaVy+2N4N6q2Wd4r6ztzmVLppA+8v+ppcfrAIgSWAS79Se4TaH2rhrx6DhPKbM1IOOn7tUPPF4I5E7HVc="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:9e2e27b8-d585-4017-ae58-1cca067d6651"}},"directories":{},"maintainers":[{"name":"tinyfish-agentql","email":"js-sdk-developers@tinyfish.io"},{"name":"tinyfish-npm-owner","email":"npm-owner@tinyfish.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agentql-mcp_1.0.1_1771643274144_0.13670483535659983"},"_hasShrinkwrap":false}},"time":{"created":"2025-03-11T17:36:38.141Z","modified":"2026-02-21T03:07:54.621Z","0.0.1":"2025-03-11T17:36:38.302Z","0.0.2":"2025-03-12T17:43:50.995Z","1.0.0":"2025-03-13T00:39:05.603Z","1.0.1":"2026-02-21T03:07:54.301Z"},"bugs":{"url":"https://github.com/tinyfish-io/agentql-mcp/issues"},"license":"MIT","homepage":"https://github.com/tinyfish-io/agentql-mcp#readme","keywords":["mcp","agentql","data-extraction","web-scraping","content-extraction"],"repository":{"type":"git","url":"git+https://github.com/tinyfish-io/agentql-mcp.git"},"description":"Model Context Protocol (MCP) server that integrates AgentQL data extraction capabilities.","maintainers":[{"name":"tinyfish-agentql","email":"js-sdk-developers@tinyfish.io"},{"name":"tinyfish-npm-owner","email":"npm-owner@tinyfish.io"}],"readme":"# AgentQL MCP Server\n\nThis is a Model Context Protocol (MCP) server that integrates [AgentQL](https://agentql.com)'s data extraction capabilities.\n\n## Features\n\n### Tools\n\n- `extract-web-data` - extract structured data from a given 'url', using 'prompt' as a description of actual data and its fields to extract.\n\n## Installation\n\nTo 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](https://dev.agentql.com), and configure it in your favorite app that supports MCP.\n\n### Install the package\n\n```bash\nnpm install -g agentql-mcp\n```\n\n### Configure Claude\n\n- Open Claude Desktop **Settings** via `⌘`+`,` (don't confuse with Claude Account Settings)\n- Go to **Developer** sidebar section\n- Click **Edit Config** and open `claude_desktop_config.json` file\n- Add `agentql` server inside `mcpServers` dictionary in the config file\n- Restart the app\n\n```json title=\"claude_desktop_config.json\"\n{\n  \"mcpServers\": {\n    \"agentql\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"agentql-mcp\"],\n      \"env\": {\n        \"AGENTQL_API_KEY\": \"YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\nRead more about MCP configuration in Claude [here](https://modelcontextprotocol.io/quickstart/user).\n\n### Configure VS Code\n\nFor one-click installation, click one of the install buttons below:\n\n[![Install with NPX in VS Code](https://img.shields.io/badge/VS_Code-NPM-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=agentql&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22agentql-mcp%22%5D%2C%22env%22%3A%7B%22AGENTQL_API_KEY%22%3A%22%24%7Binput%3AapiKey%7D%22%7D%7D&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22apiKey%22%2C%22description%22%3A%22AgentQL+API+Key%22%2C%22password%22%3Atrue%7D%5D) [![Install with NPX in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-NPM-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=agentql&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22agentql-mcp%22%5D%2C%22env%22%3A%7B%22AGENTQL_API_KEY%22%3A%22%24%7Binput%3AapiKey%7D%22%7D%7D&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22apiKey%22%2C%22description%22%3A%22AgentQL+API+Key%22%2C%22password%22%3Atrue%7D%5D&quality=insiders)\n\n#### Manual Installation\n\nClick the install buttons at the top of this section for the quickest installation method. For manual installation, follow these steps:\n\nAdd 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)`.\n\n```json\n{\n  \"mcp\": {\n    \"inputs\": [\n      {\n        \"type\": \"promptString\",\n        \"id\": \"apiKey\",\n        \"description\": \"AgentQL API Key\",\n        \"password\": true\n      }\n    ],\n    \"servers\": {\n      \"agentql\": {\n        \"command\": \"npx\",\n        \"args\": [\"-y\", \"agentql-mcp\"],\n        \"env\": {\n          \"AGENTQL_API_KEY\": \"${input:apiKey}\"\n        }\n      }\n    }\n  }\n}\n```\n\nOptionally, you can add it to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others.\n\n```json\n{\n  \"inputs\": [\n    {\n      \"type\": \"promptString\",\n      \"id\": \"apiKey\",\n      \"description\": \"AgentQL API Key\",\n      \"password\": true\n    }\n  ],\n  \"servers\": {\n    \"agentql\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"agentql-mcp\"],\n      \"env\": {\n        \"AGENTQL_API_KEY\": \"${input:apiKey}\"\n      }\n    }\n  }\n}\n```\n\n### Configure Cursor\n\n- Open **Cursor Settings**\n- Go to **MCP > MCP Servers**\n- Click **+ Add new MCP Server**\n- Enter the following:\n  - Name: \"agentql\" (or your preferred name)\n  - Type: \"command\"\n  - Command: `env AGENTQL_API_KEY=YOUR_API_KEY npx -y agentql-mcp`\n\nRead more about MCP configuration in Cursor [here](https://docs.cursor.com/context/model-context-protocol).\n\n### Configure Windsurf\n\n- Open **Windsurf: MCP Configuration Panel**\n- Click **Add custom server+**\n- Alternatively you can open `~/.codeium/windsurf/mcp_config.json` directly\n- Add `agentql` server inside `mcpServers` dictionary in the config file\n\n```json title=\"mcp_config.json\"\n{\n  \"mcpServers\": {\n    \"agentql\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"agentql-mcp\"],\n      \"env\": {\n        \"AGENTQL_API_KEY\": \"YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\nRead more about MCP configuration in Windsurf [here](https://docs.codeium.com/windsurf/mcp).\n\n### Validate MCP integration\n\nGive your agent a task that will require extracting data from the web. For example:\n\n```text\nExtract 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.\n```\n\n> [!TIP]\n> 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.\n\n## Development\n\nInstall dependencies:\n\n```bash\nnpm install\n```\n\nBuild the server:\n\n```bash\nnpm run build\n```\n\nFor development with auto-rebuild:\n\n```bash\nnpm run watch\n```\n\nIf you want to try out development version, you can use the following config instead of the default one:\n\n```json\n{\n  \"mcpServers\": {\n    \"agentql\": {\n      \"command\": \"/path/to/agentql-mcp/dist/index.js\",\n      \"env\": {\n        \"AGENTQL_API_KEY\": \"YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n> [!NOTE]\n> Don't forget to remove the default AgentQL MCP server config to not confuse Claude with two similar servers.\n\n## Debugging\n\nSince MCP servers communicate over stdio, debugging can be challenging. We recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector), which is available as a package script:\n\n```bash\nnpm run inspector\n```\n\nThe Inspector will provide a URL to access debugging tools in your browser.\n","readmeFilename":"README.md"}