> ## 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 focus

> Choose focus pages from manual targets first, then GSC clicks.

`context_focus`

Choose focus pages from manual targets first, then GSC clicks. Keep manual judgments and search observations in separate fields. Supply both start and end to select one date range, or omit both for the recent 28-day range.

<Note>Repository-local stdio MCP only. This tool is absent from hosted MCP and HTTP. It reads local context without starting a cloud job.</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_focus",
    "arguments": {}
  }
}
```

## Input fields

| Field   | Type   | Presence | Meaning and constraints                                                                               |
| ------- | ------ | -------- | ----------------------------------------------------------------------------------------------------- |
| `start` | string | Optional | The start value; allowed values and bounds are specified in this schema. minLength: 10; maxLength: 10 |
| `end`   | string | Optional | The end value; allowed values and bounds are specified in this schema. minLength: 10; maxLength: 10   |

## Returned result

Captured from a local fixture repository without external credentials.

```json theme={null}
{
  "pages": [
    {
      "page": "https://example.com/guide",
      "nominated_by": [
        "manual"
      ],
      "observation": null,
      "inference": null,
      "recommendation": null
    }
  ],
  "basis": {
    "manual": 1,
    "gsc": "no_rows"
  },
  "window": {
    "start": "2026-08-01",
    "end": "2026-08-28",
    "days": 28
  }
}
```

| Field                                  | Type          | Presence | Meaning and constraints                                                  |
| -------------------------------------- | ------------- | -------- | ------------------------------------------------------------------------ |
| `pages`                                | array         | Required | At most ten selected pages, manual nominations first.                    |
| `pages[].page`                         | string        | Required | Nominated page URL.                                                      |
| `pages[].nominated_by`                 | array         | Required | manual or gsc\_clicks nomination sources.                                |
| `pages[].observation`                  | object / null | Required | Saved observation attached to a nomination.                              |
| `pages[].observation.window`           | object        | Required | Selected date window. additional fields rejected                         |
| `pages[].observation.window.start`     | string        | Required | Calendar date in YYYY-MM-DD form.                                        |
| `pages[].observation.window.end`       | string        | Required | Calendar date in YYYY-MM-DD form.                                        |
| `pages[].observation.window.days`      | integer       | Optional | Inclusive day count. minimum: 0                                          |
| `pages[].observation.clicks`           | number / null | Required | Observed or derived metric; null means no observed value.                |
| `pages[].observation.impressions`      | number / null | Required | Observed or derived metric; null means no observed value.                |
| `pages[].observation.ctr`              | number / null | Required | Observed or derived metric; null means no observed value.                |
| `pages[].observation.average_position` | number / null | Required | Observed or derived metric; null means no observed value.                |
| `pages[].observation.truncated`        | boolean       | Required | Observation came from bounded top rows.                                  |
| `pages[].inference`                    | null          | Required | Reserved for separately authored judgment; always null here.             |
| `pages[].recommendation`               | null          | Required | Recommendations belong to campaign briefs; always null here.             |
| `basis`                                | object        | Required | Selection basis. additional fields rejected                              |
| `basis.manual`                         | integer       | Required | Number of declared manual targets before selection. minimum: 0           |
| `basis.gsc`                            | string        | Required | Whether the repository has GSC rows. values: "rows\_present", "no\_rows" |
| `window`                               | object        | Required | Selected date window. additional fields rejected                         |
| `window.start`                         | string        | Required | Calendar date in YYYY-MM-DD form.                                        |
| `window.end`                           | string        | Required | Calendar date in YYYY-MM-DD form.                                        |
| `window.days`                          | integer       | Optional | Inclusive day count. minimum: 0                                          |

Manual intent and attached observations stay separate. A nomination does not establish a recommendation or a causal result.

[Download result schema](/schemas/context_focus.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).