Back to Browse

Metalift MCP Server

Developer ToolsUse Caution4.8MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

4.8
Use Caution4.8High Risk

This is a well-structured MCP server for the Metalift web scraping API with appropriate authentication, proper credential handling, and reasonable permissions. The codebase demonstrates good security practices: API keys are environment-variable-based, no hardcoded secrets exist, and the server uses standard MCP patterns. Minor code quality observations around error handling and logging do not constitute security vulnerabilities. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.

6 files analyzed · 8 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

What You'll Need

Set these up before or after installing:

Metalift scrape API base URLOptional

Environment variable: METALIFT_API_URL

API key from https://app.metalift.ai/dashboard/keysRequired

Environment variable: METALIFT_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-metalift-ai-metalift": {
      "env": {
        "METALIFT_API_KEY": "your-metalift-api-key-here",
        "METALIFT_API_URL": "your-metalift-api-url-here"
      },
      "args": [
        "-y",
        "@metalift/mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

@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

Reviews

No reviews yet

Be the first to review this server!