# replace_range

Replaces the content in [start_index, end_index) with new text — one atomic batchUpdate that deletes the range and inserts at its start, so nothing is lost if either step would fail. Get fresh indexes from read_document_text first: indexes are stale after ANY previous edit. The new text takes the style at start_index. Cannot cut across a table cell boundary or delete a paragraph's final newline together with only part of the next paragraph — the API rejects such ranges. An empty replacement is allowed and equals delete_range.

Agent View of the PolicyLayer registry record for `replace_range`. HTML page: https://policylayer.com/tools/a1-x-tech-mcp-google-docs/replace-range

## Facts

- Tool: `replace_range`
- Server: Mcp Google Docs (`@a1-x-tech/mcp-google-docs`) — https://policylayer.com/tools/a1-x-tech-mcp-google-docs.md
- Install: `npx -y @a1-x-tech/mcp-google-docs`
- Homepage: https://github.com/A1-x-Tech/mcp-google-docs
- Risk category: Write (Medium risk)
- Registry record: grade F, identity unverified
- Server rate-limited: no
- Parameters: 6 (4 required)
- Recommended policy verdict: Rate-limited

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `text` | string | yes | The replacement text; empty string just deletes the range. |
| `tab_id` | string | no | Tab to target (from list_tabs). Omit for the first/only tab. |
| `end_index` | integer | yes | End of the range to replace (exclusive). |
| `segment_id` | string | no | Header/footer/footnote segment id (from get_document). Omit for the document body. |
| `document_id` | string | yes | The document id — the long id from the document URL (docs.google.com/document/d/<documentId>/edit) or from create_document output. |
| `start_index` | integer | yes | Start of the range to replace (inclusive). |

Parameters from the server's own tool schema.

## Example call (MCP tools/call, JSON-RPC 2.0)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "replace_range",
    "arguments": {
      "text": "<text>",
      "end_index": 0,
      "document_id": "<document_id>",
      "start_index": 0
    }
  }
}
```

## Why replace_range is rated Medium

An AI agent can call replace_range faster than any human can review: one bad instruction and it creates or modifies resources in Mcp Google Docs by the hundred, each call as confident as the last.

## Use case

AI agents use replace_range to create or update resources in Mcp Google Docs, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Mcp Google Docs environment.

## Recommended policy (PolicyLayer)

Verdict: **Rate-limited**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches Mcp Google Docs:

```json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "replace_range": {
      "limits": [
        {
          "counter": "replace_range_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}
```

## Other tools on Mcp Google Docs (26)

- `delete_range` — Destructive — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/delete-range.md
- `logout` — Destructive — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/logout.md
- `manage_comment` — Destructive — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/manage-comment.md
- `start_login` — Execute — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/start-login.md
- `style_paragraph` — Execute — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/style-paragraph.md
- `auth_status` — Read — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/auth-status.md
- `get_document` — Read — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/get-document.md
- `list_comments` — Read — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/list-comments.md
- `list_tabs` — Read — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/list-tabs.md
- `raw_request` — Read — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/raw-request.md
- `read_document_text` — Read — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/read-document-text.md
- `style_text` — Read — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/style-text.md
- `create_document` — Write — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/create-document.md
- `edit_table` — Write — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/edit-table.md
- `export_document` — Write — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/export-document.md
- `finish_login` — Write — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/finish-login.md
- `import_markdown` — Write — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/import-markdown.md
- `insert_break` — Write — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/insert-break.md
- `insert_image` — Write — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/insert-image.md
- `insert_table` — Write — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/insert-table.md
- `insert_text` — Write — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/insert-text.md
- `replace_all_text` — Write — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/replace-all-text.md
- `replace_image` — Write — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/replace-image.md
- `set_client` — Write — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/set-client.md
- `set_paragraph_bullets` — Write — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/set-paragraph-bullets.md
- `setup_instructions` — Write — https://policylayer.com/tools/a1-x-tech-mcp-google-docs/setup-instructions.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=a1-x-tech-mcp-google-docs · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/a1-x-tech-mcp-google-docs