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

# context gsc import

> Import an existing-agent handoff snapshot (JSON lines or a Markdown table) in the gsc.jsonl row shape, instead of granting anything.

`context_gsc_import`

Import an existing-agent handoff snapshot (JSON lines or a Markdown table) in the gsc.jsonl row shape, instead of granting anything. The connector stays named in retrieved\_by and is never re-labeled as fetched by us; its capture date stays captured\_at, separate from any later fetch of ours; rows missing window, aggregationType or retrieved\_by are refused per file with what is missing; a connector row whose key matches a row we fetched is refused ,  ours is kept. A handoff and a grant may coexist, rows kept distinct by retrieved\_by.

<Note>Repository-local stdio MCP only. This tool is absent from hosted MCP and HTTP. It can write local context files or fetch bounded public context.</Note>

## Setup and request

Start the [local context host](/guides/local-context) with an explicit repository root. Paths are restricted to that root, including symlink resolution.

```json theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "context_gsc_import",
    "arguments": {
      "file": "context-handoff.jsonl"
    }
  }
}
```

## Input fields

| Field  | Type   | Presence | Meaning and constraints                                                                               |
| ------ | ------ | -------- | ----------------------------------------------------------------------------------------------------- |
| `file` | string | Required | The file value; allowed values and bounds are specified in this schema. minLength: 1; maxLength: 4096 |

## Returned result

Captured from a local fixture repository without external credentials.

```json theme={null}
{
  "accepted": 1,
  "refused": [],
  "connectors": [
    "customer-connector"
  ]
}
```

| Field              | Type    | Presence | Meaning and constraints                                              |
| ------------------ | ------- | -------- | -------------------------------------------------------------------- |
| `accepted`         | integer | Required | Rows appended from this file. minimum: 0                             |
| `refused`          | array   | Required | Every refusal is retained.                                           |
| `refused[].row`    | integer | Optional | One-based input row when applicable. minimum: 0                      |
| `refused[].reason` | string  | Required | Parse, missing-field or ownership refusal.                           |
| `connectors`       | array   | Optional | Saved connector identities after successful parsing.                 |
| `error`            | string  | Optional | Missing-file or parse diagnostic; the local MCP result sets isError. |

Parse errors set isError; per-row refusals can coexist with accepted rows. Connector names and capture dates retain their original provenance.

[Download result schema](/schemas/context_gsc_import.output.json).

## Result and recovery

The host returns JSON in both `structuredContent` and text content. The [local context reference](/reference/context/results) describes each result, file ownership and recovery. Start/end dates must be supplied together. Thrown input or file failures return `isError: true`. Missing manual/profile files and unresolved citations also flag an error. Inspect returned connection states separately: revoked or unavailable access can be result data. Manual-only configuration is valid.

See [local context](/guides/local-context), [CLI context commands](/reference/local/index) and [schema conventions](/reference/schemas).