Server definition
- Hash
- sha256:7522db041b8264d44f501e22f76cf50481e7117f672601a8bd36cfad42a0c689
- What it is
- What a remote MCP server returned when asked what it offers: 38 tools
The blob, as servednamed by its sha256
{
"instructions": "",
"tools": [
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"calls": {
"description": "The capabilities to run, 1-10, each {provider, capability, options}. Results come back in the same order.",
"items": {
"additionalProperties": false,
"properties": {
"capability": {
"description": "Capability address as returned by search or discover, e.g. \"series/observations\".",
"minLength": 1,
"type": "string"
},
"options": {
"additionalProperties": true,
"description": "Capability options as declared by its contract.",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"provider": {
"description": "Provider slug, e.g. \"fred\".",
"minLength": 1,
"type": "string"
},
"version": {
"description": "Optional published workflow version. Omit to use the latest version.",
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"required": [
"provider",
"capability"
],
"type": "object"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
},
"conversationId": {
"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.",
"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}$",
"type": "string"
},
"objective": {
"description": "The user's underlying goal for this call, in one sentence: what they are ultimately trying to accomplish, not a restatement of the URL or query. Reuse it across related calls. Avoid sensitive information.",
"maxLength": 1000,
"minLength": 1,
"type": "string"
},
"requestId": {
"description": "Idempotency key bound to one execution payload. Generated when omitted and returned with the result.",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"type": "string"
},
"timeout": {
"description": "Execution timeout in milliseconds.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"calls",
"objective"
],
"type": "object"
},
"name": "alexandria_library_read",
"outputSchema": null
},
{
"description": "Check /library/skills first for any business workflow (sales or meeting prep, prospect lists, competitor, market or financial research, monitoring): it holds your team's and Firecrawl's step-by-step instructions for these tasks; follow a matching one instead of improvising. `cat /library/skills/search/<a-few-words-from-the-task>` (joined by hyphens) ranks them, your team's first; cat the path to read one. Explore the Alexandria library: Firecrawl's catalogue of data providers that return typed, sourced records (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) as a read-only filesystem, using shell commands. Use this to find out whether a provider covers the data a task needs, and to read its contract before alexandria_library_read. Layout: /library/<category>/<provider>/<capability>.md, one file per capability holding its contract (when to use it, inputs, outputs, and the call to send); /library, each category folder and each provider folder has a README.md describing what is inside. Category folders: agriculture, ai-models, apps, automotive, community, companies, developer, digital-intelligence, education, energy, entertainment, finance, game-development, government, health, healthcare, jobs, knowledge, life-sciences, marketing, music, news, people, places, podcasts, political-science, real-estate, research, restaurants, shopping, social, software, sports, travel; `ls /library` shows any added since. Available commands: ls, tree, cat, head, tail, grep, find, wc, sort, uniq, cut, tr, sed, jq, xargs, with pipes. Typical starts: `ls /library`, `cat /library/README.md`, or `grep -ril \"mortgage\" /library`. A file path is the execute address: /library/finance/fred/series/observations.md is provider \"fred\", capability \"series/observations\". Recorded example responses are under /examples/<provider>/<capability>.json. Free; does not run providers.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"command": {
"description": "Shell command to run inside the read-only library, e.g. `grep -ril \"rental\" /library | head -20`.",
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"conversationId": {
"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.",
"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}$",
"type": "string"
},
"objective": {
"description": "The user's underlying goal for this call, in one sentence: what they are ultimately trying to accomplish, not a restatement of the URL or query. Reuse it across related calls. Avoid sensitive information.",
"maxLength": 1000,
"minLength": 1,
"type": "string"
}
},
"required": [
"command",
"objective"
],
"type": "object"
},
"name": "alexandria_library_search",
"outputSchema": null
},
{
"description": "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`.\n\nThis 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`.\n\nThe 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.\n\nThe 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"conversationId": {
"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.",
"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}$",
"type": "string"
},
"effort": {
"description": "Reasoning budget for the agent task.",
"enum": [
"low",
"medium",
"high"
],
"type": "string"
},
"exchange": {
"additionalProperties": false,
"description": "Alexandria provider settings for this turn, forwarded as the request's exchange object.",
"properties": {
"approve": {
"additionalProperties": false,
"description": "Answer yes to the pendingApproval the previous turn of this thread ended on (its id, also exchange.requiresAction.approvalId). Needs threadId. For a terms offer, send it only after an organization admin confirms acceptance in the Firecrawl dashboard; this does not accept terms. callIds and always are ignored on terms offers. For paid calls, callIds picks a subset (default all) and always stops asking for the rest of the thread.",
"properties": {
"always": {
"type": "boolean"
},
"approvalId": {
"format": "uuid",
"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}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"callIds": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"approvalId"
],
"type": "object"
},
"decline": {
"additionalProperties": false,
"description": "Answer no to that pendingApproval. Needs threadId. A declined terms offer keeps those providers out of the rest of the thread.",
"properties": {
"approvalId": {
"format": "uuid",
"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}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
}
},
"required": [
"approvalId"
],
"type": "object"
},
"enabled": {
"description": "Let the agent call Alexandria providers. On by default.",
"type": "boolean"
},
"maxCalls": {
"description": "Most provider calls the agent may make in this turn.",
"maximum": 30,
"minimum": 1,
"type": "integer"
},
"onTermsRequired": {
"description": "What to do when a provider the agent would use needs data terms the team has not accepted. Gated providers are never called. \"skip\" (default): answer with accepted providers and list the rest in exchange.skippedProviders. \"ask\": the same, plus a terms pendingApproval and exchange.requiresAction. Read terms with terms/show; an organization admin accepts them in the Firecrawl dashboard. There is no auto-accept. Omitted on a follow-up keeps the previous turn's value.",
"enum": [
"skip",
"ask"
],
"type": "string"
},
"requireApproval": {
"description": "End the turn with a paid-call pendingApproval before any paid provider call. Requires mode \"chat\" on the same request, even on a follow-up.",
"type": "boolean"
},
"toolkits": {
"description": "Pin up to 5 providers the agent may use, by slug. Omitted means the whole catalog.",
"items": {
"type": "string"
},
"maxItems": 5,
"type": "array"
}
},
"type": "object"
},
"maxCredits": {
"description": "Spending limit in credits for this run. Defaults to 2500 on the API.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"mode": {
"description": "\"extract\" (default) returns the complete structured result every turn. \"chat\" lets a follow-up that asks no new data get a short reply in message instead of a re-run; required for exchange.requireApproval. Omitted on a follow-up keeps the previous turn's mode.",
"enum": [
"extract",
"chat"
],
"type": "string"
},
"prompt": {
"maxLength": 10000,
"minLength": 1,
"type": "string"
},
"schema": {
"additionalProperties": true,
"propertyNames": {
"type": "string"
},
"type": "object"
},
"strictConstrainToURLs": {
"description": "If true, agent will only visit URLs provided in the urls array.",
"type": "boolean"
},
"threadId": {
"description": "Continue this thread: the threadId from an earlier firecrawl_agent or firecrawl_agent_status result. Omit to start a new thread.",
"format": "uuid",
"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}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"urls": {
"items": {
"type": "string"
},
"type": "array"
},
"zeroDataRetention": {
"description": "Run with zero data retention. Requires an eligible authenticated account with Zero Data Retention enabled for both scrape and search. Cannot be combined with threadId.",
"type": "boolean"
}
},
"required": [
"prompt"
],
"type": "object"
},
"name": "firecrawl_agent",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"event": {
"description": "Records this action taken in the agent view, for usage counts, instead of reading the job.",
"enum": [
"copy_result",
"download_csv",
"download_json",
"view_preview",
"view_table",
"page",
"retry",
"expand_steps",
"collapse_steps",
"show_earlier_steps",
"open_source",
"show_more_sources",
"open_result_link",
"expand_text",
"show_more_items"
],
"type": "string"
},
"id": {
"description": "Agent job ID from firecrawl_agent.",
"format": "uuid",
"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}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "firecrawl_agent_activity",
"outputSchema": null
},
{
"description": "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.\n\nReturns job status, progress information, and result data when completed.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"conversationId": {
"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.",
"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}$",
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "firecrawl_agent_status",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"conversationId": {
"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.",
"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}$",
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "firecrawl_check_crawl_status",
"outputSchema": null
},
{
"description": "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.\n\nCrawl 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"allowExternalLinks": {
"type": "boolean"
},
"allowSubdomains": {
"type": "boolean"
},
"conversationId": {
"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.",
"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}$",
"type": "string"
},
"crawlEntireDomain": {
"type": "boolean"
},
"deduplicateSimilarURLs": {
"type": "boolean"
},
"delay": {
"type": "number"
},
"excludePaths": {
"items": {
"type": "string"
},
"type": "array"
},
"ignoreQueryParameters": {
"type": "boolean"
},
"includePaths": {
"items": {
"type": "string"
},
"type": "array"
},
"limit": {
"type": "number"
},
"maxConcurrency": {
"type": "number"
},
"maxDiscoveryDepth": {
"type": "number"
},
"prompt": {
"type": "string"
},
"scrapeOptions": {
"additionalProperties": false,
"properties": {
"excludeTags": {
"items": {
"type": "string"
},
"type": "array"
},
"formats": {
"items": {
"enum": [
"markdown",
"html",
"rawHtml",
"screenshot",
"links",
"images",
"summary",
"changeTracking",
"branding",
"json",
"query",
"audio"
],
"type": "string"
},
"type": "array"
},
"includeTags": {
"items": {
"type": "string"
},
"type": "array"
},
"jsonOptions": {
"additionalProperties": false,
"properties": {
"prompt": {
"type": "string"
},
"schema": {
"additionalProperties": true,
"propertyNames": {
"type": "string"
},
"type": "object"
}
},
"type": "object"
},
"location": {
"additionalProperties": false,
"properties": {
"country": {
"type": "string"
},
"languages": {
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"lockdown": {
"type": "boolean"
},
"maxAge": {
"type": "number"
},
"mobile": {
"type": "boolean"
},
"onlyMainContent": {
"type": "boolean"
},
"parsers": {
"items": {
"enum": [
"pdf"
],
"type": "string"
},
"type": "array"
},
"pdfOptions": {
"additionalProperties": false,
"properties": {
"maxPages": {
"maximum": 10000,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"profile": {
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"saveChanges": {
"type": "boolean"
}
},
"required": [
"name"
],
"type": "object"
},
"proxy": {
"enum": [
"basic",
"stealth",
"enhanced",
"auto"
],
"type": "string"
},
"queryOptions": {
"additionalProperties": false,
"properties": {
"mode": {
"default": "freeform",
"enum": [
"directQuote",
"freeform"
],
"type": "string"
},
"prompt": {
"maxLength": 10000,
"type": "string"
}
},
"required": [
"prompt"
],
"type": "object"
},
"redactPII": {
"type": "boolean"
},
"removeBase64Images": {
"type": "boolean"
},
"screenshotOptions": {
"additionalProperties": false,
"properties": {
"fullPage": {
"type": "boolean"
},
"quality": {
"type": "number"
},
"viewport": {
"additionalProperties": false,
"properties": {
"height": {
"type": "number"
},
"width": {
"type": "number"
}
},
"required": [
"width",
"height"
],
"type": "object"
}
},
"type": "object"
},
"skipTlsVerification": {
"type": "boolean"
},
"storeInCache": {
"type": "boolean"
},
"waitFor": {
"type": "number"
}
},
"type": "object"
},
"sitemap": {
"enum": [
"skip",
"include",
"only"
],
"type": "string"
},
"url": {
"type": "string"
},
"zeroDataRetention": {
"type": "boolean"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "firecrawl_crawl",
"outputSchema": null
},
{
"description": "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.\n\nThe 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.\n\nThe 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.\n\nThis 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"bin": {
"description": "Length of each historical period: calendar month (default) or UTC day. When view is omitted, it selects the historical view; it cannot be combined with view \"current\".",
"enum": [
"month",
"day"
],
"type": "string"
},
"byApiKey": {
"description": "Break historical usage down by API key. When view is omitted, true selects the historical view; it cannot be combined with view \"current\".",
"type": "boolean"
},
"byEndpoint": {
"description": "Break historical usage down by endpoint (scrape, search, crawl, map, agent, ...). When view is omitted, true selects the historical view; it cannot be combined with view \"current\" or byApiKey.",
"type": "boolean"
},
"view": {
"description": "Select current balance or historical usage. Defaults to current.",
"enum": [
"current",
"historical"
],
"type": "string"
}
},
"type": "object"
},
"name": "firecrawl_credit_usage",
"outputSchema": null
},
{
"description": "Search an index of public repositories, GitHub issues, merged pull requests, repository READMEs, and code documentation for programming questions that need external documentation or upstream evidence.\n\nReturns ranked results with an ID, source type, URL, title, and the matched passages in markdown.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"k": {
"description": "Number of ranked results to return (default 10).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Natural-language developer question or search phrase, including the library, error message, or API involved when relevant.",
"minLength": 1,
"type": "string"
},
"skills": {
"description": "Set to \"only\" to search only agent-skill files.",
"enum": [
"only"
],
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "firecrawl_developer_search",
"outputSchema": null
},
{
"description": "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.\n\nFor 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.\n\nReturns submission status, feedback ID, and accounting fields.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"callRatings": {
"items": {
"additionalProperties": false,
"properties": {
"rating": {
"enum": [
"good",
"partial",
"bad"
],
"type": "string"
},
"ref": {
"maxLength": 32,
"minLength": 1,
"type": "string"
}
},
"required": [
"ref",
"rating"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"capabilityFeedback": {
"items": {
"additionalProperties": false,
"properties": {
"issue": {
"enum": [
"new_capability_request",
"missing_capability",
"insufficient_functionality",
"incorrect_result",
"execution_error",
"other"
],
"type": "string"
},
"name": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"provider": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"requestedFunctionality": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"why": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
}
},
"required": [
"name",
"provider",
"issue",
"why"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"conversationId": {
"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.",
"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}$",
"type": "string"
},
"endpoint": {
"enum": [
"search",
"scrape",
"parse",
"map",
"alexandria"
],
"type": "string"
},
"issues": {
"items": {
"maxLength": 80,
"minLength": 1,
"pattern": "^[a-z0-9][a-z0-9_-]*$",
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"jobId": {
"format": "uuid",
"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}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"metadata": {
"additionalProperties": true,
"propertyNames": {
"type": "string"
},
"type": "object"
},
"missingContent": {
"items": {
"properties": {
"description": {
"maxLength": 2000,
"type": "string"
},
"topic": {
"maxLength": 200,
"minLength": 1,
"type": "string"
}
},
"required": [
"topic"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"note": {
"maxLength": 4000,
"type": "string"
},
"objective": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"pageNumbers": {
"items": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"maxItems": 100,
"type": "array"
},
"providerFeedback": {
"items": {
"additionalProperties": false,
"properties": {
"issue": {
"enum": [
"missing_provider",
"insufficient_coverage",
"provider_unavailable",
"other"
],
"type": "string"
},
"name": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"why": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
}
},
"required": [
"name",
"issue",
"why"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"querySuggestions": {
"maxLength": 2000,
"type": "string"
},
"rating": {
"enum": [
"good",
"bad",
"partial"
],
"type": "string"
},
"rationale": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"requestedWebsite": {
"additionalProperties": false,
"properties": {
"requestedFunctionality": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"url": {
"format": "uri",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"url",
"requestedFunctionality"
],
"type": "object"
},
"tags": {
"items": {
"maxLength": 80,
"minLength": 1,
"pattern": "^[a-z0-9][a-z0-9_-]*$",
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"url": {
"format": "uri",
"type": "string"
},
"valuableSources": {
"items": {
"properties": {
"reason": {
"maxLength": 1000,
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
}
},
"required": [
"endpoint",
"rating"
],
"type": "object"
},
"name": "firecrawl_feedback",
"outputSchema": null
},
{
"description": "Search US federal, state, and local statutes, regulations, codes, court opinions, and other government publications for legal or regulatory questions that need primary text. Clarify a missing jurisdiction or ambiguous as-of date before identifying the governing rule.\n\nOptional filters narrow results by jurisdiction, court, court type, cited law or case, and site. Filters keep only pages the index has labeled, so a filtered search can leave out relevant pages, and no results does not mean none exist. Court labels are most complete for federal courts and case-law collections.\n\nReturns ranked results with a position, title, URL, and matched snippet. Results may include historical versions, bill text, agency guidance, and third-party reproductions. Verify the issuer, jurisdiction, enacted/effective status, and version before citing current governing law. Read a known URL or additional page context with firecrawl_scrape. Use general search for non-US questions or missing coverage; no hits does not establish that no applicable law exists.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cites": {
"description": "Keep only pages that cite one law or case, as a printed citation such as \"42 U.S.C. § 1983\" or \"5 U.S. 137\", or a citation id such as \"us:usc:42:1983\".",
"minLength": 1,
"type": "string"
},
"court": {
"description": "Keep only pages labeled for one court, by CourtListener court id, such as \"scotus\", \"ca9\" or \"nysd\".",
"minLength": 1,
"type": "string"
},
"courtType": {
"description": "Keep only pages from one type of court: federal-supreme, federal-appellate, federal-district, federal-bankruptcy, federal-special, military, state-supreme, state-appellate, state-trial, state-special, state-attorney-general.",
"enum": [
"federal-supreme",
"federal-appellate",
"federal-district",
"federal-bankruptcy",
"federal-special",
"military",
"state-supreme",
"state-appellate",
"state-trial",
"state-special",
"state-attorney-general"
],
"type": "string"
},
"domain": {
"description": "Keep only pages from one site, such as \"irs.gov\".",
"minLength": 1,
"type": "string"
},
"jurisdiction": {
"description": "Keep only pages of one jurisdiction: \"us\" for federal, or \"us-\" plus a two-letter state or territory code, such as \"us-ca\" or \"us-dc\".",
"pattern": "^us(-[a-z]{2})?$",
"type": "string"
},
"k": {
"description": "Number of ranked results to return (default 10).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Natural-language legal or regulatory question or search phrase, including the jurisdiction, agency, or citation when relevant.",
"minLength": 1,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "firecrawl_gov_search",
"outputSchema": null
},
{
"description": "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.\n\nThe 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"code": {
"minLength": 1,
"type": "string"
},
"conversationId": {
"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.",
"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}$",
"type": "string"
},
"language": {
"enum": [
"bash",
"python",
"node"
],
"type": "string"
},
"prompt": {
"minLength": 1,
"type": "string"
},
"scrapeId": {
"minLength": 1,
"type": "string"
},
"scrapeOptions": {
"additionalProperties": false,
"properties": {
"excludeTags": {
"items": {
"type": "string"
},
"type": "array"
},
"formats": {
"items": {
"enum": [
"markdown",
"html",
"rawHtml",
"screenshot",
"links",
"images",
"summary",
"changeTracking",
"branding",
"json",
"query",
"audio"
],
"type": "string"
},
"type": "array"
},
"includeTags": {
"items": {
"type": "string"
},
"type": "array"
},
"jsonOptions": {
"additionalProperties": false,
"properties": {
"prompt": {
"type": "string"
},
"schema": {
"additionalProperties": true,
"propertyNames": {
"type": "string"
},
"type": "object"
}
},
"type": "object"
},
"location": {
"additionalProperties": false,
"properties": {
"country": {
"type": "string"
},
"languages": {
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"lockdown": {
"type": "boolean"
},
"maxAge": {
"type": "number"
},
"mobile": {
"type": "boolean"
},
"onlyMainContent": {
"type": "boolean"
},
"parsers": {
"items": {
"enum": [
"pdf"
],
"type": "string"
},
"type": "array"
},
"pdfOptions": {
"additionalProperties": false,
"properties": {
"maxPages": {
"maximum": 10000,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"profile": {
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"saveChanges": {
"type": "boolean"
}
},
"required": [
"name"
],
"type": "object"
},
"proxy": {
"enum": [
"basic",
"stealth",
"enhanced",
"auto"
],
"type": "string"
},
"queryOptions": {
"additionalProperties": false,
"properties": {
"mode": {
"default": "freeform",
"enum": [
"directQuote",
"freeform"
],
"type": "string"
},
"prompt": {
"maxLength": 10000,
"type": "string"
}
},
"required": [
"prompt"
],
"type": "object"
},
"redactPII": {
"type": "boolean"
},
"removeBase64Images": {
"type": "boolean"
},
"screenshotOptions": {
"additionalProperties": false,
"properties": {
"fullPage": {
"type": "boolean"
},
"quality": {
"type": "number"
},
"viewport": {
"additionalProperties": false,
"properties": {
"height": {
"type": "number"
},
"width": {
"type": "number"
}
},
"required": [
"width",
"height"
],
"type": "object"
}
},
"type": "object"
},
"skipTlsVerification": {
"type": "boolean"
},
"storeInCache": {
"type": "boolean"
},
"waitFor": {
"type": "number"
},
"zeroDataRetention": {
"type": "boolean"
}
},
"type": "object"
},
"timeout": {
"maximum": 300,
"minimum": 1,
"type": "number"
},
"url": {
"type": "string"
}
},
"type": "object"
},
"name": "firecrawl_interact",
"outputSchema": null
},
{
"description": "Stop the live interact session associated with a `scrapeId` and release its resources. Returns a success confirmation.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"conversationId": {
"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.",
"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}$",
"type": "string"
},
"scrapeId": {
"type": "string"
}
},
"required": [
"scrapeId"
],
"type": "object"
},
"name": "firecrawl_interact_stop",
"outputSchema": null
},
{
"description": "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.\n\n`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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"conversationId": {
"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.",
"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}$",
"type": "string"
},
"ignoreQueryParameters": {
"type": "boolean"
},
"includeSubdomains": {
"type": "boolean"
},
"limit": {
"type": "number"
},
"search": {
"type": "string"
},
"sitemap": {
"enum": [
"include",
"skip",
"only"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "firecrawl_map",
"outputSchema": null
},
{
"description": "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.\n\nMarkdown 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"checkId": {
"type": "string"
},
"id": {
"type": "string"
},
"limit": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"pageStatus": {
"enum": [
"same",
"new",
"changed",
"removed",
"error"
],
"type": "string"
},
"skip": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"id",
"checkId"
],
"type": "object"
},
"name": "firecrawl_monitor_check",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"limit": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"offset": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"status": {
"enum": [
"queued",
"running",
"completed",
"failed",
"partial",
"skipped_overlap"
],
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "firecrawl_monitor_checks",
"outputSchema": null
},
{
"description": "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.\n\nIn 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"body": {
"additionalProperties": true,
"propertyNames": {
"type": "string"
},
"type": "object"
},
"email": {
"type": "string"
},
"excludeDomains": {
"items": {
"type": "string"
},
"type": "array"
},
"goal": {
"type": "string"
},
"includeDiffs": {
"type": "boolean"
},
"includeDomains": {
"items": {
"type": "string"
},
"type": "array"
},
"maxResults": {
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"name": {
"type": "string"
},
"page": {
"type": "string"
},
"pages": {
"items": {
"type": "string"
},
"type": "array"
},
"queries": {
"items": {
"type": "string"
},
"type": "array"
},
"scheduleText": {
"type": "string"
},
"searchWindow": {
"enum": [
"5m",
"15m",
"1h",
"6h",
"24h",
"7d"
],
"type": "string"
},
"timezone": {
"type": "string"
},
"webhookUrl": {
"type": "string"
}
},
"type": "object"
},
"name": "firecrawl_monitor_create",
"outputSchema": null
},
{
"description": "Permanently delete a monitor by ID and stop its future schedule. This operation cannot be undone and returns deletion status.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "firecrawl_monitor_delete",
"outputSchema": null
},
{
"description": "Retrieve one monitor by ID, including its configuration and current state. This does not run or modify the monitor.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "firecrawl_monitor_get",
"outputSchema": null
},
{
"description": "List monitors for the authenticated account with optional pagination controls. Returns one page of monitor records and pagination metadata.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"offset": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"name": "firecrawl_monitor_list",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "firecrawl_monitor_run",
"outputSchema": null
},
{
"description": "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.\n\nReturns the updated monitor.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"body": {
"additionalProperties": true,
"propertyNames": {
"type": "string"
},
"type": "object"
},
"cron": {
"type": "string"
},
"id": {
"type": "string"
},
"scheduleText": {
"type": "string"
},
"status": {
"enum": [
"active",
"paused"
],
"type": "string"
},
"timezone": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "firecrawl_monitor_update",
"outputSchema": null
},
{
"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": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"contentType": {
"description": "Phase 1 MIME type override. If omitted, the server infers it from the file extension without reading the file.",
"type": "string"
},
"conversationId": {
"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.",
"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}$",
"type": "string"
},
"declaredSizeBytes": {
"description": "Optional phase 1 size declaration. Hosted MCP does not stat the file; provide this only if the caller already knows it.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"excludeTags": {
"items": {
"type": "string"
},
"type": "array"
},
"filePath": {
"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.",
"minLength": 1,
"type": "string"
},
"formats": {
"items": {
"enum": [
"markdown",
"html",
"rawHtml",
"links",
"summary",
"json",
"query"
],
"type": "string"
},
"type": "array"
},
"includeTags": {
"items": {
"type": "string"
},
"type": "array"
},
"jsonOptions": {
"additionalProperties": false,
"properties": {
"prompt": {
"type": "string"
},
"schema": {
"additionalProperties": true,
"propertyNames": {
"type": "string"
},
"type": "object"
}
},
"type": "object"
},
"maxAge": {
"description": "Ignored: parse never reuses or stores indexed content.",
"type": "number"
},
"onlyMainContent": {
"type": "boolean"
},
"parsers": {
"items": {
"enum": [
"pdf"
],
"type": "string"
},
"type": "array"
},
"pdfOptions": {
"additionalProperties": false,
"properties": {
"maxPages": {
"maximum": 10000,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"proxy": {
"enum": [
"basic",
"auto"
],
"type": "string"
},
"queryOptions": {
"additionalProperties": false,
"properties": {
"mode": {
"default": "freeform",
"enum": [
"directQuote",
"freeform"
],
"type": "string"
},
"prompt": {
"maxLength": 10000,
"type": "string"
}
},
"required": [
"prompt"
],
"type": "object"
},
"redactPII": {
"type": "boolean"
},
"removeBase64Images": {
"type": "boolean"
},
"skipTlsVerification": {
"type": "boolean"
},
"storeInCache": {
"type": "boolean"
},
"uploadRef": {
"description": "Phase 2 only: short-lived upload reference returned by phase 1 after the local PUT upload completes.",
"minLength": 1,
"type": "string"
},
"zeroDataRetention": {
"type": "boolean"
}
},
"type": "object"
},
"name": "firecrawl_parse",
"outputSchema": null
},
{
"description": "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/<category>/<provider>/<capability>.md).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"category": {
"description": "Category ID (the <category> folder in alexandria_library_search's /library).",
"minLength": 1,
"type": "string"
},
"limit": {
"description": "Return only the first providers, in one catalogue page.",
"maximum": 100,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "firecrawl_provider_directory",
"outputSchema": null
},
{
"description": "List data providers recommended for the connected team from its own Firecrawl activity in the last 30 days, each with the reason it was picked. Used by the Firecrawl sidebar; free, and it executes no provider.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "firecrawl_recommended_providers",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"paperId": {
"description": "Canonical paperId or primaryId such as `arxiv:1706.03762`, `pmcid:PMC12530322`, `pmid:40953549`, or `doi:10.1016/j.neunet.2025.108095`.",
"minLength": 1,
"type": "string"
}
},
"required": [
"paperId"
],
"type": "object"
},
"name": "firecrawl_research_inspect_paper",
"outputSchema": null
},
{
"description": "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.\n\nEach 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.\n\nNot 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"organism": {
"description": "Organism that scopes a gene symbol or protein name: an NCBI taxon ID (`10090`), a scientific name (`Mus musculus`), or a UniProt common name (`Mouse`). Defaults to human (`9606`). Accessions and entry names ignore it.",
"minLength": 1,
"type": "string"
},
"protein": {
"description": "One protein identifier: a UniProt accession (`P05771`; an isoform ID such as `P05771-2` resolves to its entry), an entry name (`KPCB_HUMAN`), a gene symbol (`PRKCB`), or the exact protein name (`Protein kinase C beta type`). Not a question or a sentence.",
"maxLength": 200,
"minLength": 1,
"type": "string"
}
},
"required": [
"protein"
],
"type": "object"
},
"name": "firecrawl_research_lookup_protein",
"outputSchema": null
},
{
"description": "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.\n\nReturns matching passages or a notice when full text is unavailable.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"k": {
"description": "Number of passages to return (default 4).",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"paperId": {
"description": "Canonical paperId or primaryId such as `arxiv:1706.03762`, `pmcid:PMC12530322`, `pmid:40953549`, or `doi:10.1016/j.neunet.2025.108095`.",
"minLength": 1,
"type": "string"
},
"question": {
"minLength": 1,
"type": "string"
}
},
"required": [
"paperId",
"question"
],
"type": "object"
},
"name": "firecrawl_research_read_paper",
"outputSchema": null
},
{
"description": "Find citation-graph candidates from one to ten `seed_ids`; the first ID is the primary seed and later IDs are anchors. `mode` defaults to `similar` (co-citation/bibliographic coupling); `citers` returns papers citing a seed and `references` papers cited by a seed. `intent` ranks candidates.\n\nReturns ranked candidates and the evaluated pool size.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"intent": {
"minLength": 1,
"type": "string"
},
"k": {
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"mode": {
"enum": [
"similar",
"citers",
"references"
],
"type": "string"
},
"rerank": {
"description": "Apply an additional rerank over the fused candidates.",
"type": "boolean"
},
"seed_ids": {
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
}
},
"required": [
"seed_ids",
"intent"
],
"type": "object"
},
"name": "firecrawl_research_related_papers",
"outputSchema": null
},
{
"description": "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.\n\nSeveral distinct framings of the same question surface different papers than a single query does.\n\nReturns ranked papers with canonical IDs, titles, authors, and abstracts.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"authors": {
"description": "Author substring filter(s); ALL must match (case-insensitive).",
"items": {
"type": "string"
},
"type": "array"
},
"categories": {
"description": "Paper category filter(s) (e.g. `cs.LG`); ALL provided values must match.",
"items": {
"type": "string"
},
"type": "array"
},
"from": {
"description": "Inclusive lower bound on created/updated date (`YYYY-MM-DD`).",
"type": "string"
},
"k": {
"description": "Number of ranked papers to return (default 40).",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Natural-language research topic or question, including methods, systems, conditions, populations, interventions, or outcomes when relevant.",
"minLength": 1,
"type": "string"
},
"sort": {
"description": "`relevance` (default) or `date_desc`, which returns the newest of the most relevant matches, newest first by created date. It does not list every paper in a date range; add `from` (and `to`) for that.",
"enum": [
"relevance",
"date_desc"
],
"type": "string"
},
"to": {
"description": "Inclusive upper bound on created/updated date (`YYYY-MM-DD`).",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "firecrawl_research_search_papers",
"outputSchema": null
},
{
"description": "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: <id> for /library/skills/firecrawl/<id>, team:<slug> for /library/skills/team/<slug>); 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/<slug>; a taken slug is a conflict. With id (team:<slug>) 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"baseVersion": {
"description": "Update, required: the version: in the skill's SKILL.md. A skill changed since is refused with conflict: read it again and reapply.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"body": {
"description": "The instructions in full, in Markdown; required to create without from. Reference capabilities as @provider/capability.",
"maxLength": 200000,
"minLength": 1,
"pattern": "\\S",
"type": "string"
},
"description": {
"description": "When to use the skill; required to create without from.",
"maxLength": 5000,
"minLength": 1,
"type": "string"
},
"discoverable": {
"description": "Update: whether /library/skills/INDEX lists it.",
"type": "boolean"
},
"enabled": {
"description": "Update: turn the skill on or off.",
"type": "boolean"
},
"from": {
"description": "Create: the skill to copy, by id: <id> for /library/skills/firecrawl/<id>, team:<slug> for /library/skills/team/<slug>. Fields you also give override the copy.",
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"id": {
"description": "Update: the team:<slug> skill to change. Omit to create a skill.",
"maxLength": 100,
"pattern": "^team:[a-z0-9]+(?:-[a-z0-9]+)*$",
"type": "string"
},
"name": {
"description": "Skill name; required to create without from.",
"maxLength": 1000,
"minLength": 1,
"type": "string"
},
"slug": {
"description": "Create: lowercase words joined by hyphens; defaults to one made from the name.",
"maxLength": 64,
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"type": "string"
}
},
"type": "object"
},
"name": "firecrawl_save_skill",
"outputSchema": null
},
{
"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": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"conversationId": {
"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.",
"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}$",
"type": "string"
},
"domainTools": {
"description": "Include domain-matched Alexandria tools for the page in tools on the returned document.",
"type": "boolean"
},
"excludeTags": {
"items": {
"type": "string"
},
"type": "array"
},
"formats": {
"items": {
"enum": [
"markdown",
"html",
"rawHtml",
"screenshot",
"links",
"images",
"summary",
"changeTracking",
"branding",
"query",
"audio"
],
"type": "string"
},
"type": "array"
},
"includeTags": {
"items": {
"type": "string"
},
"type": "array"
},
"location": {
"additionalProperties": false,
"properties": {
"country": {
"type": "string"
},
"languages": {
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"lockdown": {
"type": "boolean"
},
"maxAge": {
"type": "number"
},
"mobile": {
"type": "boolean"
},
"objective": {
"description": "The user's underlying goal for this call, in one sentence: what they are ultimately trying to accomplish, not a restatement of the URL or query. Reuse it across related calls. Avoid sensitive information.",
"maxLength": 1000,
"minLength": 1,
"type": "string"
},
"onlyMainContent": {
"type": "boolean"
},
"parsers": {
"items": {
"enum": [
"pdf"
],
"type": "string"
},
"type": "array"
},
"pdfOptions": {
"additionalProperties": false,
"properties": {
"maxPages": {
"maximum": 10000,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"profile": {
"additionalProperties": false,
"description": "Loads a saved browser profile without saving changes to it.",
"properties": {
"name": {
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"proxy": {
"enum": [
"basic",
"stealth",
"enhanced",
"auto"
],
"type": "string"
},
"queryOptions": {
"additionalProperties": false,
"properties": {
"mode": {
"default": "freeform",
"enum": [
"directQuote",
"freeform"
],
"type": "string"
},
"prompt": {
"maxLength": 10000,
"type": "string"
}
},
"required": [
"prompt"
],
"type": "object"
},
"redactPII": {
"type": "boolean"
},
"removeBase64Images": {
"type": "boolean"
},
"screenshotOptions": {
"additionalProperties": false,
"properties": {
"fullPage": {
"type": "boolean"
},
"quality": {
"type": "number"
},
"viewport": {
"additionalProperties": false,
"properties": {
"height": {
"type": "number"
},
"width": {
"type": "number"
}
},
"required": [
"width",
"height"
],
"type": "object"
}
},
"type": "object"
},
"skipTlsVerification": {
"type": "boolean"
},
"storeInCache": {
"type": "boolean"
},
"timeout": {
"description": "Execution timeout in milliseconds.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"toolDetail": {
"description": "Domain discovery detail, summary by default; compact returns provider/capability/description, full includes contracts.",
"enum": [
"compact",
"summary",
"full"
],
"type": "string"
},
"url": {
"type": "string"
},
"waitFor": {
"type": "number"
},
"zeroDataRetention": {
"type": "boolean"
}
},
"required": [
"url",
"objective"
],
"type": "object"
},
"name": "firecrawl_scrape",
"outputSchema": null
},
{
"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": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"categories": {
"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`.",
"items": {
"enum": [
"research",
"pdf",
"developer",
"gov"
],
"type": "string"
},
"type": "array"
},
"conversationId": {
"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.",
"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}$",
"type": "string"
},
"domainTools": {
"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.",
"type": "boolean"
},
"enterprise": {
"items": {
"enum": [
"default",
"anon",
"zdr"
],
"type": "string"
},
"type": "array"
},
"excludeDomains": {
"description": "Hostnames to leave out of results. Mutually exclusive with includeDomains.",
"items": {
"maxLength": 253,
"minLength": 1,
"pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z0-9][a-z0-9-]{0,61}[a-z0-9]$",
"type": "string"
},
"type": "array"
},
"filter": {
"type": "string"
},
"highlights": {
"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.",
"type": "boolean"
},
"includeDomains": {
"description": "Hostnames to restrict results to. Mutually exclusive with excludeDomains.",
"items": {
"maxLength": 253,
"minLength": 1,
"pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z0-9][a-z0-9-]{0,61}[a-z0-9]$",
"type": "string"
},
"type": "array"
},
"limit": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"location": {
"type": "string"
},
"objective": {
"description": "The user's underlying goal for this call, in one sentence: what they are ultimately trying to accomplish, not a restatement of the URL or query. Reuse it across related calls. Avoid sensitive information.",
"maxLength": 5000,
"minLength": 1,
"type": "string"
},
"query": {
"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.",
"minLength": 1,
"type": "string"
},
"scrapeOptions": {
"additionalProperties": false,
"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.",
"properties": {
"excludeTags": {
"items": {
"type": "string"
},
"type": "array"
},
"formats": {
"items": {
"enum": [
"markdown",
"html",
"rawHtml",
"screenshot",
"links",
"images",
"summary",
"changeTracking",
"branding",
"json",
"query",
"audio"
],
"type": "string"
},
"type": "array"
},
"includeTags": {
"items": {
"type": "string"
},
"type": "array"
},
"jsonOptions": {
"additionalProperties": false,
"properties": {
"prompt": {
"type": "string"
},
"schema": {
"additionalProperties": true,
"propertyNames": {
"type": "string"
},
"type": "object"
}
},
"type": "object"
},
"location": {
"additionalProperties": false,
"properties": {
"country": {
"type": "string"
},
"languages": {
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"lockdown": {
"type": "boolean"
},
"maxAge": {
"type": "number"
},
"mobile": {
"type": "boolean"
},
"onlyMainContent": {
"type": "boolean"
},
"parsers": {
"items": {
"enum": [
"pdf"
],
"type": "string"
},
"type": "array"
},
"pdfOptions": {
"additionalProperties": false,
"properties": {
"maxPages": {
"maximum": 10000,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"profile": {
"additionalProperties": false,
"description": "Loads a saved browser profile without saving changes to it.",
"properties": {
"name": {
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"proxy": {
"enum": [
"basic",
"stealth",
"enhanced",
"auto"
],
"type": "string"
},
"queryOptions": {
"additionalProperties": false,
"properties": {
"mode": {
"default": "freeform",
"enum": [
"directQuote",
"freeform"
],
"type": "string"
},
"prompt": {
"maxLength": 10000,
"type": "string"
}
},
"required": [
"prompt"
],
"type": "object"
},
"redactPII": {
"type": "boolean"
},
"removeBase64Images": {
"type": "boolean"
},
"screenshotOptions": {
"additionalProperties": false,
"properties": {
"fullPage": {
"type": "boolean"
},
"quality": {
"type": "number"
},
"viewport": {
"additionalProperties": false,
"properties": {
"height": {
"type": "number"
},
"width": {
"type": "number"
}
},
"required": [
"width",
"height"
],
"type": "object"
}
},
"type": "object"
},
"skipTlsVerification": {
"type": "boolean"
},
"storeInCache": {
"type": "boolean"
},
"waitFor": {
"type": "number"
}
},
"type": "object"
},
"sources": {
"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.",
"items": {
"anyOf": [
{
"enum": [
"web",
"images",
"news",
"alexandria",
"exchange"
],
"type": "string"
},
{
"additionalProperties": false,
"properties": {
"type": {
"enum": [
"web",
"images",
"news",
"alexandria",
"exchange"
],
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
]
},
"type": "array"
},
"tbs": {
"type": "string"
},
"toolDetail": {
"description": "Compact by default. Compact returns only provider, capability and description; full includes contracts. Read a selected tool's contract with alexandria_library_search.",
"enum": [
"compact",
"summary",
"full"
],
"type": "string"
}
},
"required": [
"query",
"objective"
],
"type": "object"
},
"name": "firecrawl_search",
"outputSchema": null
},
{
"description": "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.\n\nEligibility 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.\n\nMark 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"conversationId": {
"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.",
"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}$",
"type": "string"
},
"missingContent": {
"description": "Array of specific pieces of content the agent expected to find but did not. One entry per distinct topic. Each entry has a short `topic` and optional longer `description`.",
"items": {
"properties": {
"description": {
"maxLength": 2000,
"type": "string"
},
"topic": {
"maxLength": 200,
"minLength": 1,
"type": "string"
}
},
"required": [
"topic"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"querySuggestions": {
"maxLength": 2000,
"type": "string"
},
"rating": {
"enum": [
"good",
"bad",
"partial"
],
"type": "string"
},
"searchId": {
"format": "uuid",
"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}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"valuableResults": {
"description": "Every result that was actually useful, copied from the `source` and `position` stamped on each result. Each group is numbered from 1 independently, so the source is required — `{\"source\":\"web\",\"position\":1}` and `{\"source\":\"news\",\"position\":1}` are different results. Be exhaustive — unlisted results are treated as not useful. Do not also list the same results in valuableSources.",
"items": {
"properties": {
"position": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"reason": {
"maxLength": 1000,
"type": "string"
},
"source": {
"enum": [
"web",
"images",
"news"
],
"type": "string"
}
},
"required": [
"source",
"position"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"valuableSources": {
"items": {
"properties": {
"reason": {
"maxLength": 1000,
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
}
},
"required": [
"searchId",
"rating"
],
"type": "object"
},
"name": "firecrawl_search_feedback",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "firecrawl_usage_dashboard",
"outputSchema": null
},
{
"description": "Find job postings and check whether a posting is still open. Use it to: find jobs by role and place (query, with location, remote or posted_within_days); read one posting by url and tell whether it is still open; check up to 10 posting urls in one call; list a company's open roles from its own job board (company, a name or domain; add query for one role there); and see who is hiring for a role (query with group_by \"employer\"). Every row has the same normalized fields: title, company, location, remote, posted_at as the board states it, url, source, a status, and checked_at, the time Firecrawl read it. status is open when the posting was read from the employer's board or live posting page in this call, and unverified when it comes from a job site and was not confirmed on the employer's board. A posting checked by url can also be closed, not_found or error. A single url returns the full description; list rows carry it with include_description. A company search names the boards it read and what each covers; when no board is found, rows come from job sites and notes says so. boards_only searches employers' own boards only. Each provider read is charged its listed price; max_credits caps the call. Example: {\"query\":\"data engineer\",\"location\":\"Berlin\",\"posted_within_days\":14}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"boards_only": {
"description": "true searches employers' own job boards only; every row is confirmed open on its board.",
"type": "boolean"
},
"company": {
"description": "Company name or domain, e.g. \"example.com\". Lists that company's open roles from its own job board.",
"type": "string"
},
"cursor": {
"description": "next_cursor from an earlier call with the same input, for more rows.",
"type": "string"
},
"group_by": {
"description": "\"employer\" groups the postings found by employer, to see who is hiring for a role.",
"enum": [
"employer"
],
"type": "string"
},
"include_description": {
"description": "true adds the description to each list row. A single url always returns it.",
"type": "boolean"
},
"limit": {
"description": "Rows wanted from a search by query or company, 1 to 100, default 10. Leave it out with url or urls.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"location": {
"description": "City, region or country, e.g. \"Berlin\" or \"Canada\".",
"type": "string"
},
"max_credits": {
"description": "Most credits the call may spend. Set it only to a budget the user gave; left out, it is 200. A provider that could pass it is not started.",
"maximum": 10000,
"minimum": 0,
"type": "integer"
},
"objective": {
"description": "The user's underlying goal for this call, in one sentence: what they are ultimately trying to accomplish, not a restatement of the URL or query. Reuse it across related calls. Avoid sensitive information.",
"maxLength": 1000,
"minLength": 1,
"type": "string"
},
"posted_within_days": {
"description": "Only postings the board dates within this many days, 1 to 365.",
"maximum": 365,
"minimum": 1,
"type": "integer"
},
"provider": {
"description": "Ask only this provider, e.g. \"indeed\". Leave it out to let Firecrawl choose.",
"type": "string"
},
"query": {
"description": "Job title or keywords, e.g. \"data engineer\". With company, the role to look for there.",
"maxLength": 300,
"type": "string"
},
"remote": {
"description": "true returns remote roles only.",
"type": "boolean"
},
"url": {
"description": "One posting URL to read in full and check: whether it is still open, with its description.",
"type": "string"
},
"urls": {
"description": "Up to 10 posting URLs to check in one call; each comes back with its status.",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
}
},
"required": [
"objective"
],
"type": "object"
},
"name": "jobs_search",
"outputSchema": null
},
{
"description": "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. One call runs the provider waterfall. Use it, not people_company_search, whenever you have a name with a company or domain, a LinkedIn URL or an email. 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 by default: Firecrawl tries the providers that can use your inputs one at a time, ordered by listed price, and stops as soon as 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 in the same call. Ask for mobile only when the task needs a phone number; it is the costliest field and nothing is spent on it otherwise. A work email is on the company domain when one is known and never on a known free-mail domain or a known role mailbox; fields says for each answer which provider gave it, whether the email was verified and whether its domain matched. Set verified_only to get 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 the call is uncapped. To call one specific provider, use alexandria_library_read instead. Example: {\"contact_fields\":[\"work_email\"],\"people\":[{\"name\":\"Jane Doe\",\"domain\":\"example.com\"}]}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"companies": {
"description": "Companies to enrich, for firmographics.",
"items": {
"additionalProperties": false,
"anyOf": [
{
"properties": {
"domain": {
"pattern": "\\S"
}
},
"required": [
"domain"
]
},
{
"properties": {
"linkedin_url": {
"pattern": "\\S"
}
},
"required": [
"linkedin_url"
]
},
{
"properties": {
"name": {
"pattern": "\\S"
}
},
"required": [
"name"
]
}
],
"properties": {
"domain": {
"description": "e.g. example.com.",
"type": "string"
},
"linkedin_url": {
"description": "LinkedIn company URL.",
"type": "string"
},
"name": {
"description": "Company name.",
"type": "string"
}
},
"type": "object"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
},
"contact_fields": {
"description": "People only. Find these contact values for each person; companies in the same call still get firmographics. Include mobile only when a phone number is needed: phone lookups are the costliest and run, and bill, only when mobile is listed.",
"items": {
"enum": [
"work_email",
"personal_email",
"mobile"
],
"type": "string"
},
"minItems": 1,
"type": "array"
},
"max_credits": {
"description": "Most credits the whole call may spend. Set it only to a budget the user gave; left out, the call has no cap. A provider is tried only while its listed price still fits, so 0 runs nothing paid.",
"maximum": 10000,
"minimum": 0,
"type": "integer"
},
"objective": {
"description": "The user's underlying goal for this call, in one sentence: what they are ultimately trying to accomplish, not a restatement of the URL or query. Reuse it across related calls. Avoid sensitive information.",
"maxLength": 1000,
"minLength": 1,
"type": "string"
},
"people": {
"description": "People to enrich. People and companies together are at most 10 per call.",
"items": {
"additionalProperties": false,
"anyOf": [
{
"properties": {
"linkedin_url": {
"pattern": "\\S"
}
},
"required": [
"linkedin_url"
]
},
{
"properties": {
"email": {
"pattern": "\\S"
}
},
"required": [
"email"
]
},
{
"properties": {
"phone": {
"pattern": "\\S"
}
},
"required": [
"phone"
]
},
{
"properties": {
"company": {
"pattern": "\\S"
},
"name": {
"pattern": "\\S"
}
},
"required": [
"name",
"company"
]
},
{
"properties": {
"domain": {
"pattern": "\\S"
},
"name": {
"pattern": "\\S"
}
},
"required": [
"name",
"domain"
]
},
{
"properties": {
"company": {
"pattern": "\\S"
},
"first_name": {
"pattern": "\\S"
},
"last_name": {
"pattern": "\\S"
}
},
"required": [
"first_name",
"last_name",
"company"
]
},
{
"properties": {
"domain": {
"pattern": "\\S"
},
"first_name": {
"pattern": "\\S"
},
"last_name": {
"pattern": "\\S"
}
},
"required": [
"first_name",
"last_name",
"domain"
]
}
],
"properties": {
"company": {
"description": "Employer name or domain.",
"type": "string"
},
"domain": {
"description": "Employer domain, e.g. example.com.",
"type": "string"
},
"email": {
"description": "Any email known for the person.",
"type": "string"
},
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"linkedin_url": {
"description": "LinkedIn profile URL.",
"type": "string"
},
"name": {
"description": "Full name.",
"type": "string"
},
"phone": {
"description": "Any phone number known for the person.",
"type": "string"
}
},
"type": "object"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
},
"profile": {
"description": "With contact_fields, also return each person's profile in the same call, looked up first so the contact lookups can use it. Default true; false skips it.",
"type": "boolean"
},
"verified_only": {
"description": "Email fields: return only an address the provider verified as deliverable. Default false returns the best address found, with fields.<field>.verified saying whether it was verified.",
"type": "boolean"
}
},
"required": [
"objective"
],
"type": "object"
},
"name": "people_company_enrich",
"outputSchema": null
},
{
"description": "Find people or companies you don't know yet, by filters. Not for someone you can already name: for a named person (with their company or domain, a LinkedIn URL or an email) or a named company, call people_company_enrich instead; a request naming one person is refused and pointed there. Set entity to \"person\" or \"company\" and give filters: people by title, seniority, function, employer and location; companies by industry, headcount, location, technology, keywords or founding year. Firecrawl asks its search providers one at a time, cheapest first, and only those that apply every filter given. When none does, it searches companies first and then people at those companies; a request no provider or chain covers is refused naming the filter to drop. With company_domains the search stops at the first provider that finds anyone; otherwise it fills limit across up to three providers. Rows carry name, title, company, location and LinkedIn URL, never emails or phones: use people_company_enrich for contact details. Each provider call is charged its listed price; max_credits caps the call. Example: {\"entity\":\"person\",\"filters\":{\"titles\":[\"Head of Data\"],\"company_domains\":[\"example.com\"]},\"limit\":10}.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"count_only": {
"description": "Return only how many records match, without rows.",
"type": "boolean"
},
"cursor": {
"description": "next_cursor from an earlier call with the same entity, filters and query, for more rows.",
"type": "string"
},
"entity": {
"description": "Required. Exactly \"person\" (find people) or \"company\" (find companies).",
"enum": [
"person",
"company"
],
"type": "string"
},
"filters": {
"additionalProperties": false,
"description": "For people, company filters describe the employer. Every filter given is applied: a provider that cannot apply one never runs.",
"properties": {
"company_domains": {
"description": "Companies by domain, e.g. [\"example.com\"]. For people, their employer; with it the search stops at the first provider that finds anyone.",
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 25,
"minItems": 1,
"type": "array"
},
"founded_year": {
"additionalProperties": false,
"description": "e.g. {\"min\": 2018}.",
"properties": {
"max": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"min": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"functions": {
"description": "People only. Job functions; rows whose title names another function are dropped.",
"items": {
"enum": [
"engineering",
"sales",
"marketing",
"finance",
"human_resources",
"operations",
"product",
"design",
"legal",
"information_technology",
"customer_success",
"data",
"research",
"education",
"healthcare",
"consulting"
],
"type": "string"
},
"minItems": 1,
"type": "array"
},
"headcount": {
"additionalProperties": false,
"description": "Employee count, e.g. {\"min\": 51, \"max\": 200}.",
"properties": {
"max": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"min": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"industries": {
"description": "LinkedIn's current industry names, e.g. Software Development.",
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 25,
"minItems": 1,
"type": "array"
},
"keywords": {
"description": "Words describing the company, e.g. [\"web scraping\"].",
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 25,
"minItems": 1,
"type": "array"
},
"locations": {
"description": "Countries (\"Germany\", \"US\") or cities (\"Berlin\"). Country names are applied by the most providers.",
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 25,
"minItems": 1,
"type": "array"
},
"seniority": {
"description": "People only. Rows whose title names another level are dropped; SVP, EVP and AVP meet vp.",
"items": {
"enum": [
"owner",
"founder",
"c_suite",
"partner",
"vp",
"head",
"director",
"manager",
"senior",
"entry",
"intern"
],
"type": "string"
},
"minItems": 1,
"type": "array"
},
"technologies": {
"description": "Technologies the company uses, e.g. [\"Snowflake\"].",
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 25,
"minItems": 1,
"type": "array"
},
"titles": {
"description": "People only. Current job titles, e.g. [\"Head of Data\"]; rows whose title does not match, or is held in the past, are dropped.",
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 25,
"minItems": 1,
"type": "array"
}
},
"type": "object"
},
"limit": {
"description": "Rows wanted, 1 to 100, default 10.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"max_credits": {
"description": "Most credits the call may spend. Set it only to a budget the user gave; left out, it is 1000. A provider that could pass it is not started.",
"maximum": 10000,
"minimum": 0,
"type": "integer"
},
"objective": {
"description": "The user's underlying goal for this call, in one sentence: what they are ultimately trying to accomplish, not a restatement of the URL or query. Reuse it across related calls. Avoid sensitive information.",
"maxLength": 1000,
"minLength": 1,
"type": "string"
},
"options": {
"additionalProperties": true,
"description": "With provider: that provider's own search options, sent as given instead of filters.",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"provider": {
"description": "Ask only this provider, e.g. \"prospeo\". Leave it out to let the waterfall choose.",
"type": "string"
},
"query": {
"description": "Free text, applied only by providers that take it. Prefer filters.",
"maxLength": 500,
"type": "string"
}
},
"required": [
"entity",
"objective"
],
"type": "object"
},
"name": "people_company_search",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:7522db041b8264d44f501e22f76cf50481e7117f672601a8bd36cfad42a0c689 | sha256sum