alterlab-mcp-server 1.0.0 → 1.1.1

package/README.md

@@ -167,6 +167,8 @@ Scrape a URL and return its content as markdown, text, HTML, or JSON. Automatica
 | `wait_for` | string | — | CSS selector to wait for before extraction |
 | `timeout` | number | `90` | Timeout in seconds (1-300) |
 | `include_raw_html` | boolean | `false` | Include raw HTML alongside formatted content |
+| `session_id` | string (UUID) | — | Stored session ID for authenticated scraping |
+| `cookies` | `Record<string, string>` | &mdash; | Inline cookies for one-off authenticated requests |
 
 ### `alterlab_extract` &mdash; Extract Structured Data
 
@@ -231,6 +233,80 @@ Check your account balance, total deposited, and total spent. No parameters need
 "Check my AlterLab balance"
 ```
 
+### `alterlab_list_sessions` &mdash; List Stored Sessions
+
+List all stored sessions for authenticated scraping. Sessions contain cookies for specific domains, allowing you to scrape content behind login walls.
+
+```
+"List my stored sessions"
+```
+
+### `alterlab_create_session` &mdash; Create a Session
+
+Create a new stored session with cookies from a logged-in browser. The session is stored securely and can be reused across multiple scrape requests.
+
+```
+"Create an Amazon session with these cookies: session-id=abc123, session-token=xyz789"
+```
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `name` | string | required | Human-readable name (e.g., "My Amazon Account") |
+| `domain` | string | required | Domain (e.g., "amazon.com") |
+| `cookies` | `Record<string, string>` | required | Cookie key-value pairs |
+| `user_agent` | string | &mdash; | Browser User-Agent to use with this session |
+
+### `alterlab_validate_session` &mdash; Validate a Session
+
+Check whether a stored session is still active and its cookies are valid.
+
+```
+"Is my Amazon session still valid?"
+```
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `session_id` | string (UUID) | required | Session ID to validate |
+
+### `alterlab_delete_session` &mdash; Delete a Session
+
+Permanently delete a stored session and its cookies.
+
+```
+"Delete session abc-123-def"
+```
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `session_id` | string (UUID) | required | Session ID to delete |
+
+---
+
+## Authenticated Scraping
+
+AlterLab MCP supports scraping pages that require authentication. This enables AI agents to access user-specific content like order histories, account dashboards, and member-only pricing.
+
+### How It Works
+
+1. **Create a session** with cookies from a logged-in browser using `alterlab_create_session`
+2. **Scrape authenticated pages** by passing the `session_id` to `alterlab_scrape`
+3. **Manage sessions** with list, validate, and delete tools
+
+### Example: Check Amazon Prime Pricing
+
+```
+User: "What's my Prime member price for this product?"
+
+Claude: [calls alterlab_list_sessions → finds Amazon session]
+Claude: [calls alterlab_scrape with session_id for authenticated pricing]
+Claude: "The Prime member price is $24.99 (public price: $34.99)"
+```
+
+### Inline Cookies vs Stored Sessions
+
+- **Stored sessions** (`session_id`): Best for repeated access to the same domain. Create once, reuse across requests.
+- **Inline cookies** (`cookies`): Best for one-off authenticated requests where you don't need to save the session.
+
 ---
 
 ## What Can You Do with AlterLab MCP?
@@ -363,6 +439,33 @@ The MCP server returns helpful error messages with suggested next actions:
 
 ---
 
+## Agentic Workflows — AI Agents That Scrape the Web
+
+AlterLab MCP turns any AI agent into a web-capable agent. Instead of relying on stale training data, your agent can fetch live information from any website during execution.
+
+### Use Cases for AI Agents
+
+- **Research agents** — scrape multiple sources, cross-reference facts, generate reports with citations
+- **Data pipeline agents** — extract structured product/pricing/job data on a schedule
+- **Competitive intelligence** — monitor competitor pages, track pricing changes, detect new features
+- **Content generation** — scrape real data to ground LLM output in facts, not hallucinations
+- **Lead enrichment** — scrape company websites to enrich CRM records with live data
+- **Compliance monitoring** — check regulatory pages, terms of service, and policy updates
+
+### Compatible AI Frameworks and Clients
+
+Works with any tool that supports MCP (Model Context Protocol):
+
+- **Claude Desktop** / **Claude Code** — Anthropic's AI assistant
+- **Cursor** — AI-powered code editor
+- **Windsurf** — Codeium's AI IDE
+- **Cline** — VS Code AI assistant
+- **GitHub Copilot** — via MCP configuration
+- **Custom agents** — any framework using the MCP SDK (Python, TypeScript, Go)
+- **n8n** — workflow automation via [n8n-nodes-alterlab](https://www.npmjs.com/package/n8n-nodes-alterlab)
+
+---
+
 ## Contributing
 
 ```bash

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 import { type Config } from "./config.js";
-import { type BalanceResponse, type CostEstimate, type UnifiedScrapeRequest, type UnifiedScrapeResponse } from "./types.js";
+import { type BalanceResponse, type CostEstimate, type SessionCreateRequest, type SessionCreateResponse, type SessionDetailResponse, type SessionListResponse, type SessionRefreshRequest, type SessionUpdateRequest, type SessionValidateResponse, type UnifiedScrapeRequest, type UnifiedScrapeResponse } from "./types.js";
 export declare class AlterLabClient {
     private apiKey;
     private apiUrl;
@@ -9,6 +9,15 @@ export declare class AlterLabClient {
     scrape(params: UnifiedScrapeRequest): Promise<UnifiedScrapeResponse>;
     estimate(params: UnifiedScrapeRequest): Promise<CostEstimate>;
     getBalance(): Promise<BalanceResponse>;
+    listSessions(): Promise<SessionListResponse>;
+    createSession(params: SessionCreateRequest): Promise<SessionCreateResponse>;
+    validateSession(sessionId: string): Promise<SessionValidateResponse>;
+    getSession(sessionId: string): Promise<SessionDetailResponse>;
+    updateSession(sessionId: string, params: SessionUpdateRequest): Promise<SessionDetailResponse>;
+    refreshSession(sessionId: string, params: SessionRefreshRequest): Promise<SessionDetailResponse>;
+    deleteSession(sessionId: string): Promise<{
+        deleted: boolean;
+    }>;
     fetchScreenshotAsBase64(screenshotUrl: string): Promise<string>;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC3B,MAAM,YAAY,CAAC;AAOpB,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,MAAM;YAMZ,OAAO;IAkDf,MAAM,CACV,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,qBAAqB,CAAC;IAQ3B,QAAQ,CACZ,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,YAAY,CAAC;IAQlB,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC;IAItC,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAsBtE"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,YAAY,EAEjB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC3B,MAAM,YAAY,CAAC;AAOpB,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,MAAM;YAMZ,OAAO;IAkDf,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAQpE,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC;IAQ7D,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC;IAItC,YAAY,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAI5C,aAAa,CACjB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,qBAAqB,CAAC;IAQ3B,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAOpE,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAO7D,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,qBAAqB,CAAC;IAQ3B,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAQ3B,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAO/D,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAsBtE"}

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.0.0";
+const VERSION = "1.1.0";
 const MAX_RETRIES = 2;
 class AlterLabClient {
     apiKey;
@@ -62,6 +62,27 @@ class AlterLabClient {
     async getBalance() {
         return this.request("GET", "/api/v1/billing/balance");
     }
+    async listSessions() {
+        return this.request("GET", "/api/v1/sessions/");
+    }
+    async createSession(params) {
+        return this.request("POST", "/api/v1/sessions/", params);
+    }
+    async validateSession(sessionId) {
+        return this.request("POST", `/api/v1/sessions/${sessionId}/validate`);
+    }
+    async getSession(sessionId) {
+        return this.request("GET", `/api/v1/sessions/${sessionId}`);
+    }
+    async updateSession(sessionId, params) {
+        return this.request("PATCH", `/api/v1/sessions/${sessionId}`, params);
+    }
+    async refreshSession(sessionId, params) {
+        return this.request("POST", `/api/v1/sessions/${sessionId}/refresh`, params);
+    }
+    async deleteSession(sessionId) {
+        return this.request("DELETE", `/api/v1/sessions/${sessionId}`);
+    }
     async fetchScreenshotAsBase64(screenshotUrl) {
         // screenshot_url is a relative path like /downloads/screenshots/...
         const fullUrl = screenshotUrl.startsWith("http")

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/format.d.ts

@@ -1,4 +1,4 @@
-import { type BalanceResponse, type CostEstimate, type UnifiedScrapeResponse } from "./types.js";
+import { type BalanceResponse, type CostEstimate, type SessionCreateResponse, type SessionDetailResponse, type SessionListResponse, type SessionValidateResponse, type UnifiedScrapeResponse } from "./types.js";
 /**
  * Format a scrape response as LLM-optimized markdown.
  * Returns primary content + a compact metadata footer.
@@ -16,4 +16,28 @@ export declare function formatEstimateResponse(estimate: CostEstimate): string;
  * Format a balance response as readable text.
  */
 export declare function formatBalanceResponse(balance: BalanceResponse): string;
+/**
+ * Format a session list response as readable text.
+ */
+export declare function formatSessionListResponse(response: SessionListResponse): string;
+/**
+ * Format a session create response.
+ */
+export declare function formatSessionCreateResponse(response: SessionCreateResponse): string;
+/**
+ * Format a session validation response.
+ */
+export declare function formatSessionValidateResponse(response: SessionValidateResponse): string;
+/**
+ * Format a session detail response (get session).
+ */
+export declare function formatSessionDetailResponse(response: SessionDetailResponse): string;
+/**
+ * Format a session update response.
+ */
+export declare function formatSessionUpdateResponse(response: SessionDetailResponse): string;
+/**
+ * Format a session refresh response.
+ */
+export declare function formatSessionRefreshResponse(response: SessionDetailResponse): string;
 //# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC3B,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAwD5E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAsC7E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAYrE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAWtE"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC3B,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAwD5E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CA2C7E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAarE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAWtE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,mBAAmB,GAC5B,MAAM,CAkCR;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,CASR;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,uBAAuB,GAChC,MAAM,CAsBR;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,CA4CR;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,CAUR;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,CAWR"}

package/dist/format.js

@@ -4,6 +4,12 @@ exports.formatScrapeResponse = formatScrapeResponse;
 exports.formatExtractResponse = formatExtractResponse;
 exports.formatEstimateResponse = formatEstimateResponse;
 exports.formatBalanceResponse = formatBalanceResponse;
+exports.formatSessionListResponse = formatSessionListResponse;
+exports.formatSessionCreateResponse = formatSessionCreateResponse;
+exports.formatSessionValidateResponse = formatSessionValidateResponse;
+exports.formatSessionDetailResponse = formatSessionDetailResponse;
+exports.formatSessionUpdateResponse = formatSessionUpdateResponse;
+exports.formatSessionRefreshResponse = formatSessionRefreshResponse;
 const types_js_1 = require("./types.js");
 /**
  * Format a scrape response as LLM-optimized markdown.
@@ -71,7 +77,8 @@ function formatExtractResponse(response) {
     if (response.filtered_content) {
         jsonData = response.filtered_content;
     }
-    else if (typeof response.content === "object" && response.content !== null) {
+    else if (typeof response.content === "object" &&
+        response.content !== null) {
         const contentMap = response.content;
         jsonData = contentMap.json || contentMap;
     }
@@ -82,7 +89,9 @@ function formatExtractResponse(response) {
         parts.push(`# Extracted: ${response.title}\n`);
     }
     parts.push("```json\n" +
-        (typeof jsonData === "string" ? jsonData : JSON.stringify(jsonData, null, 2)) +
+        (typeof jsonData === "string"
+            ? jsonData
+            : JSON.stringify(jsonData, null, 2)) +
         "\n```");
     // Metadata
     const tier = response.billing.tier_used;
@@ -119,4 +128,121 @@ function formatBalanceResponse(balance) {
         `- Total spent: $${spent}\n\n` +
         `Add funds: https://alterlab.io/dashboard/billing`);
 }
+/**
+ * Format a session list response as readable text.
+ */
+function formatSessionListResponse(response) {
+    if (response.sessions.length === 0) {
+        return ("**No sessions found.**\n\n" +
+            "Create a session with `alterlab_create_session` to enable authenticated scraping.\n" +
+            "You'll need cookies from a logged-in browser session for the target domain.");
+    }
+    const parts = [`**Stored Sessions** (${response.total} total)\n`];
+    for (const session of response.sessions) {
+        const status = session.status === "active"
+            ? "Active"
+            : session.status === "expired"
+                ? "Expired"
+                : "Invalid";
+        const lastUsed = session.last_used_at
+            ? `Last used: ${session.last_used_at}`
+            : "Never used";
+        parts.push(`- **${session.name}** (\`${session.id}\`)\n` +
+            `  Domain: ${session.domain} | Status: ${status} | ` +
+            `Cookies: ${session.cookie_count} | ${lastUsed}`);
+    }
+    parts.push("\nUse a session_id with `alterlab_scrape` to scrape authenticated pages.");
+    return parts.join("\n");
+}
+/**
+ * Format a session create response.
+ */
+function formatSessionCreateResponse(response) {
+    return (`**Session Created**\n\n` +
+        `- Name: **${response.name}**\n` +
+        `- ID: \`${response.id}\`\n` +
+        `- Domain: ${response.domain}\n` +
+        `- Status: ${response.status}\n\n` +
+        `Use this session_id with \`alterlab_scrape\` to scrape authenticated pages on ${response.domain}.`);
+}
+/**
+ * Format a session validation response.
+ */
+function formatSessionValidateResponse(response) {
+    const statusIcon = response.valid ? "Valid" : "Invalid";
+    const parts = [
+        `**Session Validation: ${statusIcon}**\n`,
+        `- Name: **${response.name}**`,
+        `- ID: \`${response.id}\``,
+        `- Domain: ${response.domain}`,
+        `- Status: ${response.status}`,
+    ];
+    if (response.reason) {
+        parts.push(`- Reason: ${response.reason}`);
+    }
+    if (!response.valid) {
+        parts.push("\nThis session can no longer be used for authenticated scraping. " +
+            "Create a new session with fresh cookies using `alterlab_create_session`.");
+    }
+    return parts.join("\n");
+}
+/**
+ * Format a session detail response (get session).
+ */
+function formatSessionDetailResponse(response) {
+    const parts = [
+        `**Session: ${response.name}**\n`,
+        `- ID: \`${response.id}\``,
+        `- Domain: ${response.domain}`,
+        `- Status: ${response.status}`,
+        `- Cookies: ${response.cookie_names.length} (${response.cookie_names.join(", ")})`,
+    ];
+    if (response.header_names && response.header_names.length > 0) {
+        parts.push(`- Custom headers: ${response.header_names.length} (${response.header_names.join(", ")})`);
+    }
+    if (response.expires_at) {
+        const expiryLabel = response.expiry_status
+            ? ` (${response.expiry_status})`
+            : "";
+        parts.push(`- Expires: ${response.expires_at}${expiryLabel}`);
+    }
+    parts.push(`\n**Usage Stats**`, `- Total requests: ${response.total_requests}`, `- Successful: ${response.successful_requests}`, `- Success rate: ${(response.success_rate * 100).toFixed(1)}%`, `- Consecutive failures: ${response.consecutive_failures}`);
+    if (response.last_used_at) {
+        parts.push(`- Last used: ${response.last_used_at}`);
+    }
+    if (response.last_validated_at) {
+        parts.push(`- Last validated: ${response.last_validated_at}`);
+    }
+    if (response.notes) {
+        parts.push(`\n**Notes**: ${response.notes}`);
+    }
+    parts.push(`\n- Created: ${response.created_at}`);
+    parts.push(`- Updated: ${response.updated_at}`);
+    return parts.join("\n");
+}
+/**
+ * Format a session update response.
+ */
+function formatSessionUpdateResponse(response) {
+    return (`**Session Updated**\n\n` +
+        `- Name: **${response.name}**\n` +
+        `- ID: \`${response.id}\`\n` +
+        `- Domain: ${response.domain}\n` +
+        `- Status: ${response.status}\n` +
+        `- Cookies: ${response.cookie_names.length}\n\n` +
+        `Session has been updated successfully.`);
+}
+/**
+ * Format a session refresh response.
+ */
+function formatSessionRefreshResponse(response) {
+    return (`**Session Cookies Refreshed**\n\n` +
+        `- Name: **${response.name}**\n` +
+        `- ID: \`${response.id}\`\n` +
+        `- Domain: ${response.domain}\n` +
+        `- Status: ${response.status}\n` +
+        `- Cookies: ${response.cookie_names.length}\n\n` +
+        `Cookies have been rotated and failure counters reset. ` +
+        `The session is ready for authenticated scraping.`);
+}
 //# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -1 +1 @@
-{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":";;AAgBA,oDAwDC;AAKD,sDA2CC;AAKD,wDAaC;AAKD,sDAWC;AAKD,8DAoCC;AAKD,kEAWC;AAKD,sEAwBC;AAKD,kEA8CC;AAKD,kEAYC;AAKD,oEAaC;AAtUD,yCAUoB;AAEpB;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,QAA+B;IAClE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,QAAQ;IACR,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,mEAAmE;IACnE,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IACjC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACpD,MAAM,UAAU,GAAG,OAAiC,CAAC;QACrD,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC;aAAM,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;aAAM,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC;QACtD,CAAC;aAAM,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CACR,WAAW;gBACT,CAAC,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ;oBAClC,CAAC,CAAC,UAAU,CAAC,IAAI;oBACjB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBAC7C,OAAO,CACV,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,mCAAmC;YACnC,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IAED,kBAAkB;IAClB,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC;IACxC,MAAM,QAAQ,GAAG,qBAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IAC1C,MAAM,SAAS,GAAG,sBAAW,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;IACjD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,qBAAqB;QACjD,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;QACvE,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,UAAU,CAAC;IAEhD,KAAK,CAAC,IAAI,CACR,SAAS;QACP,WAAW,QAAQ,CAAC,GAAG,KAAK;QAC5B,SAAS,QAAQ,KAAK,SAAS,UAAU;QACzC,SAAS,IAAI,KAAK;QAClB,SAAS,QAAQ,CAAC,gBAAgB,IAAI;QACtC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CACvC,CAAC;IAEF,IAAI,QAAQ,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,QAAQ,QAAQ,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,QAA+B;IACnE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,mEAAmE;IACnE,IAAI,QAAQ,GAAY,IAAI,CAAC;IAE7B,IAAI,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QAC9B,QAAQ,GAAG,QAAQ,CAAC,gBAAgB,CAAC;IACvC,CAAC;SAAM,IACL,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ;QACpC,QAAQ,CAAC,OAAO,KAAK,IAAI,EACzB,CAAC;QACD,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAkC,CAAC;QAC/D,QAAQ,GAAG,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC;IAC9B,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,gBAAgB,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,IAAI,CACR,WAAW;QACT,CAAC,OAAO,QAAQ,KAAK,QAAQ;YAC3B,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACtC,OAAO,CACV,CAAC;IAEF,WAAW;IACX,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC;IACxC,MAAM,QAAQ,GAAG,qBAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IAE1C,KAAK,CAAC,IAAI,CACR,SAAS;QACP,WAAW,QAAQ,CAAC,GAAG,KAAK;QAC5B,SAAS,QAAQ,KAAK;QACtB,WAAW,QAAQ,CAAC,iBAAiB,IAAI,aAAa,KAAK;QAC3D,SAAS,QAAQ,CAAC,gBAAgB,IAAI,CACzC,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CAAC,QAAsB;IAC3D,MAAM,QAAQ,GACZ,qBAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,QAAQ,CAAC,cAAc,CAAC;IACjE,MAAM,SAAS,GAAG,sBAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,SAAS,CAAC;IAEpE,OAAO,CACL,uBAAuB,QAAQ,CAAC,GAAG,QAAQ;QAC3C,uBAAuB,QAAQ,YAAY,QAAQ,CAAC,cAAc,KAAK;QACvE,uBAAuB,SAAS,kBAAkB;QAClD,iBAAiB,QAAQ,CAAC,UAAU,IAAI;QACxC,wDAAwD;QACxD,GAAG,QAAQ,CAAC,SAAS,EAAE,CACxB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,OAAwB;IAC5D,MAAM,SAAS,GAAG,CAAC,OAAO,CAAC,qBAAqB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,iBAAiB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAE3D,OAAO,CACL,yBAAyB;QACzB,gBAAgB,OAAO,CAAC,eAAe,MAAM;QAC7C,uBAAuB,SAAS,IAAI;QACpC,mBAAmB,KAAK,MAAM;QAC9B,kDAAkD,CACnD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,yBAAyB,CACvC,QAA6B;IAE7B,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,CACL,4BAA4B;YAC5B,qFAAqF;YACrF,6EAA6E,CAC9E,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAa,CAAC,wBAAwB,QAAQ,CAAC,KAAK,WAAW,CAAC,CAAC;IAE5E,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACxC,MAAM,MAAM,GACV,OAAO,CAAC,MAAM,KAAK,QAAQ;YACzB,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS;gBAC5B,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,SAAS,CAAC;QAClB,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY;YACnC,CAAC,CAAC,cAAc,OAAO,CAAC,YAAY,EAAE;YACtC,CAAC,CAAC,YAAY,CAAC;QAEjB,KAAK,CAAC,IAAI,CACR,OAAO,OAAO,CAAC,IAAI,SAAS,OAAO,CAAC,EAAE,OAAO;YAC3C,aAAa,OAAO,CAAC,MAAM,cAAc,MAAM,KAAK;YACpD,YAAY,OAAO,CAAC,YAAY,MAAM,QAAQ,EAAE,CACnD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CACR,0EAA0E,CAC3E,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAgB,2BAA2B,CACzC,QAA+B;IAE/B,OAAO,CACL,yBAAyB;QACzB,aAAa,QAAQ,CAAC,IAAI,MAAM;QAChC,WAAW,QAAQ,CAAC,EAAE,MAAM;QAC5B,aAAa,QAAQ,CAAC,MAAM,IAAI;QAChC,aAAa,QAAQ,CAAC,MAAM,MAAM;QAClC,iFAAiF,QAAQ,CAAC,MAAM,GAAG,CACpG,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,6BAA6B,CAC3C,QAAiC;IAEjC,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACxD,MAAM,KAAK,GAAG;QACZ,yBAAyB,UAAU,MAAM;QACzC,aAAa,QAAQ,CAAC,IAAI,IAAI;QAC9B,WAAW,QAAQ,CAAC,EAAE,IAAI;QAC1B,aAAa,QAAQ,CAAC,MAAM,EAAE;QAC9B,aAAa,QAAQ,CAAC,MAAM,EAAE;KAC/B,CAAC;IAEF,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,aAAa,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CACR,mEAAmE;YACjE,0EAA0E,CAC7E,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAgB,2BAA2B,CACzC,QAA+B;IAE/B,MAAM,KAAK,GAAG;QACZ,cAAc,QAAQ,CAAC,IAAI,MAAM;QACjC,WAAW,QAAQ,CAAC,EAAE,IAAI;QAC1B,aAAa,QAAQ,CAAC,MAAM,EAAE;QAC9B,aAAa,QAAQ,CAAC,MAAM,EAAE;QAC9B,cAAc,QAAQ,CAAC,YAAY,CAAC,MAAM,KAAK,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;KACnF,CAAC;IAEF,IAAI,QAAQ,CAAC,YAAY,IAAI,QAAQ,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9D,KAAK,CAAC,IAAI,CACR,qBAAqB,QAAQ,CAAC,YAAY,CAAC,MAAM,KAAK,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC1F,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,MAAM,WAAW,GAAG,QAAQ,CAAC,aAAa;YACxC,CAAC,CAAC,KAAK,QAAQ,CAAC,aAAa,GAAG;YAChC,CAAC,CAAC,EAAE,CAAC;QACP,KAAK,CAAC,IAAI,CAAC,cAAc,QAAQ,CAAC,UAAU,GAAG,WAAW,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,IAAI,CACR,mBAAmB,EACnB,qBAAqB,QAAQ,CAAC,cAAc,EAAE,EAC9C,iBAAiB,QAAQ,CAAC,mBAAmB,EAAE,EAC/C,mBAAmB,CAAC,QAAQ,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAC9D,2BAA2B,QAAQ,CAAC,oBAAoB,EAAE,CAC3D,CAAC;IAEF,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,gBAAgB,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,QAAQ,CAAC,iBAAiB,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,qBAAqB,QAAQ,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,gBAAgB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,gBAAgB,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,cAAc,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IAEhD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAgB,2BAA2B,CACzC,QAA+B;IAE/B,OAAO,CACL,yBAAyB;QACzB,aAAa,QAAQ,CAAC,IAAI,MAAM;QAChC,WAAW,QAAQ,CAAC,EAAE,MAAM;QAC5B,aAAa,QAAQ,CAAC,MAAM,IAAI;QAChC,aAAa,QAAQ,CAAC,MAAM,IAAI;QAChC,cAAc,QAAQ,CAAC,YAAY,CAAC,MAAM,MAAM;QAChD,wCAAwC,CACzC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,4BAA4B,CAC1C,QAA+B;IAE/B,OAAO,CACL,mCAAmC;QACnC,aAAa,QAAQ,CAAC,IAAI,MAAM;QAChC,WAAW,QAAQ,CAAC,EAAE,MAAM;QAC5B,aAAa,QAAQ,CAAC,MAAM,IAAI;QAChC,aAAa,QAAQ,CAAC,MAAM,IAAI;QAChC,cAAc,QAAQ,CAAC,YAAY,CAAC,MAAM,MAAM;QAChD,wDAAwD;QACxD,kDAAkD,CACnD,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,7 @@
 #!/usr/bin/env node
-export {};
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Smithery sandbox: allows registry to scan tools without real credentials.
+ */
+export declare function createSandboxServer(): McpServer;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsJpE;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,CAK/C"}

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSandboxServer = createSandboxServer;
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const client_js_1 = require("./client.js");
@@ -10,12 +11,12 @@ const extract_js_1 = require("./tools/extract.js");
 const screenshot_js_1 = require("./tools/screenshot.js");
 const estimate_js_1 = require("./tools/estimate.js");
 const balance_js_1 = require("./tools/balance.js");
-async function main() {
-    const config = (0, config_js_1.loadConfig)();
+const sessions_js_1 = require("./tools/sessions.js");
+function createServer(config) {
     const client = new client_js_1.AlterLabClient(config);
     const server = new mcp_js_1.McpServer({
         name: "alterlab",
-        version: "1.0.0",
+        version: "1.1.1",
     });
     // Register tools
     server.tool("alterlab_scrape", scrape_js_1.scrapeDescription, scrape_js_1.scrapeSchema.shape, (params) => (0, scrape_js_1.handleScrape)(client, params));
@@ -23,7 +24,28 @@ async function main() {
     server.tool("alterlab_screenshot", screenshot_js_1.screenshotDescription, screenshot_js_1.screenshotSchema.shape, (params) => (0, screenshot_js_1.handleScreenshot)(client, params));
     server.tool("alterlab_estimate_cost", estimate_js_1.estimateDescription, estimate_js_1.estimateSchema.shape, (params) => (0, estimate_js_1.handleEstimate)(client, params));
     server.tool("alterlab_check_balance", balance_js_1.balanceDescription, balance_js_1.balanceSchema.shape, () => (0, balance_js_1.handleBalance)(client));
-    // Connect via stdio
+    // Session management tools
+    server.tool("alterlab_list_sessions", sessions_js_1.listSessionsDescription, sessions_js_1.listSessionsSchema.shape, () => (0, sessions_js_1.handleListSessions)(client));
+    server.tool("alterlab_create_session", sessions_js_1.createSessionDescription, sessions_js_1.createSessionSchema.shape, (params) => (0, sessions_js_1.handleCreateSession)(client, params));
+    server.tool("alterlab_get_session", sessions_js_1.getSessionDescription, sessions_js_1.getSessionSchema.shape, (params) => (0, sessions_js_1.handleGetSession)(client, params));
+    server.tool("alterlab_update_session", sessions_js_1.updateSessionDescription, sessions_js_1.updateSessionSchema.shape, (params) => (0, sessions_js_1.handleUpdateSession)(client, params));
+    server.tool("alterlab_refresh_session", sessions_js_1.refreshSessionDescription, sessions_js_1.refreshSessionSchema.shape, (params) => (0, sessions_js_1.handleRefreshSession)(client, params));
+    server.tool("alterlab_validate_session", sessions_js_1.validateSessionDescription, sessions_js_1.validateSessionSchema.shape, (params) => (0, sessions_js_1.handleValidateSession)(client, params));
+    server.tool("alterlab_delete_session", sessions_js_1.deleteSessionDescription, sessions_js_1.deleteSessionSchema.shape, (params) => (0, sessions_js_1.handleDeleteSession)(client, params));
+    return server;
+}
+/**
+ * Smithery sandbox: allows registry to scan tools without real credentials.
+ */
+function createSandboxServer() {
+    return createServer({
+        apiKey: "sandbox-key",
+        apiUrl: "https://api.alterlab.io",
+    });
+}
+async function main() {
+    const config = (0, config_js_1.loadConfig)();
+    const server = createServer(config);
     const transport = new stdio_js_1.StdioServerTransport();
     await server.connect(transport);
 }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAEA,oEAAoE;AACpE,wEAAiF;AACjF,2CAA6C;AAC7C,2CAAyC;AACzC,iDAAkF;AAClF,mDAAsF;AACtF,yDAI+B;AAC/B,qDAA0F;AAC1F,mDAAsF;AAEtF,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAA,sBAAU,GAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,0BAAc,CAAC,MAAM,CAAC,CAAC;IAE1C,MAAM,MAAM,GAAG,IAAI,kBAAS,CAAC;QAC3B,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,iBAAiB;IACjB,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,6BAAiB,EAAE,wBAAY,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAC/E,IAAA,wBAAY,EAAC,MAAM,EAAE,MAAa,CAAC,CACpC,CAAC;IAEF,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,+BAAkB,EAAE,0BAAa,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAClF,IAAA,0BAAa,EAAC,MAAM,EAAE,MAAa,CAAC,CACrC,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,qCAAqB,EACrB,gCAAgB,CAAC,KAAK,EACtB,CAAC,MAAM,EAAE,EAAE,CAAC,IAAA,gCAAgB,EAAC,MAAM,EAAE,MAAa,CAAC,CACpD,CAAC;IAEF,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE,iCAAmB,EAAE,4BAAc,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAC1F,IAAA,4BAAc,EAAC,MAAM,EAAE,MAAa,CAAC,CACtC,CAAC;IAEF,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE,+BAAkB,EAAE,0BAAa,CAAC,KAAK,EAAE,GAAG,EAAE,CAClF,IAAA,0BAAa,EAAC,MAAM,CAAC,CACtB,CAAC;IAEF,oBAAoB;IACpB,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/scrape.d.ts

@@ -11,6 +11,8 @@ export declare const scrapeSchema: z.ZodObject<{
     wait_for: z.ZodOptional<z.ZodString>;
     timeout: z.ZodDefault<z.ZodNumber>;
     include_raw_html: z.ZodDefault<z.ZodBoolean>;
+    session_id: z.ZodOptional<z.ZodString>;
+    cookies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     url: string;
     timeout: number;
@@ -21,6 +23,8 @@ export declare const scrapeSchema: z.ZodObject<{
     include_raw_html: boolean;
     proxy_country?: string | undefined;
     wait_for?: string | undefined;
+    session_id?: string | undefined;
+    cookies?: Record<string, string> | undefined;
 }, {
     url: string;
     timeout?: number | undefined;
@@ -31,6 +35,8 @@ export declare const scrapeSchema: z.ZodObject<{
     proxy_country?: string | undefined;
     wait_for?: string | undefined;
     include_raw_html?: boolean | undefined;
+    session_id?: string | undefined;
+    cookies?: Record<string, string> | undefined;
 }>;
 export declare const scrapeDescription: string;
 export declare function handleScrape(client: AlterLabClient, params: z.infer<typeof scrapeSchema>): Promise<CallToolResult>;

package/dist/tools/scrape.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scrape.d.ts","sourceRoot":"","sources":["../../src/tools/scrape.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAInD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoCvB,CAAC;AAEH,eAAO,MAAM,iBAAiB,QAKuC,CAAC;AAEtE,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,GACnC,OAAO,CAAC,cAAc,CAAC,CA2BzB"}
+{"version":3,"file":"scrape.d.ts","sourceRoot":"","sources":["../../src/tools/scrape.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAInD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqDvB,CAAC;AAEH,eAAO,MAAM,iBAAiB,QAMwD,CAAC;AAEvF,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,GACnC,OAAO,CAAC,cAAc,CAAC,CA6BzB"}

package/dist/tools/scrape.js

@@ -41,12 +41,26 @@ exports.scrapeSchema = zod_1.z.object({
         .boolean()
         .default(false)
         .describe("Include raw HTML in the response alongside formatted content"),
+    session_id: zod_1.z
+        .string()
+        .uuid()
+        .optional()
+        .describe("UUID of a stored session for authenticated scraping. " +
+        "Use alterlab_list_sessions to find available sessions. " +
+        "The session's cookies will be injected into the request."),
+    cookies: zod_1.z
+        .record(zod_1.z.string(), zod_1.z.string())
+        .optional()
+        .describe("Inline cookies as key-value pairs for authenticated scraping " +
+        "(e.g., {\"session_token\": \"abc123\"}). " +
+        "Use this for one-off requests; use session_id for reusable sessions."),
 });
 exports.scrapeDescription = "Scrape a URL and return its content as markdown, text, HTML, or JSON. " +
     "Automatically handles anti-bot protection with tier escalation. " +
     "Returns markdown by default — optimized for LLM context. " +
     "Use render_js=true for JavaScript-heavy sites (React, Angular, SPAs). " +
-    "Use use_proxy=true for geo-restricted or heavily protected sites.";
+    "Use use_proxy=true for geo-restricted or heavily protected sites. " +
+    "Supports authenticated scraping via session_id (stored session) or inline cookies.";
 async function handleScrape(client, params) {
     try {
         const response = await client.scrape({
@@ -57,6 +71,8 @@ async function handleScrape(client, params) {
             timeout: params.timeout,
             include_raw_html: params.include_raw_html,
             wait_for: params.wait_for,
+            session_id: params.session_id,
+            cookies: params.cookies,
             advanced: {
                 render_js: params.render_js,
                 use_proxy: params.use_proxy,

package/dist/tools/scrape.js.map

@@ -1 +1 @@
-{"version":3,"file":"scrape.js","sourceRoot":"","sources":["../../src/tools/scrape.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scrape.js","sourceRoot":"","sources":["../../src/tools/scrape.ts"],"names":[],"mappings":"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"}

package/dist/tools/sessions.d.ts

@@ -0,0 +1,91 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { AlterLabClient } from "../client.js";
+export declare const listSessionsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const listSessionsDescription: string;
+export declare function handleListSessions(client: AlterLabClient): Promise<CallToolResult>;
+export declare const createSessionSchema: z.ZodObject<{
+    name: z.ZodString;
+    domain: z.ZodString;
+    cookies: z.ZodRecord<z.ZodString, z.ZodString>;
+    user_agent: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    cookies: Record<string, string>;
+    domain: string;
+    user_agent?: string | undefined;
+}, {
+    name: string;
+    cookies: Record<string, string>;
+    domain: string;
+    user_agent?: string | undefined;
+}>;
+export declare const createSessionDescription: string;
+export declare function handleCreateSession(client: AlterLabClient, params: z.infer<typeof createSessionSchema>): Promise<CallToolResult>;
+export declare const validateSessionSchema: z.ZodObject<{
+    session_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    session_id: string;
+}, {
+    session_id: string;
+}>;
+export declare const validateSessionDescription: string;
+export declare function handleValidateSession(client: AlterLabClient, params: z.infer<typeof validateSessionSchema>): Promise<CallToolResult>;
+export declare const getSessionSchema: z.ZodObject<{
+    session_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    session_id: string;
+}, {
+    session_id: string;
+}>;
+export declare const getSessionDescription: string;
+export declare function handleGetSession(client: AlterLabClient, params: z.infer<typeof getSessionSchema>): Promise<CallToolResult>;
+export declare const updateSessionSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    cookies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    expires_at: z.ZodOptional<z.ZodString>;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    session_id: string;
+    name?: string | undefined;
+    headers?: Record<string, string> | undefined;
+    cookies?: Record<string, string> | undefined;
+    expires_at?: string | undefined;
+    notes?: string | undefined;
+}, {
+    session_id: string;
+    name?: string | undefined;
+    headers?: Record<string, string> | undefined;
+    cookies?: Record<string, string> | undefined;
+    expires_at?: string | undefined;
+    notes?: string | undefined;
+}>;
+export declare const updateSessionDescription: string;
+export declare function handleUpdateSession(client: AlterLabClient, params: z.infer<typeof updateSessionSchema>): Promise<CallToolResult>;
+export declare const refreshSessionSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    cookies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    session_id: string;
+    headers?: Record<string, string> | undefined;
+    cookies?: Record<string, string> | undefined;
+}, {
+    session_id: string;
+    headers?: Record<string, string> | undefined;
+    cookies?: Record<string, string> | undefined;
+}>;
+export declare const refreshSessionDescription: string;
+export declare function handleRefreshSession(client: AlterLabClient, params: z.infer<typeof refreshSessionSchema>): Promise<CallToolResult>;
+export declare const deleteSessionSchema: z.ZodObject<{
+    session_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    session_id: string;
+}, {
+    session_id: string;
+}>;
+export declare const deleteSessionDescription: string;
+export declare function handleDeleteSession(client: AlterLabClient, params: z.infer<typeof deleteSessionSchema>): Promise<CallToolResult>;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/tools/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/tools/sessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAenD,eAAO,MAAM,kBAAkB,gDAAe,CAAC;AAE/C,eAAO,MAAM,uBAAuB,QAI+C,CAAC;AAEpF,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,cAAc,CAAC,CAYzB;AAMD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAsB9B,CAAC;AAEH,eAAO,MAAM,wBAAwB,QAIc,CAAC;AAEpD,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,GAC1C,OAAO,CAAC,cAAc,CAAC,CAiBzB;AAMD,eAAO,MAAM,qBAAqB;;;;;;EAEhC,CAAC;AAEH,eAAO,MAAM,0BAA0B,QAGgB,CAAC;AAExD,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,GAC5C,OAAO,CAAC,cAAc,CAAC,CAczB;AAMD,eAAO,MAAM,gBAAgB;;;;;;EAE3B,CAAC;AAEH,eAAO,MAAM,qBAAqB,QAIqB,CAAC;AAExD,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,GACvC,OAAO,CAAC,cAAc,CAAC,CAYzB;AAMD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;EA8B9B,CAAC;AAEH,eAAO,MAAM,wBAAwB,QAIuC,CAAC;AAE7E,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,GAC1C,OAAO,CAAC,cAAc,CAAC,CAazB;AAMD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAa/B,CAAC;AAEH,eAAO,MAAM,yBAAyB,QAIW,CAAC;AAElD,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,GAC3C,OAAO,CAAC,cAAc,CAAC,CAazB;AAMD,eAAO,MAAM,mBAAmB;;;;;;EAE9B,CAAC;AAEH,eAAO,MAAM,wBAAwB,QAE4C,CAAC;AAElF,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,GAC1C,OAAO,CAAC,cAAc,CAAC,CAiBzB"}

package/dist/tools/sessions.js

@@ -0,0 +1,249 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deleteSessionDescription = exports.deleteSessionSchema = exports.refreshSessionDescription = exports.refreshSessionSchema = exports.updateSessionDescription = exports.updateSessionSchema = exports.getSessionDescription = exports.getSessionSchema = exports.validateSessionDescription = exports.validateSessionSchema = exports.createSessionDescription = exports.createSessionSchema = exports.listSessionsDescription = exports.listSessionsSchema = void 0;
+exports.handleListSessions = handleListSessions;
+exports.handleCreateSession = handleCreateSession;
+exports.handleValidateSession = handleValidateSession;
+exports.handleGetSession = handleGetSession;
+exports.handleUpdateSession = handleUpdateSession;
+exports.handleRefreshSession = handleRefreshSession;
+exports.handleDeleteSession = handleDeleteSession;
+const zod_1 = require("zod");
+const errors_js_1 = require("../errors.js");
+const format_js_1 = require("../format.js");
+// ============================================================================
+// List Sessions
+// ============================================================================
+exports.listSessionsSchema = zod_1.z.object({});
+exports.listSessionsDescription = "List all stored sessions for authenticated scraping. " +
+    "Sessions contain cookies for specific domains, allowing you to scrape " +
+    "content that requires login (e.g., Amazon order history, LinkedIn profiles). " +
+    "Use the returned session_id with alterlab_scrape to scrape authenticated pages.";
+async function handleListSessions(client) {
+    try {
+        const response = await client.listSessions();
+        return {
+            content: [{ type: "text", text: (0, format_js_1.formatSessionListResponse)(response) }],
+        };
+    }
+    catch (error) {
+        if (isApiError(error)) {
+            return (0, errors_js_1.formatErrorResult)(error);
+        }
+        return (0, errors_js_1.formatErrorResult)(error);
+    }
+}
+// ============================================================================
+// Create Session
+// ============================================================================
+exports.createSessionSchema = zod_1.z.object({
+    name: zod_1.z
+        .string()
+        .min(1)
+        .max(100)
+        .describe("Human-readable name for this session (e.g., 'My Amazon Account')"),
+    domain: zod_1.z
+        .string()
+        .min(1)
+        .describe("Domain this session is for (e.g., 'amazon.com')"),
+    cookies: zod_1.z
+        .record(zod_1.z.string(), zod_1.z.string())
+        .describe("Cookie key-value pairs for authentication " +
+        '(e.g., {"session-id": "abc123", "session-token": "xyz789"})'),
+    user_agent: zod_1.z
+        .string()
+        .optional()
+        .describe("Browser User-Agent string to use with this session"),
+});
+exports.createSessionDescription = "Create a new stored session for authenticated scraping. " +
+    "Provide cookies from a logged-in browser session to enable scraping " +
+    "behind login walls. The session is stored securely and can be reused " +
+    "across multiple scrape requests via session_id.";
+async function handleCreateSession(client, params) {
+    try {
+        const response = await client.createSession({
+            name: params.name,
+            domain: params.domain,
+            cookies: params.cookies,
+            user_agent: params.user_agent,
+        });
+        return {
+            content: [{ type: "text", text: (0, format_js_1.formatSessionCreateResponse)(response) }],
+        };
+    }
+    catch (error) {
+        if (isApiError(error)) {
+            return (0, errors_js_1.formatErrorResult)(error);
+        }
+        return (0, errors_js_1.formatErrorResult)(error);
+    }
+}
+// ============================================================================
+// Validate Session
+// ============================================================================
+exports.validateSessionSchema = zod_1.z.object({
+    session_id: zod_1.z.string().uuid().describe("UUID of the session to validate"),
+});
+exports.validateSessionDescription = "Validate whether a stored session is still active and its cookies are valid. " +
+    "Run this before scraping if you suspect a session may have expired. " +
+    "Returns the session status and a reason if invalid.";
+async function handleValidateSession(client, params) {
+    try {
+        const response = await client.validateSession(params.session_id);
+        return {
+            content: [
+                { type: "text", text: (0, format_js_1.formatSessionValidateResponse)(response) },
+            ],
+        };
+    }
+    catch (error) {
+        if (isApiError(error)) {
+            return (0, errors_js_1.formatErrorResult)(error);
+        }
+        return (0, errors_js_1.formatErrorResult)(error);
+    }
+}
+// ============================================================================
+// Get Session
+// ============================================================================
+exports.getSessionSchema = zod_1.z.object({
+    session_id: zod_1.z.string().uuid().describe("UUID of the session to retrieve"),
+});
+exports.getSessionDescription = "Get detailed information about a specific stored session. " +
+    "Returns session status, cookie names, usage statistics (total requests, " +
+    "success rate), expiry info, and notes. Use this to inspect a session " +
+    "before deciding to validate, refresh, or delete it.";
+async function handleGetSession(client, params) {
+    try {
+        const response = await client.getSession(params.session_id);
+        return {
+            content: [{ type: "text", text: (0, format_js_1.formatSessionDetailResponse)(response) }],
+        };
+    }
+    catch (error) {
+        if (isApiError(error)) {
+            return (0, errors_js_1.formatErrorResult)(error);
+        }
+        return (0, errors_js_1.formatErrorResult)(error);
+    }
+}
+// ============================================================================
+// Update Session
+// ============================================================================
+exports.updateSessionSchema = zod_1.z.object({
+    session_id: zod_1.z.string().uuid().describe("UUID of the session to update"),
+    name: zod_1.z
+        .string()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe("New name for the session"),
+    cookies: zod_1.z
+        .record(zod_1.z.string(), zod_1.z.string())
+        .optional()
+        .describe("New cookie key-value pairs — replaces ALL existing cookies " +
+        '(e.g., {"session-id": "new123", "session-token": "newxyz"})'),
+    headers: zod_1.z
+        .record(zod_1.z.string(), zod_1.z.string())
+        .optional()
+        .describe("New custom headers — replaces ALL existing headers"),
+    expires_at: zod_1.z
+        .string()
+        .optional()
+        .describe("New expiration date in ISO 8601 format (e.g., '2026-12-31T23:59:59Z')"),
+    notes: zod_1.z
+        .string()
+        .max(1000)
+        .optional()
+        .describe("Notes or description for this session"),
+});
+exports.updateSessionDescription = "Update a stored session's properties. You can change the name, rotate " +
+    "cookies, update custom headers, set a new expiration, or add notes. " +
+    "When cookies are provided, they replace ALL existing cookies (not merged). " +
+    "Use this instead of delete+recreate when you need to rotate credentials.";
+async function handleUpdateSession(client, params) {
+    try {
+        const { session_id, ...updateFields } = params;
+        const response = await client.updateSession(session_id, updateFields);
+        return {
+            content: [{ type: "text", text: (0, format_js_1.formatSessionUpdateResponse)(response) }],
+        };
+    }
+    catch (error) {
+        if (isApiError(error)) {
+            return (0, errors_js_1.formatErrorResult)(error);
+        }
+        return (0, errors_js_1.formatErrorResult)(error);
+    }
+}
+// ============================================================================
+// Refresh Session
+// ============================================================================
+exports.refreshSessionSchema = zod_1.z.object({
+    session_id: zod_1.z.string().uuid().describe("UUID of the session to refresh"),
+    cookies: zod_1.z
+        .record(zod_1.z.string(), zod_1.z.string())
+        .optional()
+        .describe("New cookie key-value pairs to replace the old ones. " +
+        "If omitted, only failure counters are reset."),
+    headers: zod_1.z
+        .record(zod_1.z.string(), zod_1.z.string())
+        .optional()
+        .describe("Updated custom headers to include with the session"),
+});
+exports.refreshSessionDescription = "Refresh a session by rotating its cookies and resetting failure counters. " +
+    "This is the preferred way to update cookies after re-authenticating in " +
+    "your browser. The session status is reset to active. If cookies are " +
+    "omitted, only the failure counters are reset.";
+async function handleRefreshSession(client, params) {
+    try {
+        const { session_id, ...refreshFields } = params;
+        const response = await client.refreshSession(session_id, refreshFields);
+        return {
+            content: [{ type: "text", text: (0, format_js_1.formatSessionRefreshResponse)(response) }],
+        };
+    }
+    catch (error) {
+        if (isApiError(error)) {
+            return (0, errors_js_1.formatErrorResult)(error);
+        }
+        return (0, errors_js_1.formatErrorResult)(error);
+    }
+}
+// ============================================================================
+// Delete Session
+// ============================================================================
+exports.deleteSessionSchema = zod_1.z.object({
+    session_id: zod_1.z.string().uuid().describe("UUID of the session to delete"),
+});
+exports.deleteSessionDescription = "Delete a stored session. This permanently removes the session and its " +
+    "cookies. Use this when a session is no longer needed or has been compromised.";
+async function handleDeleteSession(client, params) {
+    try {
+        await client.deleteSession(params.session_id);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Session \`${params.session_id}\` has been deleted.`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        if (isApiError(error)) {
+            return (0, errors_js_1.formatErrorResult)(error);
+        }
+        return (0, errors_js_1.formatErrorResult)(error);
+    }
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function isApiError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "status" in error &&
+        typeof error.status === "number");
+}
+//# sourceMappingURL=sessions.js.map

package/dist/tools/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../src/tools/sessions.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -21,6 +21,74 @@ export interface UnifiedScrapeRequest {
     wait_for?: string;
     screenshot?: boolean;
     wait_until?: string;
+    session_id?: string;
+    cookies?: Record<string, string>;
+}
+export interface Session {
+    id: string;
+    name: string;
+    domain: string;
+    status: "active" | "expired" | "invalid";
+    created_at: string;
+    updated_at: string;
+    last_used_at?: string;
+    expires_at?: string;
+    cookie_count: number;
+}
+export interface SessionListResponse {
+    sessions: Session[];
+    total: number;
+}
+export interface SessionCreateRequest {
+    name: string;
+    domain: string;
+    cookies: Record<string, string>;
+    user_agent?: string;
+}
+export interface SessionCreateResponse {
+    id: string;
+    name: string;
+    domain: string;
+    status: "active";
+    created_at: string;
+}
+export interface SessionValidateResponse {
+    id: string;
+    name: string;
+    domain: string;
+    status: "active" | "expired" | "invalid";
+    valid: boolean;
+    reason?: string;
+}
+export interface SessionDetailResponse {
+    id: string;
+    name: string;
+    domain: string;
+    cookie_names: string[];
+    header_names?: string[];
+    status: string;
+    expires_at?: string;
+    last_validated_at?: string;
+    consecutive_failures: number;
+    last_used_at?: string;
+    total_requests: number;
+    successful_requests: number;
+    success_rate: number;
+    notes?: string;
+    expiry_status?: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface SessionUpdateRequest {
+    name?: string;
+    cookies?: Record<string, string>;
+    headers?: Record<string, string>;
+    expires_at?: string;
+    notes?: string;
+}
+export interface SessionRefreshRequest {
+    cookies?: Record<string, string>;
+    headers?: Record<string, string>;
 }
 export interface TierEscalationDetail {
     tier: string;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;;;AAgG/E,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAElE,QAAA,UAAU,GAA2B;IAChD,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,SAAS;IACd,KAAK,EAAE,SAAS;IAChB,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;CACf,CAAC;AAEW,QAAA,WAAW,GAA2B;IACjD,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;IACd,KAAK,EAAE,SAAS;IAChB,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,OAAO;CACb,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;;;AAgL/E,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAElE,QAAA,UAAU,GAA2B;IAChD,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,SAAS;IACd,KAAK,EAAE,SAAS;IAChB,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;CACf,CAAC;AAEW,QAAA,WAAW,GAA2B;IACjD,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;IACd,KAAK,EAAE,SAAS;IAChB,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,OAAO;CACb,CAAC"}

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "alterlab-mcp-server",
-  "version": "1.0.0",
-  "description": "MCP server for AlterLab web scraping API — scrape, extract, screenshot any webpage",
+  "mcpName": "io.alterlab/mcp-server",
+  "version": "1.1.1",
+  "description": "MCP server for web scraping, structured data extraction, and screenshots — 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",
   "bin": {
@@ -14,16 +15,36 @@
   },
   "keywords": [
     "mcp",
-    "scraping",
-    "web-scraping",
-    "alterlab",
+    "mcp-server",
     "model-context-protocol",
+    "web-scraping",
+    "scraping",
+    "scraper",
+    "crawler",
+    "crawling",
+    "data-extraction",
+    "structured-data",
+    "screenshot",
+    "ai-agent",
+    "agentic",
+    "llm",
+    "llm-tools",
     "claude",
     "cursor",
-    "windsurf"
+    "windsurf",
+    "cline",
+    "copilot",
+    "anti-bot",
+    "headless-browser",
+    "proxy",
+    "alterlab"
   ],
   "author": "AlterLab",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/RapierCraft/alterlab-mcp-server.git"
+  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",
     "zod": "^3.24.2"
@@ -37,6 +58,7 @@
   },
   "files": [
     "dist",
+    "server.json",
     "README.md",
     "LICENSE"
   ]

package/server.json

@@ -0,0 +1,89 @@
+{
+  "$schema": "https://registry.modelcontextprotocol.io/schemas/server.json",
+  "name": "io.alterlab/mcp-server",
+  "description": "Web scraping and structured data extraction MCP server. Scrape any website with automatic anti-bot bypass (Cloudflare, DataDome, Akamai), extract structured JSON with AI, take screenshots, and manage authenticated sessions. Works with Claude, Cursor, Windsurf, Cline, and any MCP-compatible AI agent.",
+  "repository": {
+    "url": "https://github.com/RapierCraft/alterlab-mcp-server",
+    "source": "github"
+  },
+  "version_detail": {
+    "version": "1.1.1",
+    "release_date": "2026-03-31",
+    "is_latest": true
+  },
+  "packages": [
+    {
+      "registry_type": "npm",
+      "name": "alterlab-mcp-server",
+      "version": "1.1.1",
+      "runtime": "node",
+      "runtime_arguments": [],
+      "package_arguments": [],
+      "environment_variables": [
+        {
+          "name": "ALTERLAB_API_KEY",
+          "description": "Your AlterLab API key (starts with sk_live_). Get one at https://alterlab.io",
+          "required": true,
+          "is_secret": true
+        },
+        {
+          "name": "ALTERLAB_API_URL",
+          "description": "API base URL (defaults to https://api.alterlab.io)",
+          "required": false,
+          "is_secret": false
+        }
+      ]
+    }
+  ],
+  "tools": [
+    {
+      "name": "alterlab_scrape",
+      "description": "Scrape any website with anti-bot bypass and proxy rotation. Returns clean text, HTML, markdown, or JSON."
+    },
+    {
+      "name": "alterlab_extract",
+      "description": "Extract structured data from any URL using AI. Define a schema and get back typed JSON."
+    },
+    {
+      "name": "alterlab_screenshot",
+      "description": "Take a screenshot of any webpage with configurable viewport and format."
+    },
+    {
+      "name": "alterlab_estimate_cost",
+      "description": "Estimate the credit cost of a scrape before running it."
+    },
+    {
+      "name": "alterlab_check_balance",
+      "description": "Check your current account balance and credit usage."
+    },
+    {
+      "name": "alterlab_list_sessions",
+      "description": "List all active authenticated browser sessions."
+    },
+    {
+      "name": "alterlab_create_session",
+      "description": "Create a new authenticated browser session with cookies for logged-in scraping."
+    },
+    {
+      "name": "alterlab_get_session",
+      "description": "Get details of a specific authenticated session."
+    },
+    {
+      "name": "alterlab_update_session",
+      "description": "Update cookies or settings on an existing session."
+    },
+    {
+      "name": "alterlab_refresh_session",
+      "description": "Refresh an authenticated session to extend its lifetime."
+    },
+    {
+      "name": "alterlab_validate_session",
+      "description": "Validate that a session's cookies are still active and working."
+    },
+    {
+      "name": "alterlab_delete_session",
+      "description": "Delete an authenticated browser session."
+    }
+  ],
+  "remotes": []
+}