Firecrawl MCP Server is an MCP server published by io.github.firecrawl, hosted at mcp.firecrawl.dev. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 3 tools, including firecrawl_scrape, firecrawl_search, firecrawl_parse.
Firecrawl, the context API for AI agents: search, scrape, interact with the web, plus paper search.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Scrape one URL and return its content: markdown by default, or HTML, links, screenshots, branding data, or a targeted answer. Use it when the request identifies a page and needs its content or defined fields: the user gives a URL or names a page or PDF and wants it read or summarized, or wants prices, specs, contact details or a table from it. Use `firecrawl_search` when additional web sources are needed; on an authenticated session, `firecrawl_map` lists a site's URLs and `firecrawl_crawl` collects a set of pages. `url` may omit the scheme (`example.com/page`); it is read as https. Firecrawl may serve recently indexed content; set `maxAge: 0` for a live fetch or a smaller `maxAge` to bound staleness. A successful response does not by itself confirm the page is still current. A named browser profile loads saved session data without saving changes to it. Authenticated responses can include a `metadata.scrapeId` for optional scrape feedback. On an authenticated session, `firecrawl_search` and `alexandria_library_search` can discover Alexandria providers for the same fields across several pages; a matching provider returns typed records in one `alexandria_library_read` call.
| Parameter | Type | Description |
|---|---|---|
| url * | string | |
| proxy | string | one of ["basic","stealth","enhanced","auto"] |
| maxAge | number | |
| mobile | boolean | |
| formats | array | |
| parsers | array | |
| profile | object | Loads a saved browser profile without saving changes to it. |
| timeout | integer | Execution timeout in milliseconds. |
| waitFor | number | |
| location | object | |
| lockdown | boolean | |
| objective * | string | The user's underlying goal in one sentence, not a restatement of this call's arguments. Reuse it across related calls. Firecrawl uses it to learn what agents need and improve its results. No personal data, secrets or the user's exact words. |
| redactPII | boolean | |
| pdfOptions | object | |
| toolDetail | string | Domain discovery detail, summary by default; compact returns provider/capability/description, full includes contracts. |
| domainTools | boolean | Include domain-matched Alexandria tools for the page in tools on the returned document. |
| excludeTags | array | |
| includeTags | array | |
| queryOptions | object | |
| storeInCache | boolean | |
| conversationId | string | conversationId from any earlier Firecrawl tool result in this conversation; after parallel calls, any one of theirs. Omit only on the first call of a conversation; the result returns one to pass on every later call. |
| onlyMainContent | boolean | |
| screenshotOptions | object | |
| zeroDataRetention | boolean | |
| removeBase64Images | boolean | |
| skipTlsVerification | boolean |
{
"name": "firecrawl_scrape",
"title": "Firecrawl scrape",
"description": "Scrape one URL and return its content: markdown by default, or HTML, links, screenshots, branding data, or a targeted answer. Use it when the request identifies a page and needs its content or defined fields: the user gives a URL or names a page or PDF and wants it read or summarized, or wants prices, specs, contact details or a table from it. Use `firecrawl_search` when additional web sources are needed; on an authenticated session, `firecrawl_map` lists a site's URLs and `firecrawl_crawl` collects a set of pages. `url` may omit the scheme (`example.com/page`); it is read as https.\n\nFirecrawl may serve recently indexed content; set `maxAge: 0` for a live fetch or a smaller `maxAge` to bound staleness. A successful response does not by itself confirm the page is still current. A named browser profile loads saved session data without saving changes to it. Authenticated responses can include a `metadata.scrapeId` for optional scrape feedback.\n\nOn an authenticated session, `firecrawl_search` and `alexandria_library_search` can discover Alexandria providers for the same fields across several pages; a matching provider returns typed records in one `alexandria_library_read` call.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url",
"objective"
],
"properties": {
"url": {
"type": "string"
},
"proxy": {
"enum": [
"basic",
"stealth",
"enhanced",
"auto"
],
"type": "string"
},
"maxAge": {
"type": "number"
},
"mobile": {
"type": "boolean"
},
"formats": {
"type": "array",
"items": {
"enum": [
"markdown",
"html",
"rawHtml",
"screenshot",
"links",
"images",
"summary",
"changeTracking",
"branding",
"query",
"audio"
],
"type": "string"
}
},
"parsers": {
"type": "array",
"items": {
"enum": [
"pdf"
],
"type": "string"
}
},
"profile": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
}
},
"description": "Loads a saved browser profile without saving changes to it.",
"additionalProperties": false
},
"timeout": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Execution timeout in milliseconds.",
"exclusiveMinimum": 0
},
"waitFor": {
"type": "number"
},
"location": {
"type": "object",
"properties": {
"country": {
"type": "string"
},
"languages": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"lockdown": {
"type": "boolean"
},
"objective": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "The user's underlying goal in one sentence, not a restatement of this call's arguments. Reuse it across related calls. Firecrawl uses it to learn what agents need and improve its results. No personal data, secrets or the user's exact words."
},
"redactPII": {
"type": "boolean"
},
"pdfOptions": {
"type": "object",
"properties": {
"maxPages": {
"type": "integer",
"maximum": 10000,
"minimum": 1
}
},
"additionalProperties": false
},
"toolDetail": {
"enum": [
"compact",
"summary",
"full"
],
"type": "string",
"description": "Domain discovery detail, summary by default; compact returns provider/capability/description, full includes contracts."
},
"domainTools": {
"type": "boolean",
"description": "Include domain-matched Alexandria tools for the page in tools on the returned document."
},
"excludeTags": {
"type": "array",
"items": {
"type": "string"
}
},
"includeTags": {
"type": "array",
"items": {
"type": "string"
}
},
"queryOptions": {
"type": "object",
"required": [
"prompt"
],
"properties": {
"mode": {
"enum": [
"directQuote",
"freeform"
],
"type": "string",
"default": "freeform"
},
"prompt": {
"type": "string",
"maxLength": 10000
}
},
"additionalProperties": false
},
"storeInCache": {
"type": "boolean"
},
"conversationId": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
"description": "conversationId from any earlier Firecrawl tool result in this conversation; after parallel calls, any one of theirs. Omit only on the first call of a conversation; the result returns one to pass on every later call."
},
"onlyMainContent": {
"type": "boolean"
},
"screenshotOptions": {
"type": "object",
"properties": {
"quality": {
"type": "number"
},
"fullPage": {
"type": "boolean"
},
"viewport": {
"type": "object",
"required": [
"width",
"height"
],
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"zeroDataRetention": {
"type": "boolean"
},
"removeBase64Images": {
"type": "boolean"
},
"skipTlsVerification": {
"type": "boolean"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"data": {
"description": "Alexandria mode: per-capability results in `data.alexandria`, each with `data`, `records`, or an `error`."
},
"html": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Processed HTML of the page."
},
"json": {
"description": "Structured data matching the requested JSON schema or prompt."
},
"menu": {
"description": "Menu data extracted from the page."
},
"audio": {
"description": "Audio extracted from the page."
},
"error": {
"description": "Error message or error object when the call did not succeed."
},
"links": {
"description": "Links found on the page."
},
"pages": {
"description": "Physical PDF pages, when `parsers[].pages` is set."
},
"tools": {
"description": "Domain-matched Alexandria tools for the page, when `domainTools` is set."
},
"video": {
"description": "Video extracted from the page."
},
"answer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Targeted answer to the question that was asked of the page."
},
"blocks": {
"description": "Typed PDF layout blocks, when `parsers[].blocks` is set."
},
"images": {
"description": "Images found on the page."
},
"actions": {
"description": "Results of the browser actions that ran during the scrape."
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Guidance that accompanies the result."
},
"product": {
"description": "Product data extracted from the page."
},
"rawHtml": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Unprocessed HTML of the page."
},
"receipt": {
"description": "Billing receipt for the execution."
},
"success": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Whether the API call succeeded."
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Summary of the page content."
},
"warning": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Non-fatal warning about the result."
},
"branding": {
"description": "Branding data extracted from the page."
},
"delivery": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "`retained` when the full result stayed server-side instead of being inlined."
},
"markdown": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Page content as markdown."
},
"metadata": {
"description": "Page metadata; authenticated responses can include `metadata.scrapeId` for scrape feedback."
},
"nextTool": {
"description": "A follow-up tool call (`{name, arguments}`) that continues or inspects this result."
},
"requestId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Identifier of this Alexandria execution."
},
"retryable": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Whether resending the same request can succeed; set when the API refused before any provider ran."
},
"scrape_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Identifier of the underlying scrape."
},
"attributes": {
"description": "Values collected by the requested attribute selectors."
},
"highlights": {
"description": "Highlighted passages from the page."
},
"screenshot": {
"description": "Screenshot of the page."
},
"agent_hints": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional response guidance from the Firecrawl API."
},
"creditsCost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Credits this call consumed."
},
"workspaceId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Workspace holding a retained result, for inspection through virtual Bash."
},
"feedbackRefs": {
"description": "Retained results only: `[{provider, capability, feedbackRef}]` per call; pass a ref in `callRatings` of the feedback tool to rate that call."
},
"feedbackTool": {
"description": "Pointer to the feedback tool for reporting how this result served the task."
},
"responseBytes": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Size of the full result in bytes."
},
"changeTracking": {
"description": "Change-tracking comparison against the previous scrape."
},
"conversationId": {
"type": "string",
"description": "Pass on later Firecrawl calls in this conversation."
},
"idleTtlSeconds": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Seconds a retained workspace stays available while idle."
},
"estimatedTokens": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Estimated token cost of the full result."
},
"inlineTokenBudget": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Token budget above which a result is retained rather than inlined."
},
"tokenEstimateMethod": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "How `estimatedTokens` was derived."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Firecrawl scrape",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Use this when you need current or specific information from the web: recent events, latest releases and versions, prices, people and companies, statistics, or any fact that may have changed since your training data or that you are not sure of. Returns ranked results with query-relevant highlights; each web result is a title, URL, and description. Operators include quoted phrases, `-term`, `site:host`, `inurl:term`, `intitle:term`, and `related:host`; the set is non-exhaustive. `includeDomains` and `excludeDomains` are mutually exclusive hostname filters; categories limit result types to `research`, `pdf`, `developer`, or `gov`. For a programming question, add `categories: ["developer"]`. It searches an index of public repositories, GitHub issues, merged pull requests, repository READMEs, and code documentation, and returns the results in `data.web` with `category: "developer"`. For a legal or regulatory question, `categories: ["gov"]` returns results in `data.web` with `category: "gov"` and cannot be combined with other categories; authenticated sessions also have `firecrawl_gov_search` as the dedicated tool. Verify gov results' issuer, jurisdiction, status, and version before citing current law. Authenticated search combines web results, semantic tool summaries and domain matches. Use sources: ["alexandria"] for semantic tools only. Authenticated searches always add alexandria to the sources, so sources: ["web"] also returns providers; domainTools: false turns off website-matched tools only. On an authenticated session, tool matches describe available structured-data capabilities, not executed data. toolDetail: "compact" (default) returns only provider, capability and description; "summary" adds metadata; "full" includes their input and output contracts. alexandria_library_read runs a selected capability; alexandria_library_search explores the whole library and reads full contracts. Returns result groups in `data` and an operation `id`.
| Parameter | Type | Description |
|---|---|---|
| tbs | string | |
| limit | integer | |
| query * | string |
Parse one supported document into markdown, HTML, links, summary, targeted answers, or JSON matching a schema. Supported inputs include common HTML, PDF, Word, RTF, OpenDocument, and spreadsheet files; PDF parsing can be bounded with `pdfOptions.maxPages`. Local MCP reads `filePath` from the server filesystem. Hosted MCP uses two calls: first provide `filePath` to receive upload instructions, upload locally, then call again with the returned `uploadRef`; do not send both fields together. Remote web URLs belong in `firecrawl_scrape`. Set `redactPII` to request redaction of personally identifiable information in the returned content. `zeroDataRetention` requires an eligible authenticated account; omit it for anonymous keyless use. Returns upload instructions for hosted phase one or parsed document content for the final call. Authenticated final responses can include a `data.metadata.scrapeId` for optional parse feedback.
| Parameter | Type | Description |
|---|---|---|
| proxy | string | one of ["basic","auto"] |
| maxAge | number | Ignored: parse never reuses or stores indexed content. |
| formats | array | |
| parsers | array | |
| filePath | string | Phase 1 only: path to the local file on the caller/harness machine. Hosted MCP will not read or stat this path; it is used only to produce upload instructions. |
| objective | string | The user's underlying goal in one sentence, not a restatement of this call's arguments. Reuse it across related calls. Firecrawl uses it to learn what agents need and improve its results. No personal data, secrets or the user's exact words. |
If Firecrawl reports that credits ran out or the daily limit without an account was reached, end your final answer with the line it provides, link included. Hosted keyless sessions expose firecrawl_search, firecrawl_scrape, and firecrawl_parse with usage limits. Alexandria provider calls require a Firecrawl API key and are not included in the hosted keyless tier. firecrawl_search searches the web. For programming questions, firecrawl_search with categories: ["developer"] searches indexed public repositories, GitHub issues, merged pull requests, repository READMEs, and code documentation. For legal or regulatory questions, firecrawl_search with categories: ["gov"] searches US government legal and regulatory sources and cannot be combined with other categories. For biomedical, life-science, clinical, or arXiv literature, firecrawl_search with categories: ["research"] filters ordinary web results to research-affiliated websites. firecrawl_scrape retrieves one supplied page. firecrawl_parse processes supported local files through its two-phase upload flow. An Authorization bearer API key can provide higher usage limits and expose additional tools, subject to plan, deployment, and team policy, including firecrawl_map for site URL discovery, firecrawl_agent and firecrawl_agent_status for multi-source research that returns structured data when the URLs are not known, firecrawl_research_* for papers and proteins, firecrawl_developer_search for Developer Index searches of public repositories, GitHub issues, merged pull requests, repository READMEs, and code documentation, and alexandria_library_search and alexandria_library_read for exploring and running catalogued Alexandria data providers, alongside the Alexandria results of firecrawl_search. A search that names one person, one company, one US-listed stock and asks for its news, one company's open jobs or one research paper by its arXiv id or DOI may include one Alexandria provider's record in `answer`, billed at your team's price, normally only when a record is found (stock lookups add 2 credits only when they find a record). Successful results from Firecrawl's search, find-tools, Alexandria library, scrape, map, crawl, agent, interact, parse and feedback tools include a conversationId. Pass it on every later call to those tools in the same conversation, including after parallel calls (from any one result); omit it only to start a new conversation.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| Query for web and semantic tool discovery. Operators include quoted phrases, `-term`, `site:host`, `inurl:term`, `intitle:term`, and `related:host`; the set is non-exhaustive. Browse the whole library with alexandria_library_search. |
| filter | string |
| sources | array | Search sources; authenticated sessions default to web + alexandria, keyless sessions to web only. Authenticated searches always add alexandria to the sources, so sources: ["web"] also returns providers; domainTools: false turns off website-matched tools only. enterprise zdr or anon searches do not a… |
| location | string |
| objective * | string | The user's underlying goal in one sentence, not a restatement of this call's arguments. Reuse it across related calls. Firecrawl uses it to learn what agents need and improve its results. No personal data, secrets or the user's exact words. |
| categories | array | Limit results to specific source types. `research` restricts ordinary web results to research-affiliated websites and returns page snippets, which is separate from the `firecrawl_research_*` tools that search paper abstracts and full text across biomedical (PubMed, bioRxiv, medRxiv) and arXiv litera… |
| enterprise | array |
| highlights | boolean | Return query-relevant page excerpts for web and news results when available (default). Highlights appear in web `description` and news `snippet`; otherwise, original snippets are returned. Set to false to keep the original search snippets. |
| toolDetail | string | Compact by default. Compact returns only provider, capability and description; full includes contracts. Read a selected tool's contract with alexandria_library_search. |
| domainTools | boolean | Include domain-matched tools for result URLs. Defaults to true when Alexandria is combined with web, news or images; semantic-only search leaves domain matching off. |
| scrapeOptions | object | Fetches the full page of every web result in the same call, and each fetched result is billed as a scrape. Leave it unset unless the task needs the full text of a few results: highlights usually answer, and firecrawl_scrape can fetch only the URLs you need. These fetches ignore maxAge, so use firecr… |
| conversationId | string | conversationId from any earlier Firecrawl tool result in this conversation; after parallel calls, any one of theirs. Omit only on the first call of a conversation; the result returns one to pass on every later call. |
| excludeDomains | array | Hostnames to leave out of results. Mutually exclusive with includeDomains. |
| includeDomains | array | Hostnames to restrict results to. Mutually exclusive with excludeDomains. |
{
"name": "firecrawl_search",
"title": "Firecrawl web search",
"description": "Use this when you need current or specific information from the web: recent events, latest releases and versions, prices, people and companies, statistics, or any fact that may have changed since your training data or that you are not sure of. Returns ranked results with query-relevant highlights; each web result is a title, URL, and description. Operators include quoted phrases, `-term`, `site:host`, `inurl:term`, `intitle:term`, and `related:host`; the set is non-exhaustive. `includeDomains` and `excludeDomains` are mutually exclusive hostname filters; categories limit result types to `research`, `pdf`, `developer`, or `gov`.\n\nFor a programming question, add `categories: [\"developer\"]`. It searches an index of public repositories, GitHub issues, merged pull requests, repository READMEs, and code documentation, and returns the results in `data.web` with `category: \"developer\"`.\n\nFor a legal or regulatory question, `categories: [\"gov\"]` returns results in `data.web` with `category: \"gov\"` and cannot be combined with other categories; authenticated sessions also have `firecrawl_gov_search` as the dedicated tool. Verify gov results' issuer, jurisdiction, status, and version before citing current law.\n\nAuthenticated search combines web results, semantic tool summaries and domain matches. Use sources: [\"alexandria\"] for semantic tools only. Authenticated searches always add alexandria to the sources, so sources: [\"web\"] also returns providers; domainTools: false turns off website-matched tools only. On an authenticated session, tool matches describe available structured-data capabilities, not executed data. toolDetail: \"compact\" (default) returns only provider, capability and description; \"summary\" adds metadata; \"full\" includes their input and output contracts. alexandria_library_read runs a selected capability; alexandria_library_search explores the whole library and reads full contracts.\n\nReturns result groups in `data` and an operation `id`.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query",
"objective"
],
"properties": {
"tbs": {
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"query": {
"type": "string",
"minLength": 1,
"description": "Query for web and semantic tool discovery. Operators include quoted phrases, `-term`, `site:host`, `inurl:term`, `intitle:term`, and `related:host`; the set is non-exhaustive. Browse the whole library with alexandria_library_search."
},
"filter": {
"type": "string"
},
"sources": {
"type": "array",
"items": {
"anyOf": [
{
"enum": [
"web",
"images",
"news",
"alexandria",
"exchange"
],
"type": "string"
},
{
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"enum": [
"web",
"images",
"news",
"alexandria",
"exchange"
],
"type": "string"
}
},
"additionalProperties": false
}
]
},
"description": "Search sources; authenticated sessions default to web + alexandria, keyless sessions to web only. Authenticated searches always add alexandria to the sources, so sources: [\"web\"] also returns providers; domainTools: false turns off website-matched tools only. enterprise zdr or anon searches do not add it. Use [\"alexandria\"] alone for provider discovery without web results."
},
"location": {
"type": "string"
},
"objective": {
"type": "string",
"maxLength": 5000,
"minLength": 1,
"description": "The user's underlying goal in one sentence, not a restatement of this call's arguments. Reuse it across related calls. Firecrawl uses it to learn what agents need and improve its results. No personal data, secrets or the user's exact words."
},
"categories": {
"type": "array",
"items": {
"enum": [
"research",
"pdf",
"developer",
"gov"
],
"type": "string"
},
"description": "Limit results to specific source types. `research` restricts ordinary web results to research-affiliated websites and returns page snippets, which is separate from the `firecrawl_research_*` tools that search paper abstracts and full text across biomedical (PubMed, bioRxiv, medRxiv) and arXiv literature; `pdf` searches PDF results; `developer` searches an index built for coding agents over public repositories, GitHub issues, merged pull requests, repository READMEs, and code documentation; `gov` searches the Government Index of US federal, state, and local legal and regulatory sources, the index behind firecrawl_gov_search, and cannot be combined with other categories; gov hits can include historical versions, bill text, agency guidance, and third-party reproductions, so verify the issuer, jurisdiction, enacted/effective status, and version before citing current governing law, clarify a missing jurisdiction or ambiguous as-of date, and use general search for non-US questions or missing coverage (no hits does not establish that no applicable law exists). `developer` and `gov` return hits in `data.web` with `category` set to their name; the other categories also filter `data.web`."
},
"enterprise": {
"type": "array",
"items": {
"enum": [
"default",
"anon",
"zdr"
],
"type": "string"
}
},
"highlights": {
"type": "boolean",
"description": "Return query-relevant page excerpts for web and news results when available (default). Highlights appear in web `description` and news `snippet`; otherwise, original snippets are returned. Set to false to keep the original search snippets."
},
"toolDetail": {
"enum": [
"compact",
"summary",
"full"
],
"type": "string",
"description": "Compact by default. Compact returns only provider, capability and description; full includes contracts. Read a selected tool's contract with alexandria_library_search."
},
"domainTools": {
"type": "boolean",
"description": "Include domain-matched tools for result URLs. Defaults to true when Alexandria is combined with web, news or images; semantic-only search leaves domain matching off."
},
"scrapeOptions": {
"type": "object",
"properties": {
"proxy": {
"enum": [
"basic",
"stealth",
"enhanced",
"auto"
],
"type": "string"
},
"maxAge": {
"type": "number"
},
"mobile": {
"type": "boolean"
},
"formats": {
"type": "array",
"items": {
"enum": [
"markdown",
"html",
"rawHtml",
"screenshot",
"links",
"images",
"summary",
"changeTracking",
"branding",
"json",
"query",
"audio"
],
"type": "string"
}
},
"parsers": {
"type": "array",
"items": {
"enum": [
"pdf"
],
"type": "string"
}
},
"profile": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
}
},
"description": "Loads a saved browser profile without saving changes to it.",
"additionalProperties": false
},
"waitFor": {
"type": "number"
},
"location": {
"type": "object",
"properties": {
"country": {
"type": "string"
},
"languages": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"lockdown": {
"type": "boolean"
},
"redactPII": {
"type": "boolean"
},
"pdfOptions": {
"type": "object",
"properties": {
"maxPages": {
"type": "integer",
"maximum": 10000,
"minimum": 1
}
},
"additionalProperties": false
},
"excludeTags": {
"type": "array",
"items": {
"type": "string"
}
},
"includeTags": {
"type": "array",
"items": {
"type": "string"
}
},
"jsonOptions": {
"type": "object",
"properties": {
"prompt": {
"type": "string"
},
"schema": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": true
}
},
"additionalProperties": false
},
"queryOptions": {
"type": "object",
"required": [
"prompt"
],
"properties": {
"mode": {
"enum": [
"directQuote",
"freeform"
],
"type": "string",
"default": "freeform"
},
"prompt": {
"type": "string",
"maxLength": 10000
}
},
"additionalProperties": false
},
"storeInCache": {
"type": "boolean"
},
"onlyMainContent": {
"type": "boolean"
},
"screenshotOptions": {
"type": "object",
"properties": {
"quality": {
"type": "number"
},
"fullPage": {
"type": "boolean"
},
"viewport": {
"type": "object",
"required": [
"width",
"height"
],
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"removeBase64Images": {
"type": "boolean"
},
"skipTlsVerification": {
"type": "boolean"
}
},
"description": "Fetches the full page of every web result in the same call, and each fetched result is billed as a scrape. Leave it unset unless the task needs the full text of a few results: highlights usually answer, and firecrawl_scrape can fetch only the URLs you need. These fetches ignore maxAge, so use firecrawl_scrape for a live fetch. scrapeOptions fetches web pages, never Alexandria provider tools.",
"additionalProperties": false
},
"conversationId": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
"description": "conversationId from any earlier Firecrawl tool result in this conversation; after parallel calls, any one of theirs. Omit only on the first call of a conversation; the result returns one to pass on every later call."
},
"excludeDomains": {
"type": "array",
"items": {
"type": "string",
"pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z0-9][a-z0-9-]{0,61}[a-z0-9]$",
"maxLength": 253,
"minLength": 1
},
"description": "Hostnames to leave out of results. Mutually exclusive with includeDomains."
},
"includeDomains": {
"type": "array",
"items": {
"type": "string",
"pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z0-9][a-z0-9-]{0,61}[a-z0-9]$",
"maxLength": 253,
"minLength": 1
},
"description": "Hostnames to restrict results to. Mutually exclusive with excludeDomains."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Search identifier, for optional `firecrawl_search_feedback`."
},
"data": {
"description": "Ranked results grouped by source, such as `web`, `news`, `images`, and `alexandria`. Each result carries its `source` and a 1-indexed `position` within that group; pass those pairs to `firecrawl_search_feedback`."
},
"error": {
"description": "Error message or error object when the call did not succeed."
},
"tools": {
"description": "Domain-matched Alexandria tools for the results. For people and company enrichment or search, use people_company_enrich or people_company_search when they are listed, and for job postings use jobs_search when it is listed; call a provider here directly only when the user asks for that provider."
},
"answer": {
"description": "Ultrasearch: one Alexandria provider record answering the query, separate from the web results, with its route, provider, sources, attribution and credits (search, provider, pending, max_credits, stop_reason, cap_enforced: whether the cap was enforced when the provider was called, unresolved_requests: provider requests whose charge is not known yet)."
},
"success": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Whether the API call succeeded."
},
"warning": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Non-fatal warning about the result."
},
"nextTool": {
"description": "A follow-up tool call that continues this search."
},
"agent_hints": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional response guidance from the Firecrawl API."
},
"creditsUsed": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Credits this search consumed."
},
"feedbackTool": {
"description": "Pointer to the feedback tool for this search."
},
"conversationId": {
"type": "string",
"description": "Pass on later Firecrawl calls in this conversation."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Firecrawl web search",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}| redactPII |
| boolean |
| uploadRef | string | Phase 2 only: short-lived upload reference returned by phase 1 after the local PUT upload completes. |
| pdfOptions | object |
| contentType | string | Phase 1 MIME type override. If omitted, the server infers it from the file extension without reading the file. |
| excludeTags | array |
| includeTags | array |
| jsonOptions | object |
| queryOptions | object |
| storeInCache | boolean |
| conversationId | string | conversationId from any earlier Firecrawl tool result in this conversation; after parallel calls, any one of theirs. Omit only on the first call of a conversation; the result returns one to pass on every later call. |
| onlyMainContent | boolean |
| declaredSizeBytes | integer | Optional phase 1 size declaration. Hosted MCP does not stat the file; provide this only if the caller already knows it. |
| zeroDataRetention | boolean |
| removeBase64Images | boolean |
| skipTlsVerification | boolean |
{
"name": "firecrawl_parse",
"title": "Firecrawl file parsing",
"description": "Parse one supported document into markdown, HTML, links, summary, targeted answers, or JSON matching a schema. Supported inputs include common HTML, PDF, Word, RTF, OpenDocument, and spreadsheet files; PDF parsing can be bounded with `pdfOptions.maxPages`.\n\nLocal MCP reads `filePath` from the server filesystem. Hosted MCP uses two calls: first provide `filePath` to receive upload instructions, upload locally, then call again with the returned `uploadRef`; do not send both fields together. Remote web URLs belong in `firecrawl_scrape`.\n\nSet `redactPII` to request redaction of personally identifiable information in the returned content. `zeroDataRetention` requires an eligible authenticated account; omit it for anonymous keyless use. Returns upload instructions for hosted phase one or parsed document content for the final call. Authenticated final responses can include a `data.metadata.scrapeId` for optional parse feedback.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"proxy": {
"enum": [
"basic",
"auto"
],
"type": "string"
},
"maxAge": {
"type": "number",
"description": "Ignored: parse never reuses or stores indexed content."
},
"formats": {
"type": "array",
"items": {
"enum": [
"markdown",
"html",
"rawHtml",
"links",
"summary",
"json",
"query"
],
"type": "string"
}
},
"parsers": {
"type": "array",
"items": {
"enum": [
"pdf"
],
"type": "string"
}
},
"filePath": {
"type": "string",
"minLength": 1,
"description": "Phase 1 only: path to the local file on the caller/harness machine. Hosted MCP will not read or stat this path; it is used only to produce upload instructions."
},
"objective": {
"type": "string",
"maxLength": 5000,
"minLength": 1,
"description": "The user's underlying goal in one sentence, not a restatement of this call's arguments. Reuse it across related calls. Firecrawl uses it to learn what agents need and improve its results. No personal data, secrets or the user's exact words."
},
"redactPII": {
"type": "boolean"
},
"uploadRef": {
"type": "string",
"minLength": 1,
"description": "Phase 2 only: short-lived upload reference returned by phase 1 after the local PUT upload completes."
},
"pdfOptions": {
"type": "object",
"properties": {
"maxPages": {
"type": "integer",
"maximum": 10000,
"minimum": 1
}
},
"additionalProperties": false
},
"contentType": {
"type": "string",
"description": "Phase 1 MIME type override. If omitted, the server infers it from the file extension without reading the file."
},
"excludeTags": {
"type": "array",
"items": {
"type": "string"
}
},
"includeTags": {
"type": "array",
"items": {
"type": "string"
}
},
"jsonOptions": {
"type": "object",
"properties": {
"prompt": {
"type": "string"
},
"schema": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": true
}
},
"additionalProperties": false
},
"queryOptions": {
"type": "object",
"required": [
"prompt"
],
"properties": {
"mode": {
"enum": [
"directQuote",
"freeform"
],
"type": "string",
"default": "freeform"
},
"prompt": {
"type": "string",
"maxLength": 10000
}
},
"additionalProperties": false
},
"storeInCache": {
"type": "boolean"
},
"conversationId": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
"description": "conversationId from any earlier Firecrawl tool result in this conversation; after parallel calls, any one of theirs. Omit only on the first call of a conversation; the result returns one to pass on every later call."
},
"onlyMainContent": {
"type": "boolean"
},
"declaredSizeBytes": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Optional phase 1 size declaration. Hosted MCP does not stat the file; provide this only if the caller already knows it.",
"exclusiveMinimum": 0
},
"zeroDataRetention": {
"type": "boolean"
},
"removeBase64Images": {
"type": "boolean"
},
"skipTlsVerification": {
"type": "boolean"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"raw": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Response body when it was not JSON."
},
"data": {
"description": "Parsed document content; can include `data.metadata.scrapeId` for parse feedback."
},
"mode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Which phase of the hosted flow produced this response."
},
"error": {
"description": "Error message or error object when the call did not succeed."
},
"notes": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Hosted phase one: constraints on completing the upload flow."
},
"upload": {
"type": "object",
"properties": {
"fields": {
"description": "Form fields the upload request must send, for a POST upload."
},
"method": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "HTTP method for the upload."
},
"command": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Local command that performs the upload. It carries no Firecrawl API key."
},
"headers": {
"description": "Headers the upload request must send."
},
"expiresAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "When the upload URL expires."
},
"uploadRef": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Reference to pass back on the second call."
},
"uploadUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "URL to upload the local file to."
},
"maxSizeBytes": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Largest file the upload URL accepts."
}
},
"description": "Hosted phase one: how to upload the local file.",
"additionalProperties": false
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Guidance for the next call."
},
"success": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Whether the API call succeeded."
},
"warning": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Non-fatal warning about the result."
},
"agent_hints": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional response guidance from the Firecrawl API."
},
"nextToolCall": {
"description": "Hosted phase one: the second `firecrawl_parse` call to make once the upload succeeds, as `{name, arguments}`."
},
"conversationId": {
"type": "string",
"description": "Pass on later Firecrawl calls in this conversation."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Firecrawl file parsing",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}