find_references

[symbols]

Find exact compiler-bound Java references to a current semantic symbol.

Unreleased read-only preview. Technical reference for agents and client integrators.

Before this call

Exact semantic keys identify one declaration. Name matches cannot substitute for a key.

Parameters

Name	Type	Required	Description
symbolKey	string	Yes	Opaque semantic key returned by exact discovery in the current publication.
module	string	No	Exact imported module identifier.
scope	string	No	Compiler scope.
limit	number	No	Integer from 1 to 500. Keep the value unchanged during pagination. Default: `100`
cursor	string	No	Opaque nextCursor from the same query and generation. Keep all query arguments unchanged.

Examples

Technical examples for agents and client integrators. Replace paths and opaque keys with returned workspace values.

Illustrative arguments

Arguments 
{
  "symbolKey": "<returned-symbolKey>",
  "scope": "main"
}

Full MCP request

Full MCP request 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "find_references",
    "arguments": {
      "symbolKey": "<returned-symbolKey>",
      "scope": "main"
    }
  }
}

Response notes

Returns exact references with source spans and containing callable details. Reference kinds are read, write, read_write, invocation, construction, type_use, and method_reference. Results contain compiler-backed relation facts, contexts, coverage, limitations, and pagination. Inspect meta.referenceCoverage and meta.callerCoverage before an absence claim. An empty result certifies absence only when its relevant coverage flag is true. Maven TEST source is parser-only in this preview. Pages default to 100 entries and permit 500. Follow nextCursor with unchanged arguments. For stale_key, repeat exact semantic discovery in the current generation and retry with the new key. When the semantic publication is fresh, reuse it and repeat discovery without another sync. For stale_snapshot, stabilize the changed input and call sync. After sync succeeds, repeat exact semantic discovery and retry.