---
title: "WebFetchServerToolConfig"
---

Configuration for the openrouter:web_fetch server tool


## Fields

| Field                                                                                                                                                                                                                                                                                                             | Type                                                                                                                                                                                                                                                                                                              | Required                                                                                                                                                                                                                                                                                                          | Description                                                                                                                                                                                                                                                                                                       | Example                                                                                                                                                                                                                                                                                                           |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `allowed_domains`                                                                                                                                                                                                                                                                                                 | List[*str*]                                                                                                                                                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                | Only fetch from these domains.                                                                                                                                                                                                                                                                                    |                                                                                                                                                                                                                                                                                                                   |
| `blocked_domains`                                                                                                                                                                                                                                                                                                 | List[*str*]                                                                                                                                                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                | Never fetch from these domains.                                                                                                                                                                                                                                                                                   |                                                                                                                                                                                                                                                                                                                   |
| `engine`                                                                                                                                                                                                                                                                                                          | [Optional[components.WebFetchEngineEnum]](../components/webfetchengineenum.mdx)                                                                                                                                                                                                                                    | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                | Which fetch engine to use. "auto" (default) uses native if the provider supports it, otherwise Exa. "native" forces the provider's built-in fetch. "exa" uses Exa Contents API. "openrouter" uses direct HTTP fetch. "firecrawl" uses Firecrawl scrape (requires BYOK). "parallel" uses the Parallel extract API. | auto                                                                                                                                                                                                                                                                                                              |
| `max_content_tokens`                                                                                                                                                                                                                                                                                              | *Optional[int]*                                                                                                                                                                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                | Maximum content length in approximate tokens. Content exceeding this limit is truncated.                                                                                                                                                                                                                          | 100000                                                                                                                                                                                                                                                                                                            |
| `max_uses`                                                                                                                                                                                                                                                                                                        | *Optional[int]*                                                                                                                                                                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                | Maximum number of web fetches per request. Once exceeded, the tool returns an error.                                                                                                                                                                                                                              | 10                                                                                                                                                                                                                                                                                                                |