context status

context_status Read this repository’s first-party context state: connection grant state (booleans, property names, permission levels and dates only, never a token), GSC fact-row count, site-fact count, availability floors and manual-input presence. manual_only is a complete configuration, not an error: with no Google connection the manual inputs are the context.

Repository-local stdio MCP only. This tool is absent from hosted MCP and HTTP. It reads local context without starting a cloud job.

Setup and request

Start the local context host with an explicit repository root. Paths are restricted to that root, including symlink resolution.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "context_status",
    "arguments": {}
  }
}

Input fields

This operation accepts an empty object.

Returned result

Captured from a local fixture repository without external credentials.

{
  "project": null,
  "connection": {
    "grant": "none",
    "token_in_env": false
  },
  "handoff": null,
  "availability": {},
  "last_fetch_count": 0,
  "gsc_rows": 0,
  "gsc_file_missing": true,
  "gsc_problems": [],
  "site_fact_rows": 0,
  "manual_present": true,
  "manual_entries": 2
}

project (object / null, required): Customer-owned project configuration; additional user fields remain possible.
connection (object, required): Sanitized connection metadata. additional fields rejected
handoff (object / null, required): Customer-editable saved handoff state.
availability (object, required): Property names mapped to saved availability probes.
last_fetch_count (integer, required): Saved request-cache entries. minimum: 0
gsc_rows (integer, required): Parsed local GSC rows, including window markers. minimum: 0
gsc_file_missing (boolean, required): No GSC JSONL file exists.
gsc_problems (array, required): Malformed lines are reported without dropping the diagnostic.
site_fact_rows (integer, required): Parsed site fact rows. minimum: 0
manual_present (boolean, required): Nonempty manual inputs exist.
manual_entries (integer, required): Manual statements parsed. minimum: 0

All fields and nested objects

Field	Type	Presence	Meaning and constraints
`project`	object / null	Required	Customer-owned project configuration; additional user fields remain possible.
`project.id`	string	Optional	Configured project identifier.
`project.name`	string	Optional	Optional project label.
`project.site`	string / array	Optional	Customer-declared public site host or hosts.
`connection`	object	Required	Sanitized connection metadata. additional fields rejected
`connection.grant`	string	Required	Current sanitized connection grant state. values: “none”, “ok”, “refused”, “revoked”, “token_present_unverified”
`connection.token_in_env`	boolean	Required	Token presence only; the token is never returned.
`connection.checked_at`	string	Optional	Last connection check timestamp.
`connection.last_status`	integer	Optional	Last recorded HTTP status. minimum: 0
`connection.properties`	array	Optional	Connected property names.
`connection.permission_levels`	object	Optional	Property name to permission level.
`handoff`	object / null	Required	Customer-editable saved handoff state.
`handoff.connectors`	array	Optional	Original connector names.
`handoff.last_import_at`	string	Optional	Most recent handoff import timestamp.
`handoff.rows_imported`	integer	Optional	Cumulative imported row count. minimum: 0
`availability`	object	Required	Property names mapped to saved availability probes.
`availability.{property}.property`	string	Optional	Property identifier on a newly probed result.
`availability.{property}.first_available_date`	string / null	Required	Calendar date in YYYY-MM-DD form.
`availability.{property}.probed_at`	string	Required	Probe timestamp.
`availability.{property}.probes_used`	integer	Required	Probe calls used. minimum: 0
`availability.{property}.basis`	string	Required	Evidence or budget reason for the availability floor.
`availability.{property}.cached`	boolean	Optional	Whether the saved probe was reused.
`last_fetch_count`	integer	Required	Saved request-cache entries. minimum: 0
`gsc_rows`	integer	Required	Parsed local GSC rows, including window markers. minimum: 0
`gsc_file_missing`	boolean	Required	No GSC JSONL file exists.
`gsc_problems`	array	Required	Malformed lines are reported without dropping the diagnostic.
`gsc_problems[].line`	integer	Required	One-based file line. minimum: 0
`gsc_problems[].reason`	string	Required	JSON parsing failed for this line. must equal “not_json”
`site_fact_rows`	integer	Required	Parsed site fact rows. minimum: 0
`manual_present`	boolean	Required	Nonempty manual inputs exist.
`manual_entries`	integer	Required	Manual statements parsed. minimum: 0

Connection status returns only sanitized grant metadata. Project and handoff state remain customer-owned extensible records. Counts include local records, not a promise of fresh Google data. Download result schema.

Result and recovery

The host returns JSON in both structuredContent and text content. The local context reference 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, CLI context commands and schema conventions.

Overview

MCP, CLI and API commands

CLI client

HTTP and events

Optional local workflows

Setup and request

Input fields

Returned result

Result and recovery

​Setup and request

​Input fields

​Returned result

​Result and recovery

Setup and request

Input fields

Returned result

Result and recovery