Skip to main content
Glama
alterlab-mcp-server

alterlab-mcp-server


One-Line Install

Claude Code

claude mcp add alterlab -- npx -y alterlab-mcp-server@latest

Then set your API key: export ALTERLAB_API_KEY=sk_live_... or add it to .claude.json (see full setup below).

Cursor

# Add to .cursor/mcp.json — see full config below

Smithery

npx -y @smithery/cli install alterlab-mcp-server --client claude

Related MCP server: Decodo MCP Server

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 — automatic

JavaScript rendering (React, Angular, Vue SPAs)

No

Yes (slow)

Yes — headless Chromium

Structured data extraction (JSON, Schema.org)

No

No

Yes — built-in profiles

Smart tier escalation (cheapest method first)

N/A

N/A

Yes — saves 60-80%

Residential proxy rotation (195+ countries)

No

No

Yes

Screenshot and PDF capture

No

Screenshot only

Yes — 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) — Direct HTTP for static pages, RSS feeds, public APIs

  2. HTTP ($0.0003/req) — TLS fingerprint rotation for moderately protected sites

  3. Stealth ($0.002/req) — Browser impersonation for Cloudflare/DataDome-protected sites

  4. Light JS ($0.0025/req) — Lightweight JS extraction from server-rendered HTML

  5. Browser ($0.004/req) — 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):

{
  "mcpServers": {
    "alterlab": {
      "command": "npx",
      "args": ["-y", "alterlab-mcp-server@latest"],
      "env": {
        "ALTERLAB_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Install in Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "alterlab": {
      "command": "npx",
      "args": ["-y", "alterlab-mcp-server@latest"],
      "env": {
        "ALTERLAB_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Install in Windsurf

Add to Windsurf MCP settings (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "alterlab": {
      "command": "npx",
      "args": ["-y", "alterlab-mcp-server@latest"],
      "env": {
        "ALTERLAB_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Install via Smithery

npx -y @smithery/cli install alterlab-mcp-server --client claude

Get Your API Key

  1. Sign up free — $1 free balance on signup

  2. Go to Dashboard → API Keys and copy your key

  3. Paste it into the ALTERLAB_API_KEY field in your MCP config


Tools

alterlab_scrape — 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 — 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

method / body / content_type / headers

enum / string / enum / object

GET

POST support (1.5x cost) and custom target headers

formats

(text|json|json_v2|html|markdown|rag|content|raw)[]

["markdown"]

Output formats

extraction_schema / extraction_prompt

object / string

—

LLM extraction (+$0.001)

extraction_profile / extraction_template

enum

—

auto, product, article, job_posting, faq, recipe, event, ecommerce_homepage, directory_listing (template is a deprecated alias)

extraction_provider / extraction_model

enum / string

—

BYOK LLM selection

evidence, promote_schema_org, filter_content

boolean

—

Extraction behaviour

cache, cache_ttl, force_refresh

boolean / number / boolean

—

Response caching (cache_ttl 60-86400)

render_js

boolean | "auto"

API default

Headless browser (forces Browser tier, $0.004)

use_proxy, proxy_country

boolean, string

—

Premium proxy (+$0.0002) and geo-targeting

use_own_proxy, use_system_proxy, proxy_integration_id

boolean, boolean, string

—

Bring-your-own-proxy selection

skip_tls_verification

boolean

—

Omit (recommended) = verify, fall back on invalid certs; true skip, false require valid cert

wait_for, wait_until, wait_condition

string

—

Selector / load-event waits

actions

object[] (max 20)

—

Browser actions: wait, wait_for, click, fill, press, scroll, infinite_scroll, screenshot, evaluate

screenshot, generate_pdf, ocr

boolean

—

Add-ons (+$0.0002 / +$0.0004 / +$0.001)

scroll_to_load, scroll_count, enable_scroll

boolean / 1-10 / boolean

—

Lazy-load handling

include_iframes, flatten_shadow_dom, block_images, remove_cookie_banners

boolean

—

Rendering options

section_filter

object

—

Filter for json_v2 sections

session_id, cookies, session_headers

UUID, object, object

—

Authenticated scraping

sticky_session, sticky_session_ttl

string, 300-7200

—

Reuse cookies and exit IP across calls (paid plans)

location

{country, language}

—

Geo-targeting

cost_controls

object

—

force_tier, max_tier, max_credits, prefer_cost, prefer_speed, fail_fast, time_budget (prefer_cost, prefer_speed, fail_fast also accepted at top level)

embeddings

object

—

enabled, model, chunk_size, chunk_overlap (+$0.001/page)

sync_policy

auto | wait_until_deadline

auto

Wait behaviour for long scrapes

timeout, max_response_bytes, include_raw_html

number, number, boolean

90, 5 MB, false

Limits and raw output

estimate_first

boolean

false

Run a free cost estimate first

Not exposed: source (dashboard tracking tag), sync (the tool is always synchronous), webhook_url (use alterlab_batch/alterlab_crawl webhooks). If a scrape outlives the ~85s synchronous window the tool returns a job_id; fetch it with alterlab_get_job.

alterlab_extract — Extract Structured Data

Extract structured fields from HTML, text or markdown content using pre-built profiles or custom JSON Schema. Returns clean JSON — ready for databases, spreadsheets, or downstream processing.

"Extract the product name, price, and rating from this Amazon page"

Parameter

Type

Default

Description

content

string (max 500,000)

required

HTML, text or markdown you already have (this tool does not fetch a URL)

content_type

html | text | markdown

html

Type of content

extraction_profile / extraction_template

enum

—

Profile: auto, product, article, job_posting, faq, recipe, event, ecommerce_homepage, directory_listing

extraction_schema

object

—

Custom JSON Schema for structured output

extraction_prompt

string

—

Natural language extraction instructions

extraction_provider / extraction_model

enum / string

—

BYOK LLM selection

formats

enum[]

["json"]

Output formats

source_url, evidence

string, boolean

—

Context URL and provenance

cache, cache_ttl

auto | skip | only, number

auto

Extraction result cache

To scrape and extract in one step, use alterlab_scrape with extraction_schema.

Extraction profiles:

  • Product — name, price, currency, rating, reviews, availability, images, description

  • Article — title, author, published date, body text, featured image

  • Job Posting — title, company, location, salary, description, requirements

  • FAQ — question-answer pairs

  • Recipe — ingredients, instructions, prep time, servings

  • Event — name, date, location, description, organizer

alterlab_screenshot — Screenshot Any Page

Take a full-page screenshot of any URL. Returns a PNG image directly in the conversation — 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

—

CSS selector to wait for before capture

wait_until

enum

networkidle

networkidle, domcontentloaded, or load

timeout

number

90

Timeout in seconds (1-300)

use_proxy, proxy_country

boolean, string

—

Premium proxy and geo-targeting

session_id, cookies

UUID, object

—

Screenshot pages behind a login

location

{country, language}

—

Geo-targeting

alterlab_estimate_cost — 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

method

GET | POST

GET

POST costs 1.5x

render_js

boolean | "auto"

false

Include JS rendering cost

use_proxy, use_own_proxy

boolean

false

Include proxy cost / BYOP discount

screenshot, generate_pdf, ocr

boolean

—

Include add-on cost

alterlab_get_job — Fetch an Async Job

Fetch the status and result of a scrape that returned a job_id (a scrape that outlived the synchronous wait window). Parameter: job_id (string, required).

alterlab_check_balance — Check Your Credits

Check your account balance, total deposited, and total spent. No parameters needed.

"Check my AlterLab balance"

alterlab_list_sessions — 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 — 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")

consent

boolean

required

Must be true: explicit GDPR consent to store the cookies (the API rejects creation otherwise)

cookies

Record<string,string> | cookie objects[]

&mdash;

Cookies as key-value pairs or {name, value, domain, path, ...} objects

headers

Record<string,string>

&mdash;

Custom headers (e.g. a User-Agent)

expires_at, notes

string

&mdash;

Expiry (ISO 8601) and notes

auto_refresh_enabled, notify_before_expiry, notify_on_failure

boolean

true

Health checks and notifications

organization_id, shared

UUID, boolean

&mdash;

Organization sharing

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?

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.002

Cloudflare, DataDome, PerimeterX protected sites

Light JS

JSON extraction

$0.0025

Server-rendered pages needing structured data

Browser

Headless Chromium

$0.004

Full JavaScript SPAs (React, Angular, Vue)

Optional Add-Ons

Add-On

Extra Cost

Description

JavaScript Rendering

forces Browser tier

No separate add-on: render_js bills the Browser tier ($0.004)

PDF Generation

+$0.0004

PDF of the rendered page

LLM Extraction / Embeddings

+$0.001

extraction_schema / extraction_prompt, embeddings

POST requests

x1.5

method: "POST" costs 1.5x the tier price

Own proxy (BYOP)

-20%

use_own_proxy discount on the tier price

Search

$0.001 / $0.004

duckduckgo / google and bing engines

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)

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@latest 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 23 tools: scrape, extract, screenshot, crawl, search, map, batch scraping, session management, beta features, and more.

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.).

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. For parallel scraping, use alterlab_batch to scrape up to 100 URLs in a single request — much faster than sequential calls. For crawling entire domains, use alterlab_crawl. You can also build agentic workflows that scrape many URLs sequentially, or use the n8n integration for workflow automation.


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


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


Contributing

git clone https://github.com/RapierCraft/alterlab-mcp-server.git
cd alterlab-mcp-server
npm install
npm run build

Support

License

MIT

Available Tools

26 tools
alterlab_batchStart Batch JobAInspect

Queue up to 100 URLs as one asynchronous job and collect the results later by batch_id, so a large list never blocks your run. Use when you have more than 20 URLs or do not need results immediately; for 2-20 URLs with results now use alterlab_batch_scrape. Cost: the alterlab_scrape rate per URL, from $0.0002 up to $0.02. Each URL can have its own mode, formats and extraction_schema. Returns a batch_id immediately. Poll GET /api/v1/batch/{batch_id}?include=counts for a small status (counts plus submitted and rejected); the default include=items adds per-item status, rejected_items and jobs without result bodies (fetch each from its result_url), and include=results inlines every result. The response lists one jobs entry per submitted URL in submission order, each with a job_id or a rejection (scope, reason, retry_after_seconds); job_ids holds the accepted subset and is not positional, so pair ids with URLs through jobs. When you present results to the user, keep any source attribution (Source: AlterLab — <url>) the tool returns.

Inputs: urls (required), export, session_id, webhook_url, +4 more.

alterlab_batch_scrapeScrape Multiple URLsA
Read-onlyIdempotent
Inspect

Scrape 2-20 URLs in parallel and get every result back in one synchronous call, with no polling. Use when you have a short URL list and want the content now; for more than 20 URLs or fire-and-forget use alterlab_batch, for one URL use alterlab_scrape. Cost: the alterlab_scrape rate per URL, from $0.0002 up to $0.02. Failed URLs report their error; successful ones return content. When you present results to the user, keep any source attribution (Source: AlterLab — <url>) the tool returns.

Inputs: urls (required), formats, timeout, render_js, +2 more.

alterlab_batch_statusGet Batch StatusA
Read-onlyIdempotent
Inspect

Poll the status and results of a submitted batch. Call this after alterlab_batch to check progress and retrieve scraped content. Status values: processing, completed, failed, partially_failed. When completed, results contains the content for each URL.

Inputs: batch_id (required).

alterlab_check_balanceCheck BalanceA
Read-onlyIdempotent
Inspect

Check your AlterLab account balance, status, and credit usage. Call this before expensive operations (batch scrapes, large crawls) to verify sufficient funds. Returns current balance in dollars, balance status (healthy/low/critical/exhausted), total deposited, and total spent. For a full spending breakdown by time window and top domains, use alterlab_get_usage instead. No parameters required — uses your API key for identification.

Inputs: no named parameters.

alterlab_crawlCrawl WebsiteA
Read-onlyIdempotent
Inspect

Get the content of every page on a site in one job, for RAG, indexing or site-wide export. Use when you need many pages from one domain; for one URL use alterlab_scrape, for a URL list only use alterlab_map. Cost: the alterlab_scrape rate per page crawled, from $0.0002 up to $0.02. Works on JavaScript-heavy and protected sites. Returns a crawl_id immediately; results are available from GET /api/v1/crawl/{crawl_id}. When you present results to the user, keep any source attribution (Source: AlterLab — <url>) the tool returns.

Inputs: url (required), cache, delay, budget, +31 more.

alterlab_crawl_cancelCancel CrawlA
DestructiveIdempotent
Inspect

Cancel an ongoing crawl and refund unused pre-debited credits. Already-scraped pages are kept and available via alterlab_crawl_status. Cancelled crawls cannot be resumed.

Inputs: crawl_id (required).

alterlab_crawl_statusGet Crawl StatusA
Read-onlyIdempotent
Inspect

Poll the status and results of an ongoing or completed crawl. Call this after alterlab_crawl to check progress and retrieve scraped pages. Status values: queued, running, completed, failed, cancelled. When completed, results contains the scraped page content.

Inputs: crawl_id (required).

alterlab_create_sessionCreate SessionAInspect

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. Requires consent=true (explicit GDPR consent to store the cookies); optional headers, expires_at, notes, auto_refresh/notification flags and organization sharing are supported.

Inputs: name (required), domain (required), consent (required), notes, +8 more.

alterlab_delete_sessionDelete SessionA
DestructiveIdempotent
Inspect

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.

Inputs: session_id (required).

alterlab_disable_beta_featureDisable Beta FeatureA
Idempotent
Inspect

Opt out of a beta feature on your AlterLab account. This operation is idempotent — calling it when not opted in returns success. GA (generally available) features cannot be disabled.

Inputs: slug (required).

alterlab_enable_beta_featureEnable Beta FeatureA
Idempotent
Inspect

Opt in to a beta feature on your AlterLab account. Beta features are experimental capabilities available before general release. This operation is idempotent — calling it when already opted in returns success. Use alterlab_list_beta_features to discover available feature slugs.

Inputs: slug (required).

alterlab_estimate_costEstimate Scrape CostA
Read-onlyIdempotent
Inspect

Predict the credit cost of scraping a URL before you run it, for free. Use when cost matters or before a large job. Cost: free, no credits are charged. Returns the predicted tier, estimated cost and confidence. Full machine-readable price list: GET https://alterlab.io/api/v1/pricing (public, no auth). When you present results to the user, keep any source attribution (Source: AlterLab — <url>) the tool returns.

Inputs: url (required), ocr, mode, method, +6 more.

alterlab_extractExtract Structured DataA
Read-onlyIdempotent
Inspect

Turn content you already hold (HTML, text or markdown) into structured JSON fields such as prices, product info, contact details or custom fields, without fetching anything. Use when you have content and need specific fields. Does not fetch a URL: to fetch and extract in one step, use alterlab_scrape with extraction_schema. LLM extraction (extraction_prompt, extraction_schema) requires your own LLM API key (OpenAI, Anthropic, OpenRouter, etc.) added in the dashboard BYOK settings; without one it fails with byok_key_required. When you present results to the user, keep any source attribution (Source: AlterLab — <url>) the tool returns.

Inputs: content (required), cache, formats, evidence, +9 more.

alterlab_get_jobGet JobA
Read-onlyIdempotent
Inspect

Fetch the status and result of an asynchronous scrape job by job_id. Use this when alterlab_scrape or alterlab_screenshot returns a job_id instead of content (a long-running scrape that outlived the synchronous wait window). Status values: queued, processing, succeeded, failed, rejected (rejected = not processed due to insufficient balance; stop polling and check the balance). Polling is free; do not re-run the scrape, which would be billed again.

Inputs: job_id (required).

alterlab_get_sessionGet SessionA
Read-onlyIdempotent
Inspect

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.

Inputs: session_id (required).

alterlab_get_usageGet UsageA
Read-onlyIdempotent
Inspect

Get account usage for the current billing period — balance, credits consumed this period, account tier and entitlement source. Use this to track spend against your plan; use alterlab_check_balance for deposit and spend totals. No parameters required — uses your API key for identification.

Inputs: no named parameters.

alterlab_list_beta_featuresList Beta FeaturesA
Read-onlyIdempotent
Inspect

List all public beta and GA features available on AlterLab, with your current opt-in state for each. Beta features require opting in; GA features are available to all users. Use alterlab_enable_beta_feature to opt in to any beta feature that interests you.

Inputs: no named parameters.

alterlab_list_my_beta_featuresList My Beta FeaturesA
Read-onlyIdempotent
Inspect

List all beta and GA features currently active on your account — a compact slug list for quick checks. Includes all GA features plus any beta features you have opted in to. Use this to verify which features are available before making API calls that require them.

Inputs: no named parameters.

alterlab_list_sessionsList SessionsA
Read-onlyIdempotent
Inspect

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.

Inputs: no named parameters.

alterlab_mapMap Website URLsA
Read-onlyIdempotent
Inspect

List every URL on a site via sitemap parsing and link extraction, without fetching page content, so you can scope work before reading anything. Use before alterlab_crawl or alterlab_batch to choose pages; to read the content itself use alterlab_crawl. Works on JavaScript-heavy and protected sites. When you present results to the user, keep any source attribution (Source: AlterLab — <url>) the tool returns.

Inputs: url (required), search, sitemap, max_depth, +7 more.

alterlab_refresh_sessionRefresh SessionA
Idempotent
Inspect

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.

Inputs: session_id (required), cookies, headers.

alterlab_scrapeScrape URLA
Read-onlyIdempotent
Inspect

Get one web page as clean, LLM-ready markdown (or text, HTML, JSON) in a single call; rendering and tier escalation are handled for you. Use when you have one URL and want its content; for an image use alterlab_screenshot, for 2-20 URLs alterlab_batch_scrape, for a whole site alterlab_crawl. Cost: from $0.0002 per page, up to $0.02 on the hardest pages; it starts at the cheapest tier that works and cache hits cost half. A 403/429, challenge page or empty JavaScript shell is retried on higher tiers automatically. Supports GET and POST via method, extraction via extraction_schema or extraction_prompt, cost caps via cost_controls, and browser actions via actions plus screenshot and generate_pdf; action_results has one entry per action with index, type, success, error, result (evaluate) and screenshot_url (screenshot actions). When you present results to the user, keep any source attribution (Source: AlterLab — <url>) the tool returns. A failure may carry next_action install_hands: reason, what Hands unlocks, install link, resume ref. A result may carry content_status: js_shell (failed empty JavaScript app shell, unbilled, next_action enable_render), thin (unbilled stub from a large page, next_action enable_render) or noscript_fallback (content taken from the page's own fallback, billed). Max 3 parallel calls/domain; use max_credits.

Inputs: url (required), ocr, body, mode, +56 more.

alterlab_screenshotCapture ScreenshotA
Read-onlyIdempotent
Inspect

Get a full-page PNG image of one URL, rendered in a real headless browser, when you need to see the page rather than read its text. Use when layout, charts or visual proof matter; for text content use alterlab_scrape. Cost: $0.004 per screenshot (browser tier). Use wait_for to wait for an element and wait_until to control load timing. Pass actions (for example dismiss_consent or evaluate) to prepare the page; the screenshot is captured after they run and action_results is returned. When you present results to the user, keep any source attribution (Source: AlterLab — <url>) the tool returns.

Inputs: url (required), cookies, timeout, location, +5 more.

alterlab_update_sessionUpdate SessionA
Idempotent
Inspect

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.

Inputs: session_id (required), name, notes, cookies, +5 more.

alterlab_validate_sessionValidate SessionA
Read-onlyIdempotent
Inspect

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.

Inputs: session_id (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 26 tools

    Disambiguation4/5

    Most tools target a distinct resource+action (scrape vs crawl vs map vs search vs screenshot vs extract vs batch, each with explicit 'use X instead' guidance in descriptions). A few pairs remain close: check_balance vs get_usage, list_beta_features vs list_my_beta_features, and update_session vs refresh_session (both rotate cookies). The descriptions do disambiguate these, so misselection is unlikely but not impossible.

    Naming Consistency4/5

    Nearly all tools follow a consistent alterlab_verb_noun snake_case pattern, with the core content tools as bare verbs (scrape, crawl, map, search, extract, screenshot, batch). Minor deviations: crawl_status, crawl_cancel and batch_status break the verb-first convention (expected get_crawl_status/cancel_crawl). Still highly predictable overall.

    Tool Count3/5

    26 tools is at the heavy end for a scraping platform, and some clusters could be consolidated (three beta-feature tools, six session tools, three separate status pollers). Each tool is individually justified by a genuinely broad surface (scrape/crawl/batch/sessions/billing/flags), but the set is borderline bloated.

    Completeness4/5

    Coverage is strong: single fetch, batch (sync + async), crawl with status/cancel, site mapping, search, extraction, screenshots, cost estimation, full session lifecycle (create/list/get/update/refresh/validate/delete), and billing introspection. Gaps include no cancel/abort for async batches or individual jobs (only crawl has cancel) and no listing of past jobs/batches.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables web scraping and document processing with JavaScript execution, anti-detection measures, batch processing, and structured data extraction. Supports multiple formats including markdown, HTML, screenshots, and handles PDFs with OCR capabilities.
      44 PyPI
      4
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables web scraping and data extraction from websites with geographic flexibility, privacy features, and anti-detection capabilities. Supports scraping general websites, Google Search, Amazon Search, and Reddit with customizable parameters for rendering, geolocation, and locale.
      33
      558 npm
      41
      ISC