> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Web Search & Scrape in Goose

> Add Firecrawl web search and scraping to Goose

Connect Firecrawl to Goose as a remote extension, so Goose can search the web and read pages through the hosted MCP server.

## Requirements

* Goose 1.55 or newer.
* A [Firecrawl API key](https://www.firecrawl.dev/app/api-keys), exported as `FIRECRAWL_API_KEY`.

## Quick setup

1. Export your API key in the shell you start Goose from:

```bash theme={null}
export FIRECRAWL_API_KEY="fc-YOUR-API-KEY"
```

2. Add the extension to the `extensions` section of `~/.config/goose/config.yaml`:

```yaml theme={null}
extensions:
  firecrawl:
    type: streamable_http
    name: firecrawl
    enabled: true
    uri: https://mcp.firecrawl.dev/v2/mcp
    headers:
      Authorization: "Bearer $FIRECRAWL_API_KEY"
    env_keys:
      - FIRECRAWL_API_KEY
    timeout: 300
```

3. Start a session and ask Goose to search or scrape:

```bash theme={null}
goose session
```

> [!WARNING]
>
> Write the header as `$FIRECRAWL_API_KEY` with no braces, and keep `env_keys` in place. Goose sends `${FIRECRAWL_API_KEY}` as literal text, and the server then rejects the request.

See [Configure an API key](https://docs.firecrawl.dev/mcp-server/keyless.md#add-an-api-key) for more on keys.

## Try it

```text theme={null}
Search the web for the latest Rust release notes and summarize the sources.
```

```text theme={null}
Scrape https://firecrawl.dev and explain what it does.
```

## What you can do

> [card] [Search](https://docs.firecrawl.dev/features/search.md)
>
> Find current information and read the content of relevant results.

> [card] [Scrape](https://docs.firecrawl.dev/features/scrape.md)
>
> Turn URLs into clean markdown or structured data.

> [card] [Interact](https://docs.firecrawl.dev/features/interact.md)
>
> Navigate, click, and fill forms to reach the data you need.

> [card] [Alexandria](https://docs.firecrawl.dev/features/alexandria.md)
>
> Discover structured data tools, inspect inputs and pricing, then run them through Firecrawl.

## Troubleshooting

* **The key is reported invalid or revoked:** check that the header uses `$FIRECRAWL_API_KEY` without braces and that `FIRECRAWL_API_KEY` is exported in the shell that starts Goose.
* **The extension is missing:** run `goose session` again after saving the file, and confirm `enabled: true`.
* **Calls time out:** raise `timeout`. Scraping a large page can take longer than the default.
* **Tools are not used:** some models call MCP tools more reliably than others. Try a different model.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.