How do I install the metalift MCP server?

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "metalift": { "command": "npx", "args": ["-y", "metalift"] } }

Is the metalift MCP server free to use?

Yes. metalift is listed on AllMCPs as a free, open Model Context Protocol server you can install into Claude Desktop, Cursor, or any MCP-compatible client.

How do I install the metalift MCP server?

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "metalift": { "command": "npx", "args": ["-y", "metalift"] } }

Is the metalift MCP server free to use?

Yes. metalift is listed on AllMCPs as a free, open Model Context Protocol server you can install into Claude Desktop, Cursor, or any MCP-compatible client.

Documentation Overview

@metalift/mcp

Metalift MCP server for AI agents. Exposes scrape, crawl, map, and batch tools over stdio for Cursor, Claude Desktop, and other MCP clients.

What is Metalift?

Metalift Cloud is a hosted web context platform — scrape, crawl, and map sites into LLM-ready markdown for AI agents. This MCP server connects your AI client to the Metalift API.

Get an API key

Sign up for Metalift Cloud and verify your email.
Complete onboarding and copy your API key from Dashboard → API keys.

New accounts receive 1,000 free credits/month. Set METALIFT_API_KEY in your MCP config (see below). Do not commit keys to git.

Install

Published on npm as @metalift/mcp. Default config uses npx:

config.json

{
  "mcpServers": {
    "metalift": {
      "command": "npx",
      "args": ["-y", "@metalift/mcp"],
      "env": {
        "METALIFT_API_URL": "https://api.metalift.ai",
        "METALIFT_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop: paste the same JSON into claude_desktop_config.json (Settings → Developer → Edit Config). See MCP setup — Claude Desktop and examples/claude-mcp.json.

Corporate Windows / SSL inspection: if npx fails with UNABLE_TO_VERIFY_LEAF_SIGNATURE, install locally and use node — see examples/claude-mcp-local.json / cursor-mcp-local.json and MCP setup troubleshooting.

Troubleshooting

Error	Cause	Fix
`Failed to acquire MessagePort`	Cursor IDE bug on Windows	Reload window, restart Cursor — details
`UNABLE_TO_VERIFY_LEAF_SIGNATURE`	Corporate SSL inspection blocks npm	Local install + `node` path — details
401 / 402 at runtime	Auth or billing	Check API key and subscription

Full guide: packages/platform-web/docs/mcp-setup.md.

Web search vs scrape

Search and scrape are separate tools with separate billing:

metalift_web_search — returns up to 10 search snippets (2 credits, English by default). Review titles and snippets first.
metalift_scrape — fetches page content for URLs you choose (1+ credits per URL). Default response_detail=compact (~16k chars, no link lists). Use standard for full articles or full for raw JSON with all links.

Do not auto-scrape every search result. See Web search for agent workflow examples.

Environment variables

Variable	Description
`METALIFT_API_URL`	Metalift scrape API base URL (default: `https://api.metalift.ai`)
`METALIFT_API_KEY`	Bearer token for authenticated API access

Tools

Tool	Description
`metalift_scrape`	Scrape a single URL (default: fast direct static markdown, `response_detail=compact`; use `standard` / `full` for more)
`metalift_batch_scrape`	Scrape multiple URLs (same `response_detail`; default `compact`)
`metalift_crawl`	Crawl a website
`metalift_map`	Discover site URLs from page HTML links
`metalift_sitemap`	Fetch XML sitemap URLs (robots.txt / sitemap.xml)
`metalift_web_search`	Web search — top 10 SERP results (title, url, snippet). 2 credits per search. Does not fetch page content; use `metalift_scrape` separately for URLs you need
`metalift_job_status`	Poll async jobs
`metalift_list_strategies`	List scrape strategies
`metalift_seed_session`	Store browser session cookies for a domain
`metalift_warm_session`	Warm WAF/retail cookies
`metalift_list_sessions`	List stored domain sessions

Documentation Overview

@metalift/mcp

Metalift MCP server for AI agents. Exposes scrape, crawl, map, and batch tools over stdio for Cursor, Claude Desktop, and other MCP clients.

What is Metalift?

Metalift Cloud is a hosted web context platform — scrape, crawl, and map sites into LLM-ready markdown for AI agents. This MCP server connects your AI client to the Metalift API.

Get an API key

Sign up for Metalift Cloud and verify your email.
Complete onboarding and copy your API key from Dashboard → API keys.

New accounts receive 1,000 free credits/month. Set METALIFT_API_KEY in your MCP config (see below). Do not commit keys to git.

Install

Published on npm as @metalift/mcp. Default config uses npx:

config.json

{
  "mcpServers": {
    "metalift": {
      "command": "npx",
      "args": ["-y", "@metalift/mcp"],
      "env": {
        "METALIFT_API_URL": "https://api.metalift.ai",
        "METALIFT_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop: paste the same JSON into claude_desktop_config.json (Settings → Developer → Edit Config). See MCP setup — Claude Desktop and examples/claude-mcp.json.

Troubleshooting

Error	Cause	Fix
`Failed to acquire MessagePort`	Cursor IDE bug on Windows	Reload window, restart Cursor — details
`UNABLE_TO_VERIFY_LEAF_SIGNATURE`	Corporate SSL inspection blocks npm	Local install + `node` path — details
401 / 402 at runtime	Auth or billing	Check API key and subscription

Full guide: packages/platform-web/docs/mcp-setup.md.

Web search vs scrape

Search and scrape are separate tools with separate billing:

metalift_web_search — returns up to 10 search snippets (2 credits, English by default). Review titles and snippets first.
metalift_scrape — fetches page content for URLs you choose (1+ credits per URL). Default response_detail=compact (~16k chars, no link lists). Use standard for full articles or full for raw JSON with all links.

Do not auto-scrape every search result. See Web search for agent workflow examples.

Environment variables

Variable	Description
`METALIFT_API_URL`	Metalift scrape API base URL (default: `https://api.metalift.ai`)
`METALIFT_API_KEY`	Bearer token for authenticated API access

Tools

Tool	Description
`metalift_scrape`	Scrape a single URL (default: fast direct static markdown, `response_detail=compact`; use `standard` / `full` for more)
`metalift_batch_scrape`	Scrape multiple URLs (same `response_detail`; default `compact`)
`metalift_crawl`	Crawl a website
`metalift_map`	Discover site URLs from page HTML links
`metalift_sitemap`	Fetch XML sitemap URLs (robots.txt / sitemap.xml)
`metalift_web_search`	Web search — top 10 SERP results (title, url, snippet). 2 credits per search. Does not fetch page content; use `metalift_scrape` separately for URLs you need
`metalift_job_status`	Poll async jobs
`metalift_list_strategies`	List scrape strategies
`metalift_seed_session`	Store browser session cookies for a domain
`metalift_warm_session`	Warm WAF/retail cookies
`metalift_list_sessions`	List stored domain sessions

Metalift

Quick Install

Install Config Generator

Documentation Overview

@metalift/mcp

What is Metalift?

Get an API key

Install

Troubleshooting

Web search vs scrape

Environment variables

Tools

Related MCP Servers

Frequently Asked Questions about Metalift

AllMCPs Directory Badge

Technical Specs & Signals

Moxie Docs MCP

Own this project?

Share & Embed

Explore more

Metalift

Quick Install

Install Config Generator

Documentation Overview

@metalift/mcp

What is Metalift?

Get an API key

Install

Troubleshooting

Web search vs scrape

Environment variables

Tools

Related MCP Servers

Frequently Asked Questions about Metalift

AllMCPs Directory Badge

Technical Specs & Signals

Moxie Docs MCP

Own this project?

Share & Embed

Explore more