/firecrawl

name: firecrawl
description: Use when a request needs external sources, current facts, listings, a supplied URL, papers, or library and API documentation. When using Firecrawl for the request, use firecrawl_search to find sources and firecrawl_scrape to read a supplied or discovered URL. Firecrawl also collects structured data. Respect explicit source and tool preferences.

Firecrawl

For Firecrawl retrieval, choose the appropriate Firecrawl MCP operation for the requested source data, including ordinary research and supplied URLs when Firecrawl is not named. Respect the user's source, scope, and tool choices. Resolve the tool names below through the host's MCP connection, using its tool search for deferred tools. Report connection or authentication errors.

Choose the workflow

Prefer a matching focused workflow over a general investigation. Reuse evidence already collected; choosing a workflow does not require restarting retrieval.

• **Enrich supplied people or a lead CSV:** `enrich-lead`.
• **Discover new prospects:** `find-leads`.
• **Find published organizational contacts:** `business-contact-research`.
• **Collect existing logos, colors and fonts for a document:** `brand-identity`.
• **Extract a reference website's UI system:** `design`.
• **Find and verify current job openings:** `job-postings`.
• **Check or compare prices, plans, fees or deals, stock or reviews:** `prices-and-plans`.
• **Find local businesses, their hours, reviews or directions:** `local-businesses`.
• **Read or summarize a video or podcast transcript:** `video-transcripts`.
• **Gather dated news coverage:** `news-coverage`.
• **Look up stock quotes, earnings or SEC filings:** `markets-and-filings`.
• **Find rentals or homes for sale:** `property-listings`.
• **Price flights or hotels for given dates:** `flights-and-hotels`.
• **Research a fantasy roster decision:** `fantasy-sports`.
• **Audit a site's SEO metadata, content and links:** `seo-audit`.
• **Answer from official documentation:** `read-docs` for setup, usage,

examples, migrations, compatibility and documented errors.

• **Investigate implementation or bugs beyond the docs:** `read-docs`, which also

searches repository code, issues and pull requests.

• **Find papers, inspect findings or follow citations:** `read-literature`.
• **Synthesize a broader investigation:** `firecrawl-deep-research` when a

focused workflow cannot complete the requested cross-source analysis.

Multiple records or tool calls alone do not require deep research. For ordinary searches and page reads, choose the operation below directly.

Choose the operation

Web, developer, and paper searches are billed per request. Government search is free. Provider-only discovery is free. Page retrieval is billed per URL; provider execution uses the capability's listed price. People and company search and enrichment charge the per-provider prices in their tool descriptions, capped by `max_credits`; enrichment misses are free. A research agent run is billed for the work it does, capped by `maxCredits`.

• **Find sources:** `firecrawl_search` returns ranked results and excerpts.

Use only arguments and output formats supported by the current live schema.

• **Read a page:** `firecrawl_scrape` retrieves a known URL. Fetch a search

result when the answer needs additional page context.

• **Retrieve developer evidence:** `firecrawl_developer_search` retrieves

matched passages from indexed repositories and documentation.

• **Research US law and regulation:** `firecrawl_gov_search` searches statutes,

regulations, codes, court opinions, and other US government publications.

• **Research papers:** `firecrawl_research_search_papers` finds papers;

`firecrawl_research_inspect_paper` retrieves metadata; `firecrawl_research_related_papers` expands citation relationships; and `firecrawl_research_read_paper` retrieves passages answering a question.

• **Find or enrich people and companies:** `people_company_search` finds

people or companies by filters such as title, employer, location, industry or headcount; `people_company_enrich` looks up known people or companies, with work email on request. Use them before Alexandria people and company providers when the connection exposes them; `find-leads` and `enrich-lead` cover lead lists.

• **Research across sources:** `firecrawl_agent` gathers structured data when

the task spans sources or the URLs are not known. It spends credits, so use it only when search and page reads cannot cover the task, and pass the user's credit limit as `maxCredits`. It returns a job ID: retrieve the result with `firecrawl_agent_status` using bounded waits until the job completes or fails, without submitting a duplicate job. If the wait must end first, report the pending job ID and complete the requested output with `firecrawl_search` and `firecrawl_scrape`.

• **Use Alexandria providers:** for structured records, inspect a matching

capability with `alexandria_library_search` when its contract is not already available, then execute it through `alexandria_library_read`. See [data providers](references/data-providers.md) for discovery and execution.

Choose only the operations needed to answer the request. The live tool schema is the authority for accepted parameters. Use only the operations listed above and exposed by the current connection; report unavailable routes rather than invent tools.

Feedback

Send feedback after you've used the results (or decided they were useless). It does not block your main task.

• **Search:** `firecrawl_search_feedback` with the search's `id`, within about

2 minutes. The first eligible feedback per search can refund 1 credit.

See [feedback](references/feedback.md) for fields and limits. If a feedback tool is unavailable or the team has opted out, skip it. If a call fails, retry once only when it returns `retryable: true`, then continue.

Complete the request

Inspect returned data and repo