metalift-mcp
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| METALIFT_API_KEY | Yes | Bearer token for authenticated API access | |
| METALIFT_API_URL | No | Metalift scrape API base URL (default: https://api.metalift.ai) | https://api.metalift.ai |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| metalift_scrapeA | Scrape a single URL into markdown, HTML, or text. Default: fast static article path (1 credit, response_detail=compact). E-commerce hosts auto-route to retail/residential. Pass strategy=auto for WAF/SPA pages. Fetch metalift://agent-guide for session workflow. You are solely responsible for complying with website terms, robots.txt, copyright, and data protection laws when using scraped content. |
| metalift_batch_scrapeA | Scrape up to 100 URLs in parallel (billed per URL). Default response_detail=compact. Use async=true for background jobs; wait=true blocks with progress. For JS-heavy pages set strategy=auto in scrape_options. You are solely responsible for complying with website terms, robots.txt, copyright, and data protection laws when using scraped content. |
| metalift_crawlA | Crawl a site from a seed URL and return markdown for discovered pages (1+ credits per page). Default wait=true blocks with progress; wait=false returns job id for metalift_job_status. |
| metalift_sitemapA | Fetch XML sitemap URLs for a site. Discovers sitemap locations from robots.txt (Sitemap: directives) or /sitemap.xml, follows sitemap indexes, and returns page URLs with optional lastmod/changefreq/priority. Costs 1 credit. Prefer this over metalift_map when you need the site's published URL list. |
| metalift_mapA | Discover same-origin links by parsing HTML anchors on one page (1 credit). Fallback when metalift_sitemap is unavailable. Does not fetch full page content. |
| metalift_web_searchA | Search the web and return up to 10 SERP results (title, url, snippet, engine, score). Costs 2 credits per search. Returns search snippets only — not page content. Answer simple questions from snippets; do not auto-scrape. Call metalift_scrape separately only when full page content is required. |
| metalift_job_statusA | Poll async crawl or batch job status and results. Returns human-readable progress (pages completed, credits charged). |
| metalift_list_strategiesA | List scrape strategies with protection levels and credit estimates. Use before scraping unknown protected sites. |
| metalift_seed_sessionA | Store browser session credentials for a domain (org-scoped). Prefer full Playwright storage_state JSON from the user's browser — preserves cookies + localStorage for fingerprint-coherent replay via unified browser session on later scrapes. Fallback: cookie_header + user_agent from DevTools. |
| metalift_warm_sessionA | Automated browser warmup to collect cookies for later scrapes (15 credits). Use when manual metalift_seed_session is not possible; often fails on strict WAFs. |
| metalift_list_sessionsA | List org-scoped browser sessions stored via metalift_seed_session. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| summarize_page | Scrape a URL and summarize its main content |
| extract_schema | Scrape a page and extract structured data matching a schema |
| compare_pages | Scrape multiple pages and compare their content |
| research_topic | Search the web for a topic, then scrape only the most relevant URLs (decoupled search + scrape workflow) |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| config | Current Metalift API connection settings |
| agent-guide | Extended workflow guidance for session handling, WAF sites, and tool selection |
| health | API health and readiness |
TDQS
Scored across 11 tools
Each tool targets a clearly distinct operation: single scrape, batch scrape, crawl, sitemap, link discovery, web search, job status, strategy listing, and session management. There is no meaningful overlap that could confuse an agent.
All tools share the metalift_ prefix and use lowercase with underscores, but the pattern mixes bare verbs (scrape, crawl), nouns (sitemap, map), and compound verb-noun forms (web_search, seed_session). This is still highly readable and predictable.
Eleven tools is well-scoped for a scraping/search/session-management server. Each tool earns its place, covering the core workflows without unnecessary bloat.
The tool set covers the primary lifecycle: scrape, batch scrape, crawl, discover URLs via sitemap/map, search, and monitor async jobs. Session management includes seed, warm, and list, but lacks explicit delete or get-detail operations, which are minor gaps.