Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

io.github.MetaLift-AI/metalift

NPM · @METALIFT/MCP · SCANNED AUG 3

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

Available components

+44 this week 62 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87
  • No malware found by supply-chain analysis.Pass
  • Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.Partial
  • No install/post-install scripts declared.Pass
  • Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency6
Schema Quality & AI Usability79
  • 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
  • AI-judged instruction clarity (good).Pass
  • Context-footprint check failed: tool/resource definitions use about 1613 tokens (~115/item across 14 items; 11 tools + 3 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
  • Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage97
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 91% of tool parameters carry a description.Partial
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @metalift/mcp

# add to Claude Code
claude mcp add metalift-ai-metalift -- npx -y @metalift/mcp
# add to Codex CLI
codex mcp add metalift-ai-metalift -- npx -y @metalift/mcp
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "metalift-ai-metalift": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@metalift/mcp"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add metalift-ai-metalift --command npx --arg -y --arg @metalift/mcp
# ~/.hermes/config.yaml
mcp_servers:
  metalift-ai-metalift:
    command: "npx"
    args: ["-y", "@metalift/mcp"]
// mcp.json
{
  "mcpServers": {
    "metalift-ai-metalift": {
      "command": "npx",
      "args": [
        "-y",
        "@metalift/mcp"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 3 Aug 26 +4
    • Stability: unverified → 0.27 functional
  • 2 Aug 26 +38
    • Provenance: unverified → fail security
    • Known CVEs: unverified → partial security
    • Install scripts: unverified → pass security
    • Malware scan: unverified → pass security
    • Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
    • License: unverified → fail functional
    • Schema quality: 100 → unverified functional
    • Tool coverage: 100 → unverified functional
    • Schema quality: unverified → good functional
    • MCP protocol: unverified → pass functional
    • Maintenance: unverified → pass functional
    • Dependency health: unverified → partial functional
    • Licence: SEE LICENSE IN LICENSE functional
  • 1 Aug 26 +20
    • Tool coverage: unverified → 100 functional
    • Schema quality: unverified → 100 functional
    • First check of Schema quality: unverified functional
    • First check of Tool coverage: 91 functional
    • First check of Schema quality: fail functional
    • First check of Schema quality: fail functional
  • 31 Jul 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 30 Jul 26 −18
    • Malware scan: pass → unverified security
  • 28 Jul 26 0
    • Security disclosure: unverified → fail functional
  • 27 Jul 26 18

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/@metalift/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 95 packages

95 packages in the resolved dependency tree · 95 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 11 exposed · ~1,361 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
metalift_batch_scrape ~146

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.

NameTypeReqDescription
asyncbooleanRun as background job (returns job id)
scrape_optionsobjectShared scrape options applied to every URL in the batch
urlsarrayyesURLs to scrape in parallel
waitbooleanWhen async=true, wait for completion with progress updates (default true).

No output schema declared.

No examples provided.

metalift_crawl ~131

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.

NameTypeReqDescription
exclude_pathsarraySkip paths matching these prefixes
include_pathsarrayOnly crawl paths matching these prefixes
limitnumberMaximum pages to crawl
max_depthnumberMaximum link depth from seed URL
urlstringyesSeed URL to start crawling from
waitbooleanWait for crawl to finish with progress updates (default true).

No output schema declared.

No examples provided.

metalift_job_status ~52

Poll async crawl or batch job status and results. Returns human-readable progress (pages completed, credits charged).

NameTypeReqDescription
job_idstringyesJob id from metalift_crawl or metalift_batch_scrape

No output schema declared.

No examples provided.

metalift_list_sessions ~23

List org-scoped browser sessions stored via metalift_seed_session.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

metalift_list_strategies ~29

List scrape strategies with protection levels and credit estimates. Use before scraping unknown protected sites.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

metalift_map ~77

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.

NameTypeReqDescription
limitnumberMaximum URLs to return
searchstringOptional substring filter for URLs
urlstringyesPage URL to extract links from

No output schema declared.

No examples provided.

metalift_scrape ~400

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.

NameTypeReqDescription
cookie_headerstringRaw Cookie header from DevTools. Routes through Playwright + sticky proxy to preserve browser TLS fingerprint. Prefer metalift_seed_session with storage_state for repeat scrapes.
cookiesobjectSession cookies (name→value). Routes through Playwright browser session + proxy — not static HTTP. Prefer metalift_seed_session for reuse.
formatsarrayOutput formats; default markdown only
headersobjectExtra request headers. Pass User-Agent from the user's browser when using cookie_header so the session fingerprint matches.
only_main_contentbooleanExtract main article content only (default true)
proxystringProxy tier; default direct for static pages
renderstringRender mode; default static for plain URLs
response_detailstringResponse depth: compact (default, ~16k chars, no links), standard (full markdown + capped links), full (complete JSON).
screenshotbooleanCapture page screenshot (adds cost)
strategystringScrape strategy: auto, article, spa, cloudflare, authenticated, listing, retail, jsonld, download, raw, or comma-separated chain. Use download for full static HTML. See /v1/strategies for protection…
timeout_msnumberPer-attempt timeout in milliseconds
urlstringyesPage URL to scrape
wait_forstringCSS selector to wait for before scraping

No output schema declared.

No examples provided.

metalift_seed_session ~151

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.

NameTypeReqDescription
cookie_headerstring
cookiesobject
domainstringyesSite hostname, e.g. actionpowertest.com or www.walmart.com
storage_stateobjectPlaywright context.storageState() JSON — preferred over cookie_header alone
ttl_hoursnumber
user_agentstringUser-Agent from the same browser session that issued the cookies

No output schema declared.

No examples provided.

metalift_sitemap ~128

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.

NameTypeReqDescription
limitnumber
same_originbooleanOnly return URLs on the same origin (default true)
searchstringOptional substring filter; matching URLs sort first
urlstringyesSite homepage or direct sitemap.xml URL

No output schema declared.

No examples provided.

metalift_warm_session ~117

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.

NameTypeReqDescription
domainstringOverride domain for stored session
proxystringDefault auto. Use residential for WAF-heavy sites.
strategystringe.g. retail, cloudflare, authenticated
timeout_msnumberBrowser warmup timeout in milliseconds
urlstringyesSeed URL to visit in browser

No output schema declared.

No examples provided.

metalift_web_search ~107

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.

NameTypeReqDescription
categoriesarrayOptional search categories
languagestringResult language (default en)
querystringyesSearch query

No output schema declared.

No examples provided.