alterlab-mcp-server 1.11.1 → 1.11.3

package/dist/client.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AlterLabClient = void 0;
 // Read version from package.json at build time is complex with ESM,
 // so we hardcode it and keep in sync with package.json.
-const VERSION = "1.11.1";
+const VERSION = "1.11.3";
 const MAX_RETRIES = 2;
 class AlterLabClient {
     apiKey;

package/dist/index.js

@@ -60,7 +60,7 @@ function createServer(config) {
     const client = new client_js_1.AlterLabClient(config);
     const server = new mcp_js_1.McpServer({
         name: "alterlab",
-        version: "1.11.1",
+        version: "1.11.3",
     });
     // Register tools
     server.tool("alterlab_scrape", (0, descriptions_js_1.toolDescription)("alterlab_scrape", scrape_js_1.scrapeDescription), scrape_js_1.scrapeSchema.shape, (params) => (0, scrape_js_1.handleScrape)(client, params));

package/dist/shared/tool-definitions.json

@@ -1906,6 +1906,62 @@
                     "email"
                 ]
             }
+        },
+        {
+            "name": "alterlab_create_api_key",
+            "summary": "Create the AlterLab API key for this machine, if the user ticked 'Also create an API key' when approving the MCP connection",
+            "description": "Create one scoped, spend-capped API key (ALTERLAB_API_KEY) for the SDK and REST API on this machine. Works only when the user ticked \"Also create an API key for this machine\" on the OAuth approval screen, so no second approval is needed. Skip it if a key is already configured. The key is labeled with your client name, carries the same read/write permissions and daily spend cap as this connection (never billing), and is revocable from the dashboard. The plaintext is returned once: store it in the environment immediately without printing it. A repeat call returns key metadata only. If it fails with a permission error, the box was not ticked: use alterlab_create_account instead.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {}
+            }
+        },
+        {
+            "name": "search_alterlab",
+            "summary": "Search everything AlterLab publishes (docs, blog, guides, comparisons, changelog); free, no API key",
+            "description": "Use this to look up how to do something with AlterLab (API parameters, SDKs, MCP setup, pricing, error codes, migration from Firecrawl/ScrapingBee/Apify) or to find a guide for scraping a specific site. Searches the docs, blog, glossary, comparisons, scrape guides and changelog. Free: needs no API key and never uses credits. Returns the best matches as title, short snippet, url and markdown_url; pass a url to read_alterlab_page to read the full page as markdown.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "q": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 200,
+                        "description": "What you want to know, in plain words (for example: how to scrape amazon product data)."
+                    },
+                    "type": {
+                        "type": "string",
+                        "description": "Optional content type filter: docs, blog, how-to, scrape, comparison, glossary, answers, changelog or pricing. Omit to search everything."
+                    },
+                    "limit": {
+                        "type": "integer",
+                        "minimum": 1,
+                        "maximum": 20,
+                        "description": "Maximum number of results. Default: 8."
+                    }
+                },
+                "required": [
+                    "q"
+                ]
+            }
+        },
+        {
+            "name": "read_alterlab_page",
+            "summary": "Read one AlterLab docs, blog or guide page as markdown; free, no API key",
+            "description": "Use this after search_alterlab to read the full text of one AlterLab page as markdown, so you can follow the documented steps instead of guessing. Pass the url of a search result. Only pages on alterlab.io that search_alterlab can return are readable. Free: needs no API key and never uses credits.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "url": {
+                        "type": "string",
+                        "format": "uri",
+                        "description": "An alterlab.io page URL taken from the url field of a search_alterlab result."
+                    }
+                },
+                "required": [
+                    "url"
+                ]
+            }
         }
     ]
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "alterlab-mcp-server",
   "mcpName": "io.alterlab/mcp-server",
-  "version": "1.11.1",
+  "version": "1.11.3",
   "description": "MCP server for web scraping, structured data extraction, and screenshots \u2014 give Claude, Cursor, Windsurf, and AI agents the ability to scrape any website with automatic anti-bot bypass",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/server.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-16/server.schema.json",
   "name": "io.alterlab/mcp-server",
-  "version": "1.11.1",
+  "version": "1.11.3",
   "description": "Web scraping MCP server — scrape, extract structured data, screenshot any site with anti-bot bypass.",
   "repository": {
     "url": "https://github.com/RapierCraft/alterlab-mcp-server",
@@ -11,7 +11,7 @@
     {
       "registryType": "npm",
       "identifier": "alterlab-mcp-server",
-      "version": "1.11.1",
+      "version": "1.11.3",
       "runtimeHint": "node",
       "transport": {
         "type": "stdio"