English Français العربية

io.github.MetaLift-AI/metalift

Official registry Search and web

Metalift MCP for AI agents: web search (2 credits), scrape, crawl, and map tools

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @metalift/mcp
Claude Code 
claude mcp add metalift -e 'METALIFT_API_URL=<METALIFT_API_URL>' -e 'METALIFT_API_KEY=<your metalift_api_key>' -- npx -y @metalift/mcp@1.0.15
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "metalift": {
            "command": "npx",
            "args": [
                "-y",
                "@metalift/mcp@1.0.15"
            ],
            "env": {
                "METALIFT_API_URL": "<METALIFT_API_URL>",
                "METALIFT_API_KEY": "<your metalift_api_key>"
            }
        }
    }
}

Environment variables

  • METALIFT_API_URL required Metalift scrape API base URL
  • METALIFT_API_KEY required secret API key from https://app.metalift.ai/dashboard/keys

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @metalift/mcp
  2. What is Metalift?
  3. Get an API key
  4. Install
  5. Troubleshooting
  6. Web search vs scrape
  7. Environment variables
  8. Tools

@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

  1. Sign up for Metalift Cloud and verify your email.
  2. 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:

{
  "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

ErrorCauseFix
Failed to acquire MessagePortCursor IDE bug on WindowsReload window, restart Cursor — details
UNABLE_TO_VERIFY_LEAF_SIGNATURECorporate SSL inspection blocks npmLocal install + node path — details
401 / 402 at runtimeAuth or billingCheck 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:

  1. metalift_web_search — returns up to 10 search snippets (2 credits, English by default). Review titles and snippets first.
  2. 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

VariableDescription
METALIFT_API_URLMetalift scrape API base URL (default: https://api.metalift.ai)
METALIFT_API_KEYBearer token for authenticated API access

Tools

ToolDescription
metalift_scrapeScrape a single URL (default: fast direct static markdown, response_detail=compact; use standard / full for more)
metalift_batch_scrapeScrape multiple URLs (same response_detail; default compact)
metalift_crawlCrawl a website
metalift_mapDiscover site URLs from page HTML links
metalift_sitemapFetch XML sitemap URLs (robots.txt / sitemap.xml)
metalift_web_searchWeb 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_statusPoll async jobs
metalift_list_strategiesList scrape strategies
metalift_seed_sessionStore browser session cookies for a domain
metalift_warm_sessionWarm WAF/retail cookies
metalift_list_sessionsList stored domain sessions

Frequently asked questions

What is io.github.MetaLift-AI/metalift?

Metalift MCP for AI agents: web search (2 credits), scrape, crawl, and map tools

How do I install io.github.MetaLift-AI/metalift?

It runs on your machine. In Claude Code: claude mcp add metalift -e 'METALIFT_API_URL=<METALIFT_API_URL>' -e 'METALIFT_API_KEY=<your metalift_api_key>' -- npx -y @metalift/mcp@1.0.15. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.MetaLift-AI/metalift need an API key?

Yes. It expects METALIFT_API_URL, METALIFT_API_KEY, which you set in its configuration.

Is io.github.MetaLift-AI/metalift open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.MetaLift-AI/metalift?

It is published by MetaLift-AI. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.