find_callers

[symbols]

Group direct Java call sites by their exact containing source callable.

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

Before this call

Only method and constructor keys are valid. Other semantic keys return invalid_symbol_kind.

Parameters

Name	Type	Required	Description
symbolKey	string	Yes	Opaque method or constructor key returned by exact discovery in the current publication.
module	string	No	Exact imported module identifier.
scope	string	No	Compiler scope.
maxCallSitesPerCaller	number	No	Maximum direct call sites in each caller group, from 1 to 100. Default: `20`
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_callers",
    "arguments": {
      "symbolKey": "<returned-symbolKey>",
      "scope": "main"
    }
  }
}

Response notes

Returns direct invocation and construction sites grouped by source callable. Method and constructor references remain reference results. Dynamic dispatch reports the compile-time selected declaration. 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.