Skip to main content

MCP Tools

ArchGraph exposes 9 tools via the Model Context Protocol.

Search for code nodes by name, type, or language.

ParameterTypeDescription
namestringName pattern (supports wildcards: auth*)
typestringNode type: function, class, module, file
languagestringFilter by language: python, typescript, etc.
repostringRepository name
limitnumberMax results (default 20)

stats

Get graph statistics for a repository.

ParameterTypeDescription
repostringRepository name

impact

Analyze the blast radius of a code node -- trace upstream callers and downstream callees.

ParameterTypeDescription
node_idstringNode identifier (e.g. func:src/auth.py:validate:42)
directionstringupstream, downstream, or both
depthnumberMax traversal depth (default 3)

context

Get a node with its surrounding context -- neighbors, relationships, and properties.

ParameterTypeDescription
node_idstringNode identifier

source

Retrieve the source code for a specific node.

ParameterTypeDescription
node_idstringNode identifier

query

Execute a raw Cypher query (read-only).

ParameterTypeDescription
cypherstringCypher query (MATCH/RETURN only, no writes)

search_calls

Find callers or callees of a function.

ParameterTypeDescription
namestringFunction name
directionstringcallers or callees

detect_changes

Detect recently changed code and its impact.

ParameterTypeDescription
repostringRepository name
sincestringTime period (e.g. 7d, 30d)

find_vulnerabilities

Scan for security vulnerabilities -- input sources, dangerous sinks, taint paths.

ParameterTypeDescription
repostringRepository name