# extension_network

> Stub a network response on a Chromium session: add a rule, list or clear the rules, or read which requests hit one or missed.

Canonical: https://docs.extension.dev/tools/mcp/network
This page as Markdown: https://docs.extension.dev/tools/mcp/network.md
Section: MCP tool reference
Siblings: [extension_add_feature](https://docs.extension.dev/tools/mcp/add-feature.md) · [extension_analyze](https://docs.extension.dev/tools/mcp/analyze.md) · [extension_approvals](https://docs.extension.dev/tools/mcp/approvals.md) · [extension_assert](https://docs.extension.dev/tools/mcp/assert.md) · [extension_auth](https://docs.extension.dev/tools/mcp/auth.md) · [extension_browsers](https://docs.extension.dev/tools/mcp/browsers.md) · [extension_build](https://docs.extension.dev/tools/mcp/build.md) · [extension_builds](https://docs.extension.dev/tools/mcp/builds.md) · [extension_builds_act](https://docs.extension.dev/tools/mcp/builds-act.md) · [extension_create](https://docs.extension.dev/tools/mcp/create.md) · [extension_dev](https://docs.extension.dev/tools/mcp/dev.md) · [extension_docs_search](https://docs.extension.dev/tools/mcp/docs-search.md) · [extension_doctor](https://docs.extension.dev/tools/mcp/doctor.md) · [extension_dom_snapshot](https://docs.extension.dev/tools/mcp/dom-snapshot.md) · [extension_element](https://docs.extension.dev/tools/mcp/element.md) · [extension_eval](https://docs.extension.dev/tools/mcp/eval.md) · [extension_inspect](https://docs.extension.dev/tools/mcp/inspect.md) · [extension_list_extensions](https://docs.extension.dev/tools/mcp/list-extensions.md) · [extension_logs](https://docs.extension.dev/tools/mcp/logs.md) · [extension_manifest_validate](https://docs.extension.dev/tools/mcp/manifest-validate.md) · [extension_open](https://docs.extension.dev/tools/mcp/open.md) · [extension_preview_web](https://docs.extension.dev/tools/mcp/preview-web.md) · [extension_project_create](https://docs.extension.dev/tools/mcp/project-create.md) · [extension_publish](https://docs.extension.dev/tools/mcp/publish.md) · [extension_release_promote](https://docs.extension.dev/tools/mcp/release-promote.md) · [extension_release_status](https://docs.extension.dev/tools/mcp/release-status.md) · [extension_reload](https://docs.extension.dev/tools/mcp/reload.md) · [extension_screenshot](https://docs.extension.dev/tools/mcp/screenshot.md) · [extension_shares](https://docs.extension.dev/tools/mcp/shares.md) · [extension_start](https://docs.extension.dev/tools/mcp/start.md) · [extension_stop](https://docs.extension.dev/tools/mcp/stop.md) · [extension_storage](https://docs.extension.dev/tools/mcp/storage.md) · [extension_submit](https://docs.extension.dev/tools/mcp/submit.md) · [extension_submit_check](https://docs.extension.dev/tools/mcp/submit-check.md) · [extension_templates](https://docs.extension.dev/tools/mcp/templates.md) · [extension_theme_verify](https://docs.extension.dev/tools/mcp/theme-verify.md) · [extension_try](https://docs.extension.dev/tools/mcp/try.md) · [extension_wait](https://docs.extension.dev/tools/mcp/wait.md) · [extension_workspace](https://docs.extension.dev/tools/mcp/workspace.md) · [extension_workspace_create](https://docs.extension.dev/tools/mcp/workspace-create.md) · [Install in your client](https://docs.extension.dev/tools/mcp/clients.md)
Map of every page: https://docs.extension.dev/llms.txt · Whole corpus: https://docs.extension.dev/llms-full.txt

---

# `extension_network`

Stub a network response on a Chromium session: add a rule, list or clear the rules, or read which requests hit one or missed.

## Quick start

> Make the API answer 500 and show me what the popup renders


## How the agent uses it

Rules last until extension_stop. Firefox is refused.

## Page text in the answer

Part of this tool's answer is text a web page or the extension wrote. The server fences it between `<untrusted-data-ID>` and `</untrusted-data-ID>` with a fresh random `ID` per call, named in `untrusted.boundary`. A fence is a signal to the model, not a gate: pair it with `--no-ship` when the agent reads pages you do not trust. See [Server flags and telemetry](/tools/mcp/flags).

## Reference

| | |
| --- | --- |
| Group | extras, off unless named: on with `--features=local,platform,extras` or `--features=local,extras` |
| Tier | Test |
| Needs | the server started with extras in --features, as in --features=local,platform,extras; a live dev or start session on a Chromium browser |
| Read only | no |
| Destructive | no |
| Idempotent | no |
| Reaches the open web | no |

### Inputs

| Input | Type | Required | Default | What it does |
| --- | --- | --- | --- | --- |
| `projectPath` | string | yes |  | Project root of a running session: extension_dev, extension_start, or `npx extension dev\|start` by hand |
| `action` | "add" \| "list" \| "clear" \| "requests" | yes |  | requests: the requests seen. |
| `method` | string | no |  | add: HTTP method; default ANY. |
| `url` | string | no |  | add: exact URL, or a glob with * and ?. |
| `status` | number | no | `200` | add: HTTP status to answer. |
| `body` | string | no |  | add: response text. |
| `json` | any | no |  | add: response as a JSON value; not with body. |
| `contentType` | string | no |  | add: Content-Type; default by body or json. |
| `browser` | string | no |  | Session browser; required when several run. |

## When it fails

- **The call is refused because no session is live.** Start one with [`extension_dev`](/tools/mcp/dev) or [`extension_start`](/tools/mcp/start) and call again.
- **The tool is missing from the client's list, or the call answers `E_TOOL_DISABLED`.** The `extras` group is off unless named. Start the server with `--features=local,platform,extras`, or `--features=local,extras` without the platform tools; see [Server flags and telemetry](/tools/mcp/flags).

## Next

- [MCP server](/tools/mcp): install, the three groups and the session gates
- [Install in your client](/tools/mcp/clients)
- [`extension_assert`](/tools/mcp/assert): Run a test stage on an extension_dev or extension_start session: pass, fail, not ready (a precondition) or inconclusive per expectation.
