MCP Tool
nova.reference_doc_read
For edge cases, product boundaries, and robust failure paths, an agent uses this public tool to check the state or evidence for "Reference Doc Read Paging & NotFound". It explains which current signal can be used as evidence and when a follow-up step needs a fresh target check.
Canonical reference for a public MCP tool name.
- Type
- MCP tool
- Family
- Onboarding & Self-Service
- Effect
- read-only
- Status
- Explained
- Path
- 27.7
Purpose
What this entry explains
What it does
nova.reference_doc_read
An agent uses this tool to check the state or evidence for "Reference Doc Read Paging & NotFound". It belongs to edge cases, product boundaries, and robust failure paths; agents should combine it with current discovery, target awareness, and the visible result.
Use when
- Use this entry when an agent needs to check the state or evidence for "Reference Doc Read Paging & NotFound" for edge cases, product boundaries, and robust failure paths.
- Use it to understand the public tool name, its expected boundary, and the response signals to check.
- Use it before chaining follow-up tools so the next step is based on current evidence.
Reference Use
How agents should cite and apply this area
Examples are maintained at family level and use only public tool names or reference paths already present in the catalog.
Family example
An agent needs to change visible state in edge cases, product boundaries, and robust failure paths without guessing target or result from an earlier session.
The agent starts with nova.get_onboarding, reads the current response or reference, and only then chooses the concrete next tool.
Change only the confirmed target, then check visible state and stop on mismatch.Contract
Inputs and important response fields
This page is a public reference. Agents and integrators should still read current MCP tool discovery before execution, because schemas can be gated by settings or version.
Inputs
docId
Reference key for the current target, object, or session. Read it from the current response instead of guessing.
cursor
Paging or size-control field for long result sets. Use it to keep responses reviewable.
maxChars
Paging or size-control field for long result sets. Use it to keep responses reviewable.
| Response field | Explanation |
|---|---|
docId | Identifier or reference value. Do not guess it from memory; read it from the current response. |
hasMore | Paging or size signal for long result sets. It indicates whether more data needs a follow-up request. |
nextCursor | Paging or size signal for long result sets. It indicates whether more data needs a follow-up request. |
reasonCode | Machine-readable reason for a warning, block, or special behavior. |
Safety
Boundary before execution
Reads current state or evidence. It should not be treated as permission to act without a fresh next-step check.
Use the response as current evidence, then choose a more specific next tool only after target, scope, and freshness are clear.
For humans, this entry explains what an agent reads in edge cases, product boundaries, and robust failure paths and which current signal should be checked before trusting the result.
Safety Axes
How this path can affect work
Axes are stable catalog signals for humans, agents, and LLM discovery. One path can carry several axes.
read_current_state
Reads current state, response signals, or evidence without treating that alone as permission for a follow-up action.
Use the signal as current evidence and re-check target, scope, and visible state before any follow-up action.