Firecrawl MCP Server

{'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.'}, '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': False}}, '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'}, '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}

{'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}`.'}}, 'description': 'Parsed document content, or the upload instructions for the hosted two-call flow.', 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'proxy': {'enum': ['basic', 'stealth', 'enhanced', 'auto'], 'type': 'string'}, 'maxAge': {'type': 'number'}, 'mobile': {'type': 'boolean'}, 'formats': {'type': 'array', 'items': {'enum': ['markdown', 'html', 'rawHtml', 'screenshot', 'links', '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'}, 'saveChanges': {'type': 'boolean'}}, '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'}, 'redactPII': {'type': 'boolean'}, 'requestId': {'type': 'string', 'pattern': '^[A-Za-z0-9._:-]{1,128}$', 'description': 'Idempotency key bound to one Alexandria execution payload. Generated when omitted and returned with the result.'}, 'alexandria': {'anyOf': [{'type': 'object', 'required': ['provider', 'capability'], 'properties': {'options': {'type': 'object', 'description': 'Capability options as declared by its contract.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'version': {'type': 'string', 'maxLength': 128, 'minLength': 1, 'description': 'Optional published workflow version. Omit to use the latest version.'}, 'provider': {'type': 'string', 'minLength': 1, 'description': 'Provider slug, e.g. "fred".'}, 'capability': {'type': 'string', 'minLength': 1, 'description': 'Capability address as returned by search or discover, e.g. "series/observations".'}}}, {'type': 'array', 'items': {'type': 'object', 'required': ['provider', 'capability'], 'properties': {'options': {'type': 'object', 'description': 'Capability options as declared by its contract.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'version': {'type': 'string', 'maxLength': 128, 'minLength': 1, 'description': 'Optional published workflow version. Omit to use the latest version.'}, 'provider': {'type': 'string', 'minLength': 1, 'description': 'Provider slug, e.g. "fred".'}, 'capability': {'type': 'string', 'minLength': 1, 'description': 'Capability address as returned by search or discover, e.g. "series/observations".'}}}, 'maxItems': 10, 'minItems': 1}], 'description': 'Catalogued Alexandria capability invocation, mutually exclusive with url. One {provider, capability, options} object or an array of 1-10, with contracts available through firecrawl_search or firecrawl_find_tools. Each call may include version to pin a published workflow; omitting it uses latest. Only requestId and timeout are supported alongside alexandria. The selected contract marks required inputs and any requiresOneOf groups (at least one member per group); it may include example.request/example.response and response.key (which may differ from records). Where pagination is declared, its fields govern paging with the same filters; catalogue next is separate from provider pagination. Returns per-capability results in data.alexandria with data, records, or an error with a code; individual capabilities can fail even when the outer response succeeds. Requires an API key on a team with Alexandria enabled. Some providers require accepted terms; blocked requests return the applicable requirements.'}, 'pdfOptions': {'type': 'object', 'properties': {'maxPages': {'type': 'integer', 'maximum': 10000, 'minimum': 1}}, 'additionalProperties': False}, 'toolDetail': {'enum': ['compact', 'summary', 'full'], 'type': 'string', 'description': 'URL mode only: domain discovery detail, summary by default; compact returns provider/capability/description, full includes contracts. Ignored with alexandria.'}, 'domainTools': {'type': 'boolean', 'description': 'URL mode only: include domain-matched Alexandria tools for the page in tools on the returned document. Ignored with alexandria.'}, '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': False}}, '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}, 'zeroDataRetention': {'type': 'boolean'}, 'removeBase64Images': {'type': 'boolean'}, 'skipTlsVerification': {'type': 'boolean'}}, 'additionalProperties': False}

{'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.'}, '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.'}, '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.'}, '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.'}}, 'description': 'A scraped document, or the Alexandria execution envelope when `alexandria` was passed.', 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], '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. Catalogue browsing is available through firecrawl_find_tools.'}, '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. A search with sources: ["web"] omits semantic provider discovery; domainTools: true can still return website-matched tools. Web-only results use domainTools: false. Use ["alexandria"] alone for provider discovery without web results.'}, 'location': {'type': 'string'}, 'categories': {'type': 'array', 'items': {'enum': ['research', 'pdf', 'developer'], '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. `developer` returns hits in `data.web` with `category: "developer"`; 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. Inspect selected compact tools with firecrawl_find_tools providers and capabilities.'}, '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', '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'}, 'saveChanges': {'type': 'boolean'}}, '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': False}}, '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}, 'zeroDataRetention': {'type': 'boolean'}, 'removeBase64Images': {'type': 'boolean'}, 'skipTlsVerification': {'type': 'boolean'}}, 'description': 'Attach page content for web results in the same call. These fetches ignore maxAge, so use firecrawl_scrape when you need a live fetch. scrapeOptions fetches web pages, never Alexandria provider tools.', 'additionalProperties': False}, '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}

{'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`.'}, 'error': {'description': 'Error message or error object when the call did not succeed.'}, 'tools': {'description': 'Domain-matched Alexandria tools for the results.'}, '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.'}}, 'description': 'Ranked search results grouped by source.', 'additionalProperties': False}