When to Use

Use this tool when you need to map a website to discover all indexed urls on the site.

best for: discovering urls on a website before deciding what to scrape; finding specific sections or pages within a large site; locating the correct page when scrape returns empty or incomplete results. not recommended for: when you already know which specific url you need (use scrape); when you need the content of the pages (use scrape after mapping). common mistakes: using crawl to discover urls instead of map; jumping straight to firecrawl_agent when scrape fails instead of using map first to find the right page.

important - use map before agent: if firecrawl_scrape returns empty, minimal, or irrelevant content, use firecrawl_map with the search parameter to find the specific page url containing your target content. this is faster and cheaper than using firecrawl_agent. only use the agent as a last resort after map+scrape fails.

prompt example: "find the webhook documentation page on this api docs site." usage example (discover all urls):

{
  "name": "firecrawl_map",
  "arguments": {
    "url": "https://example.com"
  }
}

usage example (search for specific content - recommended when scrape fails):

{
  "name": "firecrawl_map",
  "arguments": {
    "url": "https://docs.example.com/api",
    "search": "webhook events"
  }
}

returns: array of urls found on the site, filtered by search query if provided. . This is part of the Firecrawl provider on xpay✦.

MCP Connection

Connect to xpay✦ to access this tool (and 10+ others):

{
  "mcpServers": {
    "xpay": {
      "url": "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
    }
  }
}

For Claude Code:

claude mcp add --transport http xpay "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"

How to Execute

Use the xpay✦ meta-tools to run this tool:

1. xpay_details — Get full input schema: xpay_details("firecrawl/firecrawl_map")
2. xpay_run — Execute: xpay_run("firecrawl/firecrawl_map", { ...inputs })

Input Parameters

Pricing

• Cost: $0.02/call
• Balance check: Use xpay_balance to check remaining credits
• Get your API key at xpay.tools — $5 free credits included

Related Skills

• Firecrawl (all tools) — 11 tools
• Firecrawl Scrape — $0.03/call
• Firecrawl Search — $0.03/call
• Firecrawl Crawl — $0.05/call
• Firecrawl Check Crawl Status — $0.03/call
• Firecrawl Extract — $0.05/call

Links

• Tool page: https://xpay.tools/firecrawl/firecrawl-map/
• Provider: https://xpay.tools/firecrawl/
• All tools: https://xpay.tools/explore