Connect Firecrawl to Claude Code
Extract clean, LLM-ready content from a web page. Add Toolspoke to Claude Code once and it can use 8 Firecrawl actions. Your Firecrawl credential stays in Toolspoke, and you choose which actions Claude Code may call.
Set it up in Claude Code
Three steps, the first one once for every toolkit you will ever add.
Add Toolspoke to Claude Code
Run it in your project, then /mcp to sign in
claude mcp add --transport http toolspoke https://toolspoke.com/mcpThe sign-in opens in your browser, and Toolspoke asks you to approve it.
Install Firecrawl and connect it
Add Firecrawl to a project in your Toolspoke workspace.
API key. You provide it once, when you install the connector. Toolspoke encrypts it at rest and decrypts it only for the length of a single call, and the gateway attaches it to the outbound request itself, so it is never part of the arguments an agent sends.
- API key
- firecrawl.dev → Dashboard → API Keys
Choose what Claude Code may do
All 8 actions start on. Switch off any of the 3 actions that change something in Firecrawl, and Claude Code gets a refusal if it tries.
What you can ask Claude Code for
A few of the Firecrawl actions that only read, so they are safe to try first.
- Scrape one URL and return clean, LLM-ready content
- Discover the URLs on a site in a single fast call, without scraping their content
- Run a web search and optionally scrape the results in the same call
- Check a crawl started by `crawl` and read the pages scraped so far
What Claude Code can do in Firecrawl
5 actions read and 3 write.
Reads
Scrape
Scrape one URL and return clean, LLM-ready content. The default markdown format is what you want for reading a page; add "links", "html", "summary", or "screenshot" when you need them. Use map or crawl instead when you need more than one page.
Map
Discover the URLs on a site in a single fast call, without scraping their content. Use this first to decide what is worth scraping, or to check whether a site has the pages you expect. Pass `search` to rank the results by relevance.
Search
Run a web search and optionally scrape the results in the same call. Use this when you need current information but do not already know which URLs to read. Set scrapeOptions to get page content back with each hit.
Crawl status
Check a crawl started by `crawl` and read the pages scraped so far. `status` is scraping, completed, or failed, poll every few seconds while it is scraping. Page content is trimmed: only `limit` pages come back, each cut to max_chars.
Extract status
Check an extraction started by `extract` and read its result. `status` is processing, completed, failed, or cancelled; the structured data arrives under `data` once it is completed.
Writes
Crawl
Start an asynchronous crawl of a whole site or section. Returns a job id immediately, poll crawl_status with it, do not expect content here. Crawls bill one credit per page, so keep `limit` tight; it defaults to 25 rather than Firecrawl's 10000.
Cancel crawl
Stop a running crawl started by `crawl`, so it stops consuming credits. Pages already scraped stay readable through crawl_status until the job expires; this does not delete anything else.
Extract
Start an asynchronous job that pulls structured data matching a JSON schema out of one or more pages. Returns a job id, poll extract_status with it. Use this instead of scrape when you want fields, not prose; a wildcard URL such as https://example.com/* extracts across a whole site.
Firecrawl in Claude Code: questions
Does Claude Code see my Firecrawl credential?
No. The credential is stored encrypted in Toolspoke, and the gateway adds it to each call. Claude Code only ever talks to Toolspoke, and the dashboard shows the last four characters of the credential and nothing more.
Can I stop Claude Code from changing things in Firecrawl?
Yes. Each of the 8 actions can be switched off for a project. Turn off the 3 that change something and Claude Code can only read.
Will 8 actions crowd Claude Code's context?
No. Toolspoke shows Claude Code five bridge tools, plus a guide where a toolkit has one, and Claude Code searches for the Firecrawl action it needs when it needs it. Adding more toolkits does not add more tools to its list.
Can I add it once for every project?
Yes. Add --scope user to the command and Claude Code keeps Toolspoke in every project on this machine. Without it, the server is added to the project you ran the command in.
What does it cost?
Tool calls are free on every plan, and a Firecrawl call does not run in a sandbox, so it bills nothing.
Firecrawl in your other apps
Try Firecrawl in Claude Code
Free to start, and tool calls cost nothing on any plan.