Skip to main content
Glama

Firecrawl by Nova (CIVAI)

Server Details

Scrape, crawl, and search the web via Firecrawl’s official hosted MCP.

Ownership verified
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
ChatGPT
–
Claude
–

TDQS

B3.4/5.0

Scored across 38 tools

Disambiguation3/5

The core scrape/search/crawl/map/parse/interact tools are mostly distinct, and descriptions explicitly route between them. However, there are several overlapping entry points: firecrawl_search vs. developer/gov/research/Alexandria search, firecrawl_feedback vs. firecrawl_search_feedback, firecrawl_credit_usage vs. firecrawl_usage_dashboard, and firecrawl_agent_status vs. firecrawl_agent_activity. The detailed descriptions help, but an agent still faces meaningful selection ambiguity across 38 tools.

Naming Consistency3/5

All names use snake_case, which is good, but the conventions are mixed: firecrawl_scrape uses verb-first while firecrawl_monitor_create and firecrawl_monitor_get use resource-first, and firecrawl_check_crawl_status uses a different verb-resource-status order. Some tools also drop the firecrawl_ prefix (jobs_search, people_company_enrich, people_company_search), making the set less predictable.

Tool Count2/5

At 38 tools, the surface is heavy for an agent-facing MCP server even given Firecrawl's broad scope. Several tools appear to serve the Firecrawl UI/sidebar (firecrawl_usage_dashboard, firecrawl_provider_directory, firecrawl_recommended_providers, firecrawl_agent_activity) rather than core agent workflows, inflating the count.

Completeness4/5

The surface covers a wide domain well: scraping, searching, crawling, mapping, parsing, browser interaction, agent research, monitors with CRUD/run/checks, billing/usage, feedback, Alexandria discovery/execution, academic research, jobs, people/company enrichment, and gov/developer search. Minor lifecycle gaps remain, such as no crawl cancellation tool and no skill deletion, but agents can work around them.

Available Tools

38 tools
alexandria_library_readAInspect

Run capabilities of Alexandria data providers and return their typed, sourced records: one, or up to ten in one call when a task needs several lookups. Alexandria is Firecrawl's library of data providers across companies, people, jobs, finance and filings, public records and government spending, real estate, places and restaurants, retail and prices, package registries and developer data, news, research, and more. 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. Each entry of calls is {provider, capability, options}: provider and capability come from firecrawl_search results or alexandria_library_search, and options follow the capability's contract, which marks required inputs and any requiresOneOf groups (at least one member per group). Where the contract declares pagination, its fields page through results with the same filters. Returns one result per call, in the same order, in data.alexandria, each with data, records, or an error with a code; one call can fail while the others succeed, and an invalid call returns an error naming the valid options. A result too large to return inline is retained, and nextTool reads it in slices. Billed per executed capability; discovery is free. Some providers require accepted terms; when a response reports a terms requirement, direct the user to the Firecrawl dashboard URL in that response.

Inputs: calls (required), objective (required), timeout, requestId, +1 more.

firecrawl_agentAInspect

Run web research that returns structured data when the URLs are not known or the answer spans several sites. Describe the fields you need in prompt, optionally pass a JSON schema and seed urls, and the research agent searches, navigates, reads pages, and returns JSON assembled across sources. Use it to research an entity plus its fields (founders, pricing, contact details), to build lists and datasets (companies, people, products, jobs, papers), and for pages that need navigation or interaction to reach the data. Optional effort sets the reasoning budget, maxCredits caps spend, and strictConstrainToURLs keeps the agent to the supplied urls.

This call returns only a job ID, not the research result. Read the job with firecrawl_agent_status until it reaches completed or failed; a typical research run takes one to three minutes. For one known URL use firecrawl_scrape (with formats: ["markdown"], then extract the requested fields yourself); for a plain lookup that a results page answers, use firecrawl_search.

The job also returns a threadId. To continue that thread, pass it with a follow-up prompt; omitted mode, urls, schema and exchange settings carry over from the previous turn.

The agent only calls Alexandria providers whose terms the team has accepted. exchange.skippedProviders lists gated providers. With exchange.onTermsRequired "ask", a terms pendingApproval and exchange.requiresAction carry the approvalId and provider requirements. Read terms/show through firecrawl_scrape. An organization admin must accept terms in the Firecrawl dashboard at the provider URL or https://www.firecrawl.dev/app/settings?tab=data-sources. Ignore any terms/accept call in the API response. Only after the admin confirms acceptance, resume with the same threadId and exchange.approve: {approvalId}; this does not accept terms. To decline, use exchange.decline: {approvalId}. Never infer acceptance from a data request.

Inputs: prompt (required), mode, urls, effort, +8 more.

firecrawl_agent_activityBInspect

Read the live progress of a firecrawl_agent job for the Firecrawl agent view: its steps, searches, pages read and credits so far, and the result once it finishes. Used by the agent view; use firecrawl_agent_status to read a job.

Inputs: id (required), event.

firecrawl_agent_statusAInspect

Retrieve progress or final results for a firecrawl_agent job ID. A processing response is non-terminal and does not contain the final research result. Check again after 15–30 seconds until the status is completed or failed; a typical research run takes one to three minutes and complex jobs can take longer. If the job cannot finish within the task's available time, use firecrawl_search and firecrawl_scrape to complete the requested output.

Returns job status, progress information, and result data when completed.

Inputs: id (required), objective, conversationId.

firecrawl_check_crawl_statusAInspect

Retrieve the current status, progress, and available results for an existing crawl ID. This only reads Firecrawl job state and does not start or modify the crawl.

Inputs: id (required), objective, conversationId.

firecrawl_crawlAInspect

Start a multi-page crawl at a website URL, poll it to a terminal state, and return the final status and collected data. Scope can be bounded with include/exclude paths, depth, page limit, subdomain/external-link controls, sitemap handling, delay, and scrape options.

Crawl results can be large; use conservative limits when full-site coverage is unnecessary. Webhooks and interactive scrape actions are unavailable in safe mode. zeroDataRetention runs the crawl with zero data retention and requires an eligible authenticated account. Returns the crawl ID, status, and page data.

Inputs: url (required), delay, limit, prompt, +14 more.

firecrawl_credit_usageAInspect

Get the authenticated Firecrawl team's current credit balance or its credit usage over the last 90 days. Use the current view to answer how many credits remain or to check billing-period boundaries. Use the historical view to answer what credits were spent on and when.

The current view returns remainingCredits, planCredits, billingPeriodStart, and billingPeriodEnd. Extra purchased or granted credits can make remainingCredits greater than planCredits. Billing-period dates may be null when the upstream billing provider has no period metadata.

The historical view returns periods sorted by start date with startDate, endDate, and creditsUsed, one per calendar month, or one per UTC day with bin: "day". Set byEndpoint to split each period by the endpoint that used the credits (endpoint: scrape, search, crawl, map, agent, ...), or byApiKey to split it by API key (apiKey). The endpoint split also counts search usage, which the unsplit and per-key figures leave out, so its rows can add up to more. The newest period's endDate can be null. A notice means the requested split or daily periods are not available yet and the periods are monthly figures.

This tool cannot attribute credits to individual jobs, URLs, or MCP clients. Each tool's own result reports what that call used (creditsUsed, or metadata.creditsUsed on scrapes), and the Usage and Logs pages of the Firecrawl dashboard list usage per job.

Inputs: bin, view, byApiKey, objective, +1 more.

firecrawl_feedbackAInspect

Firecrawl uses this feedback to find and fix results that were wrong, missing or unhelpful, which improves the data later calls return.

Submit concise quality feedback for a completed search, scrape, parse, or map job. Provide the endpoint, job ID, rating, and relevant issue codes or small contextual fields; omit large page contents and raw outputs.

For an Alexandria session, set endpoint to alexandria, omit jobId, and provide requestedWebsite (url and requestedFunctionality), objective, rationale, and rating. objective is the underlying goal behind the session: what you or your user were ultimately trying to accomplish (for example, "shortlist federal IT contracts to bid on this quarter"), not only what was needed from this website. Optional providerFeedback and capabilityFeedback describe gaps or errors. Capability issues: new_capability_request (requires requestedFunctionality), missing_capability, insufficient_functionality, incorrect_result, execution_error, other. Alexandria results carry a feedbackRef per call. The overall rating covers every call in this session; callRatings [{ref, rating}] rate individual calls by feedbackRef. Alexandria feedback must arrive within 20 minutes of the team's latest Alexandria search, discovery, or execution; later feedback is rejected. Eligible feedback can refund 1 credit; refunds are subject to daily caps per website and per team.

Returns submission status, feedback ID, and accounting fields.

Inputs: rating (required), endpoint (required), url, note, +15 more.

firecrawl_interactAInspect

Open or reuse a live browser session to navigate a page, click controls, fill and submit forms, or run browser code. Provide either url (the scheme may be omitted) or scrapeId, and either a natural-language prompt or executable code; code can run as Bash, Python, or Node with a bounded timeout.

The session runs in an isolated Firecrawl-hosted browser that never receives the end user's own browser cookies or credentials. By default it starts with no cookies or saved sessions; an optional team-scoped scrapeOptions.profile reuses state saved by the team's earlier sessions. Actions run on the live site, so submitting a form can have effects on that site. Returns execution output, stdout/stderr, exit status, and session viewing URLs. When the page needs the user to act, share interactiveLiveViewUrl with the user only, so they can take over the session.

Inputs: url, code, prompt, timeout, +5 more.

firecrawl_interact_stopBInspect

Stop the live interact session associated with a scrapeId and release its resources. Returns a success confirmation.

Inputs: scrapeId (required), objective, conversationId.

firecrawl_mapAInspect

Enumerate URLs indexed under one website through Firecrawl without fetching each page's content. Use this when the request asks for a site's URL inventory, when several relevant pages must be located, or when the desired page URL is unknown. An optional search term narrows the URL list, while sitemap, subdomain, query-parameter, and result-limit options control coverage.

url may omit the scheme (example.com); it is read as https. Returns matching URLs rather than page bodies. Retrieve one page with firecrawl_scrape; collect content across multiple pages with firecrawl_crawl. Authenticated responses can include an id for optional map feedback.

Inputs: url (required), limit, search, sitemap, +4 more.

firecrawl_monitor_checkBInspect

Retrieve one monitor check and its page-level results, optionally filtered by page status. Pages report same, new, changed, removed, or error; configured goal judging can add a meaningful-change decision.

Markdown tracking returns a unified text diff, JSON tracking returns field paths with previous/current values and a current snapshot, and mixed tracking returns both. Returns one page of results plus a next URL when more pages exist.

Inputs: id (required), checkId (required), skip, limit, +2 more.

firecrawl_monitor_checksBInspect

List historical checks for a monitor, optionally filtered by status and bounded by a result limit. Returns one page of check summaries and pagination metadata.

Inputs: id (required), limit, offset, status, +1 more.

firecrawl_monitor_createAInspect

Create a recurring scrape, crawl, or search monitor that compares each check with its retained predecessor. The simple form accepts page/pages or queries plus a plain-language goal; the advanced body form controls targets, schedule, change-tracking formats, judging, retention, webhook, and notifications.

In the simple form, a goal is required. If queries contains one or more non-empty values and is supplied with page/pages, queries create the search target and page targets are ignored. A monitor schedules future network checks and can send configured email or webhook notifications. Returns the created monitor.

Inputs: body, goal, name, page, +12 more.

firecrawl_monitor_deleteAInspect

Permanently delete a monitor by ID and stop its future schedule. This operation cannot be undone and returns deletion status.

Inputs: id (required), objective.

firecrawl_monitor_getAInspect

Retrieve one monitor by ID, including its configuration and current state. This does not run or modify the monitor.

Inputs: id (required), objective.

firecrawl_monitor_listBInspect

List monitors for the authenticated account with optional pagination controls. Returns one page of monitor records and pagination metadata.

Inputs: limit, offset, objective.

firecrawl_monitor_runBInspect

Queue an immediate check for a monitor outside its normal schedule. This starts network work for the monitor's configured targets and returns the queued check.

Inputs: id (required), objective.

firecrawl_monitor_updateAInspect

Patch an existing monitor by ID; changes affect future scheduled checks. Pause or resume it with status ("paused" or "active"). Reschedule it with scheduleText (plain language, e.g. "every 6 hours") or cron, plus timezone; a new schedule without timezone runs in UTC. For other fields pass body, a partial monitor in the create shape (name, targets, goal, judgeEnabled, webhook, notification, retentionDays), e.g. {"name": "Pricing watch"}. The parameters are merged into body as {"status": ..., "schedule": {"text" or "cron": ..., "timezone": ...}} and override the same keys there. At least one change is required.

Returns the updated monitor.

Inputs: id (required), body, cron, status, +3 more.

firecrawl_parseAInspect

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.

Inputs: proxy, maxAge, formats, parsers, +17 more.

firecrawl_provider_directoryAInspect

List every Alexandria data provider, or every provider in one category, in a single call; with limit, only the first providers in catalogue order. Used by the Firecrawl sidebar; free, and it executes no provider. Use alexandria_library_search to browse the catalogue or read contracts (/library///.md).

Inputs: limit, category.

firecrawl_research_inspect_paperBInspect

Retrieve canonical metadata for one paper ID, such as an arXiv, PMC, PMID, or DOI identifier. Returns the title, abstract, authors, categories, source IDs, and dates as markdown.

Inputs: paperId (required), objective.

firecrawl_research_lookup_proteinAInspect

Look up one protein in UniProtKB/Swiss-Prot, the reviewed section of UniProt, and return what its curators state: subcellular location, function, and GO cellular-component terms. Use this when the question is where a named protein is located in the cell, what it does, or which compartment terms it has, and you have a UniProt accession (P05771), an entry name (KPCB_HUMAN), a gene symbol (PRKCB), or the exact protein name. One protein per call; organism defaults to human.

Each location and function statement carries an evidence label and, where UniProt cites one, a pmid: paper ID. Among these statements, only those whose label starts with "Experimental" are measurements. Every other label, such as "Inferred from a related protein", "Curator inference", "Predicted from sequence", or "No evidence tag", is not, so report the label with the statement. The GO cellular-component terms carry no such label. Every GO term listed has experimental evidence, shown by its GO code (IDA and the like) and the group that assigned it. When a location statement and a GO term name the same compartment with different evidence, say which one the compartment rests on, for example "curated location has no evidence tag; GO term mitochondrion is experimental, IDA, HPA". Open a cited paper with firecrawl_research_inspect_paper or firecrawl_research_read_paper.

Not for free-text questions, topics, diseases, or lists of proteins (use firecrawl_research_search_papers), and not for structures, compounds, interactions, or unreviewed entries. If a symbol names several proteins, the result lists candidates; call again with one accession.

Inputs: protein (required), organism, objective.

firecrawl_research_read_paperBInspect

Retrieve in-body passages from one paper that are relevant to a specific question. Full text is available only for indexed papers; k controls the number of passages.

Returns matching passages or a notice when full text is unavailable.

Inputs: paperId (required), question (required), k, objective.

firecrawl_research_search_papersAInspect

Search paper metadata and abstracts with a natural-language query across the indexed corpus, which spans biomedical, life-science, and clinical literature (PubMed, bioRxiv, medRxiv) alongside arXiv and other scientific sources. Optional author, category, date, and sort options constrain or reorder results.

Several distinct framings of the same question surface different papers than a single query does.

Returns ranked papers with canonical IDs, titles, authors, and abstracts. Papers with licensed full text also carry the body passage that best matches the query.

Inputs: query (required), k, to, from, +4 more.

firecrawl_save_skillAInspect

Create or change one of the user's team skills: instructions an agent follows, naming capabilities as @provider/capability. Without id, creates one: write name, description and body, or copy a skill under /library/skills with from (its id: for /library/skills/firecrawl/, team: for /library/skills/team/); fields you also give override the copy, and a library skill copies its SKILL.md only. The new skill is enabled and listed in /library/skills/INDEX as /library/skills/team/; a taken slug is a conflict. With id (team:) and baseVersion, the version: in its SKILL.md, changes its name, description or body (a new version), or whether it is enabled or listed; a skill changed since is refused with conflict, so read it again and reapply. A body edited from the text you read must write each capability as @provider/capability again: the plain code it shows saves no reference. Library skills cannot be changed; copy one. Skills cannot be deleted here. Returns the saved skill's path and the command that reads it. Save only what the user asked for. Free.

Inputs: id, body, from, name, +6 more.

firecrawl_scrapeAInspect

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.

Inputs: url (required), objective (required), proxy, maxAge, +22 more.

firecrawl_search_feedbackAInspect

Firecrawl uses this feedback to find and fix results that were wrong, missing or unhelpful, which improves the data later calls return.

Records schema-validated quality feedback for a prior firecrawl_search UUID searchId. A good rating requires a valuable result or a valuable source, partial either of those or at least one missingContent entry, and bad at least one missingContent entry or a query suggestion; caps are 50 valuableResults, 50 valuableSources, and 20 missingContent entries.

Eligibility is limited to successful searches within the feedback age window. The record is idempotent per search ID. Eligible first feedback for a search can refund 1 credit; refunds are subject to the team's daily cap. The response reports whether a refund was applied, along with submission and daily-cap status.

Mark useful returned results in valuableResults as {"source", "position"} copied off the result. Groups are numbered from 1 independently, so {"source":"web","position":1} and {"source":"news","position":1} are different results. Be exhaustive — results you do not list are treated as not useful. Reserve valuableSources for useful URLs that were NOT among the returned results; never report one result in both fields.

Inputs: rating (required), searchId (required), objective, conversationId, +4 more.

firecrawl_usage_dashboardAInspect

Open the Firecrawl sidebar to browse Alexandria providers, attach tool context to a conversation, and view account credits and monthly usage. Requires a connected Firecrawl account. Use firecrawl_credit_usage for data-only reporting.

Inputs: no named parameters.

people_company_enrichAInspect

Use this first when the user names a person (a name with a company or domain, a LinkedIn URL or an email) or a company and wants contact details, a profile or firmographics, such as the email of a founder at a given company. Use it, not people_company_search, whenever you have one of those identifiers. Give people (name with company or domain, LinkedIn URL, email or phone) or companies (domain, name or LinkedIn URL), up to 10 records per call. Each requested field runs a waterfall: Firecrawl tries the providers that can use your inputs one at a time, by listed price, and stops when the field is found. Without contact_fields a person gets a profile and a company gets firmographics; with contact_fields (work_email, personal_email, mobile) each person gets those values and, unless profile is false, the profile too. Ask for mobile only when a phone number is needed: it is the costliest field. A work email is never on a known free-mail domain or role mailbox, and is on the company domain when one is found there; otherwise an address at another employer may be returned with domain_match false and warning "employer_mismatch" in fields.work_email: treat it as unconfirmed. fields says for each answer which provider gave it, whether the email was verified and its domain matched. verified_only returns only verified emails. Each result is the provider's raw response, tagged with the provider. A provider that finds the value is charged its listed price; misses are free. max_credits caps the call; without it there is no cap. To call one specific provider, use alexandria_library_read instead. Example: {"contact_fields":["work_email"],"people":[{"name":"Jane Doe","domain":"example.com"}]}.

Inputs: objective (required), people, profile, companies, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources