resolve_symbol

[symbols]

Resolve an exact Java declaration name in compiler contexts.

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

Before this call

Restart with a local analysis JDK, grant trust, load the project, and sync when compiler analysis is unavailable.

Parameters

Name	Type	Required	Description
query	string	Yes	Exact simple or qualified declaration name. Maximum 4096 characters.
kind	string	No	Exact declaration kind.
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 
{
  "query": "OrderService",
  "scope": "main"
}

Full MCP request

Full MCP request 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "resolve_symbol",
    "arguments": {
      "query": "OrderService",
      "scope": "main"
    }
  }
}

Response notes

Results contain compiler-backed facts, contexts, coverage, limitations, and pagination. Maven TEST source is parser-only in this preview. Parser tools remain usable with an external Maven parent POM or a Gradle source producer. The affected compiler facts are unavailable. Pages default to 100 entries and permit 500. Follow nextCursor with unchanged arguments. Incomplete coverage cannot certify absence. For stale_snapshot, inspect server_status and stabilize the changed input. Call sync. After it succeeds, repeat declaration discovery and retry with the new key or cursor.