Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Firecrawl MCP connector

Bearer Token AIDeveloper ToolsSearch

Connect to Firecrawl MCP. Scrape, crawl, search, extract structured data, and monitor websites using Firecrawl's AI-powered web scraping API.

Firecrawl MCP connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “Set your credentials”

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Set up the connector

    Section titled “Set up the connector”

    Register your Firecrawl MCP credentials with Scalekit so it can authenticate requests on your behalf. You do this once per environment.

    Dashboard setup steps

    Register your Firecrawl API key with Scalekit so it can authenticate and proxy scraping requests on behalf of your users. Firecrawl MCP uses API key authentication — there is no redirect URI or OAuth flow.

    1. Get a Firecrawl API key

      • Go to firecrawl.dev and sign in or create a free account.
      • Your API key is shown on the Overview page under API Key. Copy it — it starts with fc-.

    2. Create a connection in Scalekit

      • In the Scalekit dashboard, go to AgentKit → Connections → Create Connection.
      • Search for Firecrawl MCP and click Create.
      • Note the Connection name — use this as connection_name in your code (e.g., firecrawlmcp).

    3. Add a connected account

      Connected accounts link a specific user identifier in your system to a Firecrawl API key. Add them via the dashboard for testing, or via the Scalekit API in production.

      Via dashboard (for testing)

      • Open the connection and click the Connected Accounts tab → Add account.
      • Fill in Your User’s ID and API Key, then click Save.

      Via API (for production)

      await scalekit.actions.upsertConnectedAccount({
        connectionName: 'firecrawlmcp',
        identifier: 'user_123',
        credentials: { token: 'fc-...' },
      });

  4. Make your first call

    Section titled “Make your first call”
    quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENV_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'firecrawlmcp'
    const identifier = 'user_123'
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'firecrawlmcp_firecrawl_browser_list',
      toolInput: {},
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • Search firecrawl — Send structured feedback on a previous search result to help improve future results
  • Scrape firecrawl — Scrape a single URL and return its content in one or more formats (markdown, JSON, screenshot, etc.)
  • Update firecrawl monitor — Update monitor settings such as name, status, schedule, or scrape options
  • Run firecrawl monitor — Trigger an immediate check for a monitor outside its normal schedule
  • List firecrawl monitor, firecrawl browser — List all monitors configured for the authenticated account, with pagination
  • Get firecrawl monitor — Retrieve the configuration and status of a single monitor by its ID

Common workflows

Section titled “Common workflows”

Scrape a page

Use firecrawlmcp_firecrawl_scrape to extract clean markdown content from any URL.

const result = await actions.executeTool({
  connectionName: 'firecrawlmcp',
  identifier: 'user_123',
  toolName: 'firecrawlmcp_firecrawl_scrape',
  toolInput: {
    url: 'https://docs.example.com/getting-started',
    onlyMainContent: true,
  },
});
console.log(result.data);

Search the web

Use firecrawlmcp_firecrawl_search to run a live web search and get scraped content from the top results.

const result = await actions.executeTool({
  connectionName: 'firecrawlmcp',
  identifier: 'user_123',
  toolName: 'firecrawlmcp_firecrawl_search',
  toolInput: {
    query: 'best practices for API rate limiting 2026',
    limit: 5,
  },
});
console.log(result.data);

Extract structured data from a URL

Use firecrawlmcp_firecrawl_extract with a natural-language prompt and optional JSON Schema to pull structured data from one or more pages.

const result = await actions.executeTool({
  connectionName: 'firecrawlmcp',
  identifier: 'user_123',
  toolName: 'firecrawlmcp_firecrawl_extract',
  toolInput: {
    urls: ['https://example.com/pricing'],
    prompt: 'Extract all pricing plan names and their monthly costs.',
  },
});
console.log(result.data);

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

firecrawlmcp_firecrawl_agent # Start an autonomous AI research agent that browses the web to answer a prompt. Returns a job ID; poll with firecrawlmcp_firecrawl_agent_status for results. 3 params

Start an autonomous AI research agent that browses the web to answer a prompt. Returns a job ID; poll with firecrawlmcp_firecrawl_agent_status for results.

Name Type Required Description
prompt string required Natural-language instruction to guide extraction or crawling.
schema object optional JSON Schema defining the structure of data to extract.
urls array optional List of URLs to extract structured data from.
firecrawlmcp_firecrawl_agent_status # Retrieve the status and results of a running AI research agent job by its ID. 1 param

Retrieve the status and results of a running AI research agent job by its ID.

Name Type Required Description
id string required The unique identifier of the resource.
firecrawlmcp_firecrawl_browser_create # Create a persistent browser session for interactive scraping. 4 params

Create a persistent browser session for interactive scraping.

Name Type Required Description
activityTtl number optional Seconds of inactivity after which the session is automatically destroyed.
profile object optional Named browser profile to use for authenticated scraping.
streamWebView boolean optional Set to true to stream the browser viewport during the session.
ttl number optional Session lifetime in seconds after creation.
firecrawlmcp_firecrawl_browser_delete # Destroy a browser session and release its resources. 1 param

Destroy a browser session and release its resources.

Name Type Required Description
sessionId string required The ID of the browser session. Get it from firecrawlmcp_firecrawl_browser_create.
firecrawlmcp_firecrawl_browser_list # List active or destroyed browser sessions for the account. 1 param

List active or destroyed browser sessions for the account.

Name Type Required Description
status string optional Filter browser sessions by status. Accepted values: active, destroyed.
firecrawlmcp_firecrawl_check_crawl_status # Check the progress and results of an in-progress crawl job by its ID. 1 param

Check the progress and results of an in-progress crawl job by its ID.

Name Type Required Description
id string required The unique identifier of the resource.
firecrawlmcp_firecrawl_crawl # Start a crawl job that extracts content from all pages of a website. Returns a job ID; use firecrawlmcp_firecrawl_check_crawl_status to poll for results. 15 params

Start a crawl job that extracts content from all pages of a website. Returns a job ID; use firecrawlmcp_firecrawl_check_crawl_status to poll for results.

Name Type Required Description
url string required The URL of the page or website to scrape, crawl, or map.
allowExternalLinks boolean optional Set to true to follow links to external domains.
allowSubdomains boolean optional Set to true to crawl subdomains of the target domain.
crawlEntireDomain boolean optional Set to true to crawl all paths on the domain, not just the starting URL subtree.
deduplicateSimilarURLs boolean optional Set to true to skip URLs that are similar to already-crawled URLs.
delay number optional Milliseconds to wait between requests to avoid rate limiting.
excludePaths array optional URL path patterns to exclude from the crawl (e.g. ["/admin", "/login"]).
ignoreQueryParameters boolean optional Set to true to treat URLs differing only by query string as duplicates.
includePaths array optional URL path patterns to restrict the crawl to (e.g. ["/blog/*"]).
limit number optional Maximum number of results to return.
maxConcurrency number optional Maximum number of concurrent requests during a crawl.
maxDiscoveryDepth number optional Maximum link depth to follow from the starting URL.
prompt string optional Natural-language instruction to guide extraction or crawling.
scrapeOptions object optional Scraping options applied to each page during crawl or search (formats, tags, etc.).
sitemap string optional How to use the sitemap: include to discover URLs from it, only to crawl only sitemap URLs, skip to ignore it.
firecrawlmcp_firecrawl_extract # Extract structured data from one or more URLs using a natural-language prompt and optional JSON Schema. 6 params

Extract structured data from one or more URLs using a natural-language prompt and optional JSON Schema.

Name Type Required Description
urls array required List of URLs to extract structured data from.
allowExternalLinks boolean optional Set to true to follow links to external domains.
enableWebSearch boolean optional Set to true to supplement extraction with live web search results.
includeSubdomains boolean optional Set to true to include subdomains of the target domain.
prompt string optional Natural-language instruction to guide extraction or crawling.
schema object optional JSON Schema defining the structure of data to extract.
firecrawlmcp_firecrawl_interact # Run code or a natural-language prompt in a live browser session for a previously scraped page. 5 params

Run code or a natural-language prompt in a live browser session for a previously scraped page.

Name Type Required Description
scrapeId string required The ID of the active scrape session. Get it from firecrawlmcp_firecrawl_scrape when using interact.
code string optional Code snippet to execute in the browser session.
language string optional Programming language for the code snippet to execute in the browser session.
prompt string optional Natural-language instruction to guide extraction or crawling.
timeout number optional Milliseconds to wait for the browser interaction to complete.
firecrawlmcp_firecrawl_interact_stop # End an active browser interaction session and release its resources. 1 param

End an active browser interaction session and release its resources.

Name Type Required Description
scrapeId string required The ID of the active scrape session. Get it from firecrawlmcp_firecrawl_scrape when using interact.
firecrawlmcp_firecrawl_map # Discover all indexed URLs on a website or within a URL subtree, with optional search filtering. 6 params

Discover all indexed URLs on a website or within a URL subtree, with optional search filtering.

Name Type Required Description
url string required The URL of the page or website to scrape, crawl, or map.
ignoreQueryParameters boolean optional Set to true to treat URLs differing only by query string as duplicates.
includeSubdomains boolean optional Set to true to include subdomains of the target domain.
limit number optional Maximum number of results to return.
search string optional Search term to filter URLs returned by the map.
sitemap string optional How to use the sitemap: include to discover URLs from it, only to crawl only sitemap URLs, skip to ignore it.
firecrawlmcp_firecrawl_monitor_check # Retrieve the page-level diff results for a single monitor check run. 5 params

Retrieve the page-level diff results for a single monitor check run.

Name Type Required Description
checkId string required The ID of a specific monitor check. Get it from firecrawlmcp_firecrawl_monitor_checks.
id string required The unique identifier of the resource.
limit integer optional Maximum number of results to return.
pageStatus string optional Filter check results to pages with this change status.
skip integer optional Number of items to skip for pagination.
firecrawlmcp_firecrawl_monitor_checks # List the historical check runs for a monitor, with pagination. 3 params

List the historical check runs for a monitor, with pagination.

Name Type Required Description
id string required The unique identifier of the resource.
limit integer optional Maximum number of results to return.
offset integer optional Number of items to skip for pagination.
firecrawlmcp_firecrawl_monitor_create # Create a recurring Firecrawl monitor that scrapes a URL on a schedule and diffs results against the previous run. 1 param

Create a recurring Firecrawl monitor that scrapes a URL on a schedule and diffs results against the previous run.

Name Type Required Description
body object required Monitor configuration object. Include name, url, schedule (cron), and scrapeOptions.
firecrawlmcp_firecrawl_monitor_delete # Permanently delete a monitor and stop its scheduled checks. 1 param

Permanently delete a monitor and stop its scheduled checks.

Name Type Required Description
id string required The unique identifier of the resource.
firecrawlmcp_firecrawl_monitor_get # Retrieve the configuration and status of a single monitor by its ID. 1 param

Retrieve the configuration and status of a single monitor by its ID.

Name Type Required Description
id string required The unique identifier of the resource.
firecrawlmcp_firecrawl_monitor_list # List all monitors configured for the authenticated account, with pagination. 2 params

List all monitors configured for the authenticated account, with pagination.

Name Type Required Description
limit integer optional Maximum number of results to return.
offset integer optional Number of items to skip for pagination.
firecrawlmcp_firecrawl_monitor_run # Trigger an immediate check for a monitor outside its normal schedule. 1 param

Trigger an immediate check for a monitor outside its normal schedule.

Name Type Required Description
id string required The unique identifier of the resource.
firecrawlmcp_firecrawl_monitor_update # Update monitor settings such as name, status, schedule, or scrape options. 2 params

Update monitor settings such as name, status, schedule, or scrape options.

Name Type Required Description
body object required Monitor configuration object. Include name, url, schedule (cron), and scrapeOptions.
id string required The unique identifier of the resource.
firecrawlmcp_firecrawl_scrape # Scrape a single URL and return its content in one or more formats (markdown, JSON, screenshot, etc.). 21 params

Scrape a single URL and return its content in one or more formats (markdown, JSON, screenshot, etc.).

Name Type Required Description
url string required The URL of the page or website to scrape, crawl, or map.
excludeTags array optional HTML tags or CSS selectors to remove from extracted content.
formats array optional Output formats to return. Accepted values: markdown, html, rawHtml, screenshot, links, summary, branding, json, query, audio.
includeTags array optional HTML tags or CSS selectors to restrict extraction to.
jsonOptions object optional Options for JSON extraction: prompt and optional JSON Schema.
location object optional Geographic location for localized content. Pass an object with country (ISO 3166-1 alpha-2 code) and optional languages array.
lockdown boolean optional Set to true to serve from cache only, without any outbound network requests.
maxAge number optional Maximum cache age in seconds; serve cached data up to this age for faster responses.
mobile boolean optional Set to true to emulate a mobile browser viewport.
onlyMainContent boolean optional Set to true to strip navigation, headers, footers, and other boilerplate.
parsers array optional Additional parsers to apply. Accepted values: pdf.
pdfOptions object optional Options for PDF parsing, such as the maximum number of pages.
profile object optional Named browser profile to use for authenticated scraping.
proxy string optional Proxy tier to use: basic for standard, stealth or enhanced for bot-resistant sites.
queryOptions object optional Options for query-mode extraction: the prompt and response mode.
removeBase64Images boolean optional Set to true to strip inline base64-encoded images from the output.
screenshotOptions object optional Options for screenshot capture, such as full-page and quality settings.
skipTlsVerification boolean optional Set to true to skip TLS certificate validation (use for self-signed certs).
storeInCache boolean optional Set to true to cache this response for future maxAge-based lookups.
waitFor number optional Milliseconds to wait for JavaScript to render before extracting content.
zeroDataRetention boolean optional Set to true to prevent Firecrawl from storing any data for this request.
firecrawlmcp_firecrawl_search_feedback # Send structured feedback on a previous search result to help improve future results. 5 params

Send structured feedback on a previous search result to help improve future results.

Name Type Required Description
rating string required Your overall quality rating for the search result.
searchId string required The ID of a previous search result. Returned by firecrawlmcp_firecrawl_search.
missingContent array optional Content types or topics that were missing from the search results.
querySuggestions string optional Alternative search queries that might yield better results.
valuableSources array optional URLs you found particularly useful in the search results.