Skip to content

Find Callees

find-callees · Query · CorePlugin · Code discovery and navigation

Finds distinct method and constructor targets invoked by a source executable symbol or selected executable region. Use this for outgoing calls; use find-callers for incoming call sites. Reads the loaded workspace without executing code. Direct calls are the default; includeIndirect traverses reachable source bodies up to maxDepth (default 3, direct calls at depth 1). Nested lambda and local-function bodies are skipped during each body scan. Returns source and a bounded callees collection, not call sites or runtime dispatch targets. calleesLimit defaults to 100; check callees.hasMore for result truncation within the requested depth.

Availability: Built in and published in every operational mode.

Generated from Roslyn Workbench MCP 1.2.0 (1.2.0).

Behaviour annotations

Annotation Value
destructiveHint false
idempotentHint true
openWorldHint false
readOnlyHint true
title "Find Callees"

Request

Property Type Required Description
symbol object No Symbol whose callees should be found.
location object No Source location or executable region whose contained callees should be found.
includeIndirect boolean No Whether reachable source callees should be traversed transitively.
maxDepth integer No The maximum call depth to traverse when indirect callees are included. Direct callees are at depth one.
calleesLimit integer | null No Maximum number of results to return.
expectedSnapshot object | null No Echo the snapshot returned with the data or transaction state used to construct this request.
workspace object | null No Provide workspaceId, alias, path, or any combination.

Response

Success response

Property Type Required Description
ok boolean constant (true) Yes Whether the tool invocation succeeded.
data object | null Yes Tool-specific result payload.
snapshot object Yes Exact immutable workspace snapshot associated with the result, when available.
warnings array No Non-fatal warnings the agent should consider.

Error response

Property Type Required Description
ok boolean constant (false) Yes Whether the tool invocation succeeded.
error object Yes Structured error details when the invocation failed.
continuation oneOf No Action the agent should take before retrying or continuing.
diagnostics array No Diagnostics that explain the failed invocation.
warnings array No Non-fatal warnings the agent should consider.

Error response

Property Type Required Description
ok boolean constant (false) Yes Whether the tool invocation succeeded.
error object Yes Structured error details when the invocation failed.
diagnostics object Yes Diagnostics that explain the failed invocation.
reporting object No Error-reporting workflow available for an unhandled failure.

Bounded collections and continuation

These response locations publish returned items with explicit bounds and continuation state:

  • $/oneOf/0/properties/data/properties/callees

Continuations and required actions

A response may include a structured continuation at the following schema location. Follow its tool call or user-action instruction instead of guessing how to continue:

  • $/oneOf/1/properties/continuation
Complete input schema
{
  "description": "Provide exactly one of symbol or location.",
  "type": "object",
  "properties": {
    "symbol": {
      "description": "Symbol whose callees should be found.",
      "type": "object",
      "properties": {
        "project": {
          "$ref": "#/$defs/project",
          "description": "Disambiguates symbols with matching identities."
        },
        "location": {
          "$ref": "#/$defs/location",
          "description": "Provide exactly one of span or selection."
        },
        "documentationCommentId": {
          "type": "string"
        }
      }
    },
    "location": {
      "$ref": "#/$defs/location",
      "description": "Source location or executable region whose contained callees should be found."
    },
    "includeIndirect": {
      "description": "Whether reachable source callees should be traversed transitively.",
      "type": "boolean"
    },
    "maxDepth": {
      "description": "The maximum call depth to traverse when indirect callees are included. Direct callees are at depth one.",
      "type": "integer",
      "minimum": 1,
      "maximum": 2147483647,
      "default": 3
    },
    "calleesLimit": {
      "description": "Maximum number of results to return.",
      "type": [
        "integer",
        "null"
      ],
      "minimum": 0,
      "maximum": 2147483647,
      "default": 100
    },
    "expectedSnapshot": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "workspaceId": {
          "type": "string",
          "format": "uuid"
        },
        "workspaceEpoch": {
          "type": "integer"
        },
        "snapshotId": {
          "type": "string",
          "format": "uuid"
        },
        "transactionRevision": {
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "required": [
        "workspaceId",
        "workspaceEpoch",
        "snapshotId",
        "transactionRevision"
      ],
      "description": "Echo the snapshot returned with the data or transaction state used to construct this request."
    },
    "workspace": {
      "description": "Provide workspaceId, alias, path, or any combination.",
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "workspaceId": {
          "type": "string",
          "format": "uuid"
        },
        "alias": {
          "type": "string"
        },
        "path": {
          "description": "Absolute workspace path.",
          "type": "string"
        }
      }
    }
  },
  "$defs": {
    "project": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "projectId": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "path": {
          "description": "Workspace-relative path.",
          "type": "string"
        },
        "targetFramework": {
          "type": "string"
        }
      }
    },
    "document": {
      "type": "object",
      "properties": {
        "project": {
          "$ref": "#/$defs/project",
          "description": "Disambiguates documents with matching paths or IDs."
        },
        "path": {
          "description": "Workspace-relative path.",
          "type": "string"
        },
        "documentId": {
          "description": "Workspace-local document ID.",
          "type": "string"
        }
      }
    },
    "location": {
      "type": "object",
      "properties": {
        "span": {
          "type": "object",
          "properties": {
            "document": {
              "$ref": "#/$defs/document",
              "description": "Provide exactly one of path or documentId."
            },
            "range": {
              "description": "Zero-based UTF-16 range.",
              "type": "object",
              "properties": {
                "start": {
                  "description": "Zero-based UTF-16 offset.",
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 2147483647
                },
                "length": {
                  "description": "UTF-16 code-unit length.",
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 2147483647
                }
              }
            }
          },
          "required": [
            "document",
            "range"
          ]
        },
        "selection": {
          "type": "object",
          "properties": {
            "document": {
              "$ref": "#/$defs/document",
              "description": "Provide exactly one of path or documentId."
            },
            "selectedText": {
              "type": "string",
              "minLength": 1
            },
            "contextBefore": {
              "type": [
                "string",
                "null"
              ]
            },
            "contextAfter": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "document",
            "selectedText"
          ]
        }
      }
    }
  }
}
Complete output schema
{
  "type": "object",
  "oneOf": [
    {
      "type": "object",
      "required": [
        "ok",
        "data",
        "snapshot"
      ],
      "properties": {
        "ok": {
          "const": true,
          "description": "Whether the tool invocation succeeded."
        },
        "data": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "source": {
              "description": "The queried callable symbol.",
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "displayName": {
                  "description": "The display name of the symbol.",
                  "type": "string"
                },
                "kind": {
                  "description": "The symbol kind.",
                  "type": "string"
                },
                "documentationCommentId": {
                  "description": "The documentation comment identifier, when available.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "location": {
                  "description": "The optional source location of the symbol.",
                  "type": [
                    "object",
                    "null"
                  ],
                  "properties": {
                    "document": {
                      "description": "The resolved document.",
                      "type": [
                        "object",
                        "null"
                      ],
                      "properties": {
                        "documentId": {
                          "description": "The document identifier.",
                          "type": "string"
                        },
                        "path": {
                          "description": "The normalized document path.",
                          "type": "string"
                        },
                        "projectId": {
                          "description": "The owning project identifier.",
                          "type": "string"
                        }
                      },
                      "required": [
                        "documentId",
                        "path",
                        "projectId"
                      ]
                    },
                    "span": {
                      "description": "The resolved text span.",
                      "type": [
                        "object",
                        "null"
                      ],
                      "properties": {
                        "start": {
                          "description": "Zero-based UTF-16 offset.",
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 2147483647
                        },
                        "length": {
                          "description": "UTF-16 code-unit length.",
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 2147483647
                        }
                      }
                    },
                    "line": {
                      "description": "The one-based line number.",
                      "type": "integer"
                    },