Alterlab
Web scraping MCP server — scrape, extract structured data, screenshot any site with anti-bot bypass.
Connector by alterlab.io · Domain verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/alterlab-io-mcp-server
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 26, 2026.
- Tools
- 15 read · 5 write · 1 delete · 5 not yet classified
- Secrets
- None asked for
- Install scripts
- None found
- Runs as
- Node.js package
Tools by what they do 26
Read from the source code; the running server may list different tools.
Read 15 · Look things up without changing anything.
alterlab_batch_statusalterlab_check_balancealterlab_crawl_statusalterlab_estimate_costalterlab_extractalterlab_get_jobalterlab_get_sessionalterlab_get_usagealterlab_list_beta_featuresalterlab_list_my_beta_featuresalterlab_list_sessionsalterlab_map
Show 3 more tools
alterlab_screenshotalterlab_searchalterlab_validate_session
Write 5 · Create, change, send or run things.
alterlab_crawl_cancelalterlab_create_sessionalterlab_disable_beta_featurealterlab_enable_beta_featurealterlab_update_session
Delete 1 · Delete, drop, revoke or wipe things.
alterlab_delete_session
Not yet classified 5 · We could not tell from the name and description.
alterlab_batchalterlab_batch_scrapealterlab_crawlalterlab_refresh_sessionalterlab_scrape
Network hosts it talks to 6
alterlab.io· found in codeapi.alterlab.io· found in codeapp.alterlab.io· found in codedocs.alterlab.io· found in codegithub.com· found in codeglama.ai· found in code
Files it touches
- Your home directory (~)
Tools (26)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
alterlab_batchScrape up to 100 URLs in parallel with a single request — much faster and more efficient than sequential alterlab_scrape calls. Each URL automatically gets anti-bot bypass protection (Cloudflare, DataDome, etc.) at its own tier level (tier 1 $0.0002 ... tier 4 $0.004 per URL). Returns a batch_id immediately — use alterlab_batch_status to poll results. Each URL can have its own mode, method/body, formats, extraction options, advanced options, location and cost_controls. Batch-level session_id, extraction_* and export apply to the whole batch. Credits are pre-debited based on estimated cost; unu…
alterlab_batch_scrapeScrape multiple URLs simultaneously and get all results back in one call — no polling required. Unlike alterlab_batch (async with batch_id polling), this returns all results inline when complete. Best for 2-20 URLs where you need results immediately. For 20+ URLs, use alterlab_batch instead. Uses concurrent scraping (controlled by max_concurrent) for speed. Shows per-URL status, content preview, and a total cost summary at the end. Handles partial failures gracefully — failed URLs show error details, successful ones show content.
alterlab_batch_statusPoll 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.
alterlab_check_balanceCheck 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.
alterlab_crawlCrawl an entire website for RAG, index all pages on a site, or build a knowledge base from a domain. Automatically bypasses anti-bot protection on every page — works on Cloudflare-protected sites. Discovers URLs via sitemap parsing and link extraction, then scrapes each page asynchronously. Each page is billed at the tier that succeeds (tier 1 $0.0002 ... tier 4 $0.004). Returns content as clean markdown, text, or structured data. Returns a crawl_id immediately — use alterlab_crawl_status to poll results. Use include_patterns/exclude_patterns to scope the crawl to specific sections; budget to …
alterlab_crawl_cancelCancel 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.
alterlab_crawl_statusPoll 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.
alterlab_create_sessionCreate 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.
alterlab_delete_sessionDelete a stored session. This permanently removes the session and its cookies. Use this when a session is no longer needed or has been compromised.
alterlab_disable_beta_featureOpt 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.
alterlab_enable_beta_featureOpt 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.
alterlab_estimate_costPreview the cost of scraping a URL before committing — no credits charged. Returns the predicted anti-bot tier, estimated cost per request, and confidence level. Call this before scraping protected or unfamiliar sites to avoid surprises. Tier 1 (curl): $0.0002. Tier 2 (http): $0.0003. Tier 3 (stealth): $0.002. Tier 3.5 (lightjs): $0.0025. Tier 4 (full browser): $0.004. Tier 5 (captcha solver): $0.02. Use render_js, use_proxy, screenshot, generate_pdf, ocr and method to see how options affect cost.
alterlab_extractExtract product data, scrape prices, get structured data from any page content, or pull specific fields like names, emails, and ratings from HTML. Runs AlterLab's extraction pipeline on raw HTML, text, or markdown you already have — does NOT scrape a URL. For scraping + extraction in one step, use alterlab_scrape with extraction_schema instead. Profiles: 'product' (price, title, reviews), 'article' (title, author, body), 'job_posting', 'faq', 'recipe', 'event', 'ecommerce_homepage', 'directory_listing'. Returns JSON data. Use extraction_prompt for natural language extraction (LLM-powered). Use…
alterlab_get_jobFetch 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.
alterlab_get_sessionGet 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.
Show 11 more tools
alterlab_get_usageGet 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.
alterlab_list_beta_featuresList 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.
alterlab_list_my_beta_featuresList 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.
alterlab_list_sessionsList 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.
alterlab_mapDiscover all URLs on a website, get a sitemap, or find specific pages within a large site. Lightweight URL discovery via sitemap parsing and link extraction — no content scraping, no JS rendering. Costs just $0.001 per call regardless of how many URLs are found (up to 50,000). Use this before alterlab_crawl or alterlab_batch to identify which pages to scrape. Returns a flat list of URLs with source (sitemap/link) and depth. Use include_patterns/exclude_patterns to scope discovery to specific sections. Use search to rank URLs by relevance to a query. Use include_metadata=true to also fetch page…
alterlab_refresh_sessionRefresh 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.
alterlab_scrapeDescription is built at runtime.
alterlab_screenshotTake a screenshot of any website, capture a webpage as an image, or snapshot a URL visually. Works on anti-bot protected sites (Cloudflare, DataDome, etc.) — uses the same bypass engine as alterlab_scrape. Returns a full-page PNG screenshot directly in the conversation — rendered with a real headless browser (tier 4 $0.004 + $0.0002 screenshot add-on). Use wait_for to wait for a specific element before capturing. Use wait_until to control page load timing (networkidle, domcontentloaded, load). Use session_id or cookies to capture pages behind a login. For the full set of scrape options (action…
alterlab_searchSearch the web, find information online, look up any topic, or research a subject across the internet. Returns search results with URLs, titles, and snippets from multiple search engines. Uses AlterLab's SERP engine with Google/Bing/DuckDuckGo multi-engine failover for reliable results. Costs $0.001 per search query on the default duckduckgo engine; engine='google' or 'bing' costs $0.004 per query. Set scrape_results=true to also scrape each result page (with anti-bot bypass) and get full content — each page is billed at its normal scraping tier cost. Use domain to restrict results to a specif…
alterlab_update_sessionUpdate 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.
alterlab_validate_sessionValidate 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.
Signals
- Stars
- 1
- Forks
- 2
- Open issues
- 18
- Last commit
- Oct 16, 2026 (13 days ago)
- Last release
- Oct 16, 2026 (13 days ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.alterlab/mcp-server- Version
- 1.9.0
- Auth
- No auth
- Packages
- npm alterlab-mcp-server
- License
- MIT
- First seen
- Oct 24, 2026
- Last checked
- Oct 25, 2026
Cite this page
Alterlab MCP server. Agent Mart. https://agentmart.dev/connectors/alterlab-io-mcp-server (last updated 2026-10-25)