alterlab-mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AlterLab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,384 @@
+<p align="center">
+  <img src="assets/logo.png" alt="AlterLab Logo" width="120" />
+</p>
+
+<h1 align="center">AlterLab MCP Server</h1>
+
+<p align="center">
+  <strong>Give Claude, Cursor, and Windsurf the ability to scrape any website, extract structured data, and take screenshots — with automatic anti-bot bypass.</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/alterlab-mcp-server"><img src="https://img.shields.io/npm/v/alterlab-mcp-server.svg" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/alterlab-mcp-server"><img src="https://img.shields.io/npm/dm/alterlab-mcp-server.svg" alt="npm downloads" /></a>
+  <a href="https://github.com/RapierCraft/alterlab-mcp-server/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/alterlab-mcp-server.svg" alt="license" /></a>
+  <a href="https://smithery.ai/server/alterlab-mcp-server"><img src="https://smithery.ai/badge/alterlab-mcp-server" alt="Smithery" /></a>
+</p>
+
+<p align="center">
+  <a href="https://app.alterlab.io/signin?redirect=/dashboard/keys&source=mcp&utm_source=mcp&utm_medium=integration&utm_campaign=mcp_server"><strong>Get Started Free &rarr;</strong></a> &nbsp; $1 free balance on signup &mdash; up to 5,000 scrapes.
+</p>
+
+---
+
+## One-Line Install
+
+### Claude Code
+
+```bash
+claude mcp add alterlab -- npx -y alterlab-mcp-server
+```
+
+Then set your API key: `export ALTERLAB_API_KEY=sk_live_...` or add it to `.claude.json` (see [full setup](#install-in-claude-desktop--claude-code) below).
+
+### Cursor
+
+```bash
+# Add to .cursor/mcp.json — see full config below
+```
+
+### Smithery
+
+```bash
+npx -y @smithery/cli install alterlab-mcp-server --client claude
+```
+
+---
+
+## Why AlterLab Instead of WebFetch or Browser MCP?
+
+Claude's built-in `WebFetch` tool and open-source browser MCP servers fail on most real-world websites. They cannot bypass Cloudflare, render JavaScript SPAs, or extract structured data.
+
+AlterLab replaces broken fetch tools with **one MCP server** that actually works:
+
+| Capability | WebFetch / fetch() | Browser MCP | AlterLab MCP |
+|---|---|---|---|
+| Anti-bot bypass (Cloudflare, DataDome, Akamai) | No | Partial | Yes &mdash; automatic |
+| JavaScript rendering (React, Angular, Vue SPAs) | No | Yes (slow) | Yes &mdash; headless Chromium |
+| Structured data extraction (JSON, Schema.org) | No | No | Yes &mdash; built-in profiles |
+| Smart tier escalation (cheapest method first) | N/A | N/A | Yes &mdash; saves 60-80% |
+| Residential proxy rotation (195+ countries) | No | No | Yes |
+| Screenshot and PDF capture | No | Screenshot only | Yes &mdash; both |
+| OCR text extraction from images | No | No | Yes |
+| Cost per request | Free (but fails) | Free (but slow) | From $0.0002 |
+
+## How Does AlterLab Web Scraping Work?
+
+AlterLab uses a multi-tier scraping architecture. It automatically selects the cheapest method capable of fetching each URL:
+
+1. **Curl** ($0.0002/req) &mdash; Direct HTTP for static pages, RSS feeds, public APIs
+2. **HTTP** ($0.0003/req) &mdash; TLS fingerprint rotation for moderately protected sites
+3. **Stealth** ($0.0005/req) &mdash; Browser impersonation for Cloudflare/DataDome-protected sites
+4. **Light JS** ($0.0007/req) &mdash; Lightweight JS extraction from server-rendered HTML
+5. **Browser** ($0.001/req) &mdash; Full headless Chromium for JavaScript-heavy SPAs
+
+Auto mode starts at Tier 1 and escalates only when blocked. Most websites resolve at Tiers 1-2, so **$1 gets you 1,000 to 5,000 scrapes** depending on the sites you target.
+
+---
+
+## Installation
+
+### Install in Claude Desktop / Claude Code
+
+Add to your Claude config file (`~/.claude.json` for Claude Code, or Settings for Claude Desktop):
+
+```json
+{
+  "mcpServers": {
+    "alterlab": {
+      "command": "npx",
+      "args": ["-y", "alterlab-mcp-server"],
+      "env": {
+        "ALTERLAB_API_KEY": "sk_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Install in Cursor
+
+Add to `.cursor/mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "alterlab": {
+      "command": "npx",
+      "args": ["-y", "alterlab-mcp-server"],
+      "env": {
+        "ALTERLAB_API_KEY": "sk_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Install in Windsurf
+
+Add to Windsurf MCP settings (`~/.codeium/windsurf/mcp_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "alterlab": {
+      "command": "npx",
+      "args": ["-y", "alterlab-mcp-server"],
+      "env": {
+        "ALTERLAB_API_KEY": "sk_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Install via Smithery
+
+```bash
+npx -y @smithery/cli install alterlab-mcp-server --client claude
+```
+
+### Get Your API Key
+
+1. [Sign up free](https://app.alterlab.io/signin?redirect=/dashboard/keys&source=mcp&utm_source=mcp&utm_medium=integration&utm_campaign=mcp_server) &mdash; $1 free balance on signup
+2. Go to **Dashboard &rarr; API Keys** and copy your key
+3. Paste it into the `ALTERLAB_API_KEY` field in your MCP config
+
+---
+
+## Tools
+
+### `alterlab_scrape` &mdash; Scrape Any Webpage
+
+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 &mdash; optimized for LLM context windows.
+
+```
+"Scrape https://www.amazon.com/dp/B0BSHF7WHW and summarize the product"
+```
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `url` | string | required | URL to scrape |
+| `mode` | `auto` \| `html` \| `js` \| `pdf` \| `ocr` | `auto` | Scraping mode |
+| `formats` | `(text\|json\|html\|markdown)[]` | `["markdown"]` | Output formats |
+| `render_js` | boolean | `false` | Use headless browser (+3 credits) |
+| `use_proxy` | boolean | `false` | Premium proxy (+1 credit) |
+| `proxy_country` | string | &mdash; | ISO country code for geo-targeting (e.g., `US`, `DE`) |
+| `wait_for` | string | &mdash; | 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 |
+
+### `alterlab_extract` &mdash; Extract Structured Data
+
+Extract structured fields from any webpage using pre-built profiles or custom JSON Schema. Returns clean JSON &mdash; ready for databases, spreadsheets, or downstream processing.
+
+```
+"Extract the product name, price, and rating from this Amazon page"
+```
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `url` | string | required | URL to extract from |
+| `extraction_profile` | enum | `auto` | Profile: `product`, `article`, `job_posting`, `faq`, `recipe`, `event` |
+| `extraction_schema` | object | &mdash; | Custom JSON Schema for structured output |
+| `extraction_prompt` | string | &mdash; | Natural language extraction instructions |
+| `render_js` | boolean | `false` | Use headless browser |
+| `use_proxy` | boolean | `false` | Premium proxy |
+
+**Extraction profiles:**
+
+- **Product** &mdash; name, price, currency, rating, reviews, availability, images, description
+- **Article** &mdash; title, author, published date, body text, featured image
+- **Job Posting** &mdash; title, company, location, salary, description, requirements
+- **FAQ** &mdash; question-answer pairs
+- **Recipe** &mdash; ingredients, instructions, prep time, servings
+- **Event** &mdash; name, date, location, description, organizer
+
+### `alterlab_screenshot` &mdash; Screenshot Any Page
+
+Take a full-page screenshot of any URL. Returns a PNG image directly in the conversation &mdash; no URLs to copy, no files to download.
+
+```
+"Take a screenshot of our landing page at https://alterlab.io"
+```
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `url` | string | required | URL to screenshot |
+| `wait_for` | string | &mdash; | CSS selector to wait for before capture |
+| `wait_until` | enum | `networkidle` | `networkidle`, `domcontentloaded`, or `load` |
+
+### `alterlab_estimate_cost` &mdash; Estimate Before You Scrape
+
+Check how much a scrape will cost before running it. Returns the predicted tier, cost per request, and confidence level.
+
+```
+"How much would it cost to scrape linkedin.com?"
+```
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `url` | string | required | URL to estimate |
+| `mode` | enum | `auto` | Scraping mode |
+| `render_js` | boolean | `false` | Include JS rendering cost |
+| `use_proxy` | boolean | `false` | Include proxy cost |
+
+### `alterlab_check_balance` &mdash; Check Your Credits
+
+Check your account balance, total deposited, and total spent. No parameters needed.
+
+```
+"Check my AlterLab balance"
+```
+
+---
+
+## What Can You Do with AlterLab MCP?
+
+### Research and Analysis
+
+Ask Claude to scrape and analyze websites in real-time:
+
+- *"Scrape the top 5 results from this Google search and summarize them"*
+- *"Extract all product prices from this Amazon category page"*
+- *"Compare the pricing pages of these 3 competitors"*
+
+### Code Generation with Real Data
+
+Let Cursor or Windsurf fetch live data while building:
+
+- *"Scrape this API documentation page and generate TypeScript types from it"*
+- *"Extract the color palette from this website and create a Tailwind config"*
+- *"Screenshot this design and recreate it in React"*
+
+### Content and SEO
+
+Use Claude to analyze content at scale:
+
+- *"Scrape this blog post and suggest improvements for SEO"*
+- *"Extract all FAQ entries from this help center and create a structured dataset"*
+- *"Compare our landing page to the competitor's and identify gaps"*
+
+### Monitoring and Alerts
+
+Build agentic workflows that watch the web:
+
+- *"Check if this product is back in stock"*
+- *"Scrape this page daily and alert me when the price drops below $50"*
+- *"Monitor this job board for new senior engineering positions"*
+
+---
+
+## Pricing &mdash; Pay-As-You-Go Web Scraping
+
+No subscriptions. No monthly minimums. Add balance and use it whenever you need it.
+
+### Base Scraping Costs
+
+| Tier | Method | Cost per Request | Use Case |
+|---|---|---|---|
+| Curl | Direct HTTP | $0.0002 | Static pages, RSS feeds, public APIs |
+| HTTP | TLS fingerprinting | $0.0003 | Sites with basic bot detection |
+| Stealth | Browser impersonation | $0.0005 | Cloudflare, DataDome, PerimeterX protected sites |
+| Light JS | JSON extraction | $0.0007 | Server-rendered pages needing structured data |
+| Browser | Headless Chromium | $0.001 | Full JavaScript SPAs (React, Angular, Vue) |
+
+### Optional Add-Ons
+
+| Add-On | Extra Cost | Description |
+|---|---|---|
+| JavaScript Rendering | +$0.0006 | Headless Chromium for dynamic content |
+| Screenshot Capture | +$0.0002 | Full-page PNG screenshot |
+| Premium Proxy | +$0.0002 | Geo-targeted residential proxy (195+ countries) |
+| OCR Text Extraction | +$0.001 | Extract text from images on the page |
+
+**$1 = 5,000 light scrapes.** New accounts get $1 free balance on signup.
+
+---
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `ALTERLAB_API_KEY` | Yes | &mdash; | Your API key ([get one free](https://app.alterlab.io/signin?redirect=/dashboard/keys&source=mcp&utm_source=mcp&utm_medium=integration&utm_campaign=mcp_server)) |
+| `ALTERLAB_API_URL` | No | `https://api.alterlab.io` | API base URL (for self-hosted or development) |
+
+---
+
+## Frequently Asked Questions
+
+### How do I add web scraping to Claude, Cursor, or Windsurf?
+
+Install the AlterLab MCP server. For Claude Code, run `claude mcp add alterlab -- npx -y alterlab-mcp-server` and set your `ALTERLAB_API_KEY`. For Claude Desktop, Cursor, or Windsurf, add the JSON config block to your MCP settings file. Once configured, your AI assistant can scrape any URL, extract structured data, and take screenshots directly in conversation.
+
+### Can Claude scrape websites that are behind Cloudflare or anti-bot protection?
+
+Yes. AlterLab automatically handles Cloudflare, DataDome, PerimeterX, Akamai, and other anti-bot systems. It uses a multi-tier approach that starts with the cheapest method and escalates only when blocked. You don't need to configure anything &mdash; anti-bot bypass is fully automatic.
+
+### What is an MCP server and how does it work with Claude?
+
+MCP (Model Context Protocol) is Anthropic's open standard for connecting AI assistants to external tools and data sources. An MCP server is a small program that exposes tools &mdash; like web scraping &mdash; that Claude, Cursor, or Windsurf can call during a conversation. The AlterLab MCP server gives your AI assistant 5 tools: scrape, extract, screenshot, estimate cost, and check balance.
+
+### How is AlterLab different from Firecrawl, ScrapingBee, or Apify MCP servers?
+
+AlterLab starts at $0.0002 per request &mdash; 5-20x cheaper than most scraping APIs &mdash; because it only uses expensive browser rendering when a site actually requires it. Smart tier escalation means you pay for what each site needs, not the maximum. AlterLab also includes built-in structured data extraction with pre-built profiles (product, article, job posting, etc.) at no extra cost.
+
+### Can I scrape Amazon, Walmart, and other e-commerce sites from Claude?
+
+Yes. AlterLab handles all major e-commerce anti-bot protection. Use the `alterlab_extract` tool with `extraction_profile: "product"` to get structured JSON: product name, price, currency, rating, review count, availability, and images &mdash; ready for analysis, comparison, or data pipelines.
+
+### Can Cursor scrape documentation and generate code from it?
+
+Yes. With AlterLab MCP installed in Cursor, you can ask it to scrape API documentation, library docs, or any reference page and generate TypeScript types, API clients, or component code from the live content. This is more reliable than relying on the LLM's training data, which may be outdated.
+
+### Does AlterLab MCP work with JavaScript-heavy sites (React, Angular, Vue)?
+
+Yes. Use `render_js: true` or set `mode: "js"` to enable full headless Chromium rendering. AlterLab renders the complete page including all JavaScript, waits for dynamic content to load, then extracts content from the fully rendered DOM. This works for React, Angular, Vue, Next.js, and any other JavaScript framework.
+
+### What output format is best for AI and LLM context windows?
+
+Use markdown (the default). It preserves document structure &mdash; headings, tables, lists, links &mdash; while being 60-80% smaller than raw HTML. Claude, GPT-4, and other LLMs process markdown significantly better than HTML. AlterLab's markdown output is specifically optimized for LLM context windows.
+
+### Is there rate limiting?
+
+Free-tier accounts have rate limits. Adding any balance removes rate limits. The MCP server includes automatic retry with exponential backoff for transient rate limit errors (429).
+
+### Can I use this MCP server for large-scale scraping?
+
+Yes. The MCP server processes one request at a time through the conversation interface, but you can build agentic workflows that scrape many URLs sequentially. For batch processing, use the AlterLab API directly or the [n8n integration](https://www.npmjs.com/package/n8n-nodes-alterlab).
+
+---
+
+## Error Handling
+
+The MCP server returns helpful error messages with suggested next actions:
+
+| Error | What Happens | Suggested Action |
+|---|---|---|
+| **401** Unauthorized | Invalid API key | Check `ALTERLAB_API_KEY` is set correctly |
+| **402** Insufficient Credits | Balance too low | Run `alterlab_check_balance`, add funds |
+| **403** Forbidden | Site blocked the request | Try `render_js: true` + `use_proxy: true` |
+| **429** Rate Limited | Too many requests | Automatic retry with backoff |
+| **504** Gateway Timeout | Scrape took too long | Increase `timeout`, simplify request |
+
+---
+
+## Contributing
+
+```bash
+git clone https://github.com/RapierCraft/alterlab-mcp-server.git
+cd alterlab-mcp-server
+npm install
+npm run build
+```
+
+## Support
+
+- [API Documentation](https://docs.alterlab.io/api?utm_source=mcp&utm_medium=integration&utm_campaign=mcp_server)
+- [Dashboard & API Keys](https://app.alterlab.io/dashboard?utm_source=mcp&utm_medium=integration&utm_campaign=mcp_server)
+- [GitHub Issues](https://github.com/RapierCraft/alterlab-mcp-server/issues)
+- [support@alterlab.io](mailto:support@alterlab.io)
+
+## License
+
+[MIT](LICENSE)

package/dist/client.d.ts

@@ -0,0 +1,14 @@
+import { type Config } from "./config.js";
+import { type BalanceResponse, type CostEstimate, type UnifiedScrapeRequest, type UnifiedScrapeResponse } from "./types.js";
+export declare class AlterLabClient {
+    private apiKey;
+    private apiUrl;
+    private userAgent;
+    constructor(config: Config);
+    private request;
+    scrape(params: UnifiedScrapeRequest): Promise<UnifiedScrapeResponse>;
+    estimate(params: UnifiedScrapeRequest): Promise<CostEstimate>;
+    getBalance(): Promise<BalanceResponse>;
+    fetchScreenshotAsBase64(screenshotUrl: string): Promise<string>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +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"}

package/dist/client.js

@@ -0,0 +1,84 @@
+"use strict";
+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 MAX_RETRIES = 2;
+class AlterLabClient {
+    apiKey;
+    apiUrl;
+    userAgent;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.apiUrl = config.apiUrl;
+        this.userAgent = `alterlab-mcp-server/${VERSION}`;
+    }
+    async request(method, path, body, retryCount = 0) {
+        const url = `${this.apiUrl}${path}`;
+        const headers = {
+            "X-API-Key": this.apiKey,
+            "User-Agent": this.userAgent,
+            "Content-Type": "application/json",
+        };
+        const response = await fetch(url, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        // Retry transient errors (429, 503) — NOT 504 (credits may be consumed)
+        if ((response.status === 429 || response.status === 503) &&
+            retryCount < MAX_RETRIES) {
+            const retryAfter = response.headers.get("Retry-After");
+            const delay = retryAfter
+                ? parseInt(retryAfter, 10) * 1000
+                : Math.min(1000 * 2 ** retryCount, 8000);
+            await new Promise((resolve) => setTimeout(resolve, delay));
+            return this.request(method, path, body, retryCount + 1);
+        }
+        if (!response.ok) {
+            let detail;
+            try {
+                const errorBody = await response.json();
+                detail =
+                    typeof errorBody.detail === "string"
+                        ? errorBody.detail
+                        : JSON.stringify(errorBody.detail || errorBody);
+            }
+            catch {
+                detail = response.statusText;
+            }
+            const apiError = { status: response.status, detail };
+            throw apiError;
+        }
+        return (await response.json());
+    }
+    async scrape(params) {
+        return this.request("POST", "/api/v1/scrape", params);
+    }
+    async estimate(params) {
+        return this.request("POST", "/api/v1/scrape/estimate", params);
+    }
+    async getBalance() {
+        return this.request("GET", "/api/v1/billing/balance");
+    }
+    async fetchScreenshotAsBase64(screenshotUrl) {
+        // screenshot_url is a relative path like /downloads/screenshots/...
+        const fullUrl = screenshotUrl.startsWith("http")
+            ? screenshotUrl
+            : `${this.apiUrl}${screenshotUrl}`;
+        const response = await fetch(fullUrl, {
+            headers: {
+                "X-API-Key": this.apiKey,
+                "User-Agent": this.userAgent,
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to fetch screenshot: ${response.status} ${response.statusText}`);
+        }
+        const buffer = await response.arrayBuffer();
+        return Buffer.from(buffer).toString("base64");
+    }
+}
+exports.AlterLabClient = AlterLabClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,6 @@
+export interface Config {
+    apiKey: string;
+    apiUrl: string;
+}
+export declare function loadConfig(): Config;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,UAAU,IAAI,MAAM,CAiBnC"}

package/dist/config.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+function loadConfig() {
+    const apiKey = process.env.ALTERLAB_API_KEY;
+    if (!apiKey) {
+        console.error("Error: ALTERLAB_API_KEY environment variable is required.\n\n" +
+            "Get your API key at https://alterlab.io/dashboard/api-keys\n\n" +
+            "Then add it to your MCP config:\n" +
+            '  "env": { "ALTERLAB_API_KEY": "sk_live_..." }');
+        process.exit(1);
+    }
+    const apiUrl = process.env.ALTERLAB_API_URL?.replace(/\/+$/, "") ||
+        "https://api.alterlab.io";
+    return { apiKey, apiUrl };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;AAKA,gCAiBC;AAjBD,SAAgB,UAAU;IACxB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CACX,+DAA+D;YAC7D,gEAAgE;YAChE,mCAAmC;YACnC,gDAAgD,CACnD,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GACV,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACjD,yBAAyB,CAAC;IAE5B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,10 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+export interface ApiError {
+    status: number;
+    detail?: string;
+    url?: string;
+}
+export declare function formatErrorResult(error: ApiError | Error, context?: {
+    url?: string;
+}): CallToolResult;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,QAAQ,GAAG,KAAK,EACvB,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACzB,cAAc,CAmJhB"}