find_external_dependency_usages

[external]

Finds source usages of symbols that come from a referenced external assembly, keyed by assembly name or full metadata reference identity.

Try this tool in Playground.

Parameters

NameTypeRequiredDescription
assemblyNamestringNoOptional simple assembly name to analyze. Provide this or referenceIdentity.
referenceIdentitystringNoOptional full metadata reference identity. Provide this or assemblyName.
projectNamestringNoOptional project name filter.
pathStylestringNoPath style: 'absolute' (default) or 'relative' (to solution root).
symbolsSkipnumberNoSymbol-summary pagination offset. Default is 0.
symbolsTakenumberNoSymbol-summary pagination size. Default is 200.
filesSkipnumberNoFile-summary pagination offset. Default is 0.
filesTakenumberNoFile-summary pagination size. Default is 200.
maxExampleLocationsnumberNoMaximum sample locations or symbols to include per summary item. Default is 5. Use 0 to omit examples.

Examples

Analyze usages by assembly name

Request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "find_external_dependency_usages",
    "arguments": {
      "assemblyName": "System.Text.Json"
    }
  }
}
Response
{
  "success": true,
  "data": {
    "assemblyName": "System.Text.Json",
    "projectSummaryCount": 1,
    "fileSummaryCount": 2,
    "symbolSummaryCount": 3,
    "projects": [
      {
        "projectName": "MyApp",
        "usageCount": 6
      }
    ],
    "files": [
      {
        "filePath": "/path/to/JsonService.cs",
        "usageCount": 4
      }
    ],
    "symbols": [
      {
        "symbolName": "JsonSerializer.Serialize",
        "usageCount": 3,
        "exampleLocations": [
          {
            "filePath": "/path/to/JsonService.cs",
            "lineNumber": 27
          }
        ]
      }
    ]
  },
  "error": null
}

Analyze usages by full metadata identity

Request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "find_external_dependency_usages",
    "arguments": {
      "referenceIdentity": "System.Text.Json, Version=9.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51"
    }
  }
}
Response
{
  "success": true,
  "data": {
    "assemblyName": "System.Text.Json",
    "projectSummaryCount": 1,
    "fileSummaryCount": 2,
    "symbolSummaryCount": 3,
    "projects": [
      {
        "projectName": "MyApp",
        "usageCount": 6
      }
    ],
    "files": [
      {
        "filePath": "/path/to/JsonService.cs",
        "usageCount": 4
      }
    ],
    "symbols": [
      {
        "symbolName": "JsonSerializer.Serialize",
        "usageCount": 3,
        "exampleLocations": [
          {
            "filePath": "/path/to/JsonService.cs",
            "lineNumber": 27
          }
        ]
      }
    ]
  },
  "error": null
}

Response Notes

Returns project, file, and symbol summaries for a referenced external assembly