mcpField
L
llmgraph

llmgraph

Local
beta.llmgraph.inDeveloper Tools2Updated today

About llmgraph

llmgraph analyzes call relationships and change impact for coding agents and developers checking dependencies before or after edits. It distinguishes proven results from blind spots and explains the evidence and uncertainty behind its answers.

Key features

  1. 01Find callers and calls it cannot see
  2. 02Analyze what may break after a change
  3. 03Check for missed callers after edits
  4. 04Label the certainty of findings
  5. 05Explain the evidence for each answer

Use cases

  1. 01Find call sites before changing a function signature
  2. 02Check edits for callers that were missed
  3. 03Separate proven dependencies from dynamic-call blind spots

MCP support

It provides an MCP server with tools for querying call relationships, change impact, blind spots, and supporting evidence.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"brainfoods-studio-llmgraph": {
"command": "npx",
"args": [
"-y",
"llmgraph-mcp"
]
}
}
}
Run commandnpx -y llmgraph-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmllmgraph-mcp0.4.6

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README
LLMGRAPH: every call graph has blind spots. Ours tells you where they are.

LLMGRAPH

Every call graph has blind spots. Ours tells you where they are.

LLMGRAPH inks only the calls it can prove. The ones it can't see, it counts and names in plain words, so your agent sees the blind spots before it edits.

I built LLMGRAPH as the truth layer for coding agents, and the truth includes the blind spots: agents guess; LLMGRAPH proves what it can and names what it can't. In a blind test of 50 questions on three open-source repos, no confident answer was wrong.


Two functions. One name. Your agent can't tell. We can.

grep reads names. LLMGRAPH follows calls. What it can prove, it proves; what it can't, it tells you, down to the line where it stopped.

zod ships two copies of addIssueToContext. A text search mixes them together:

$ rg -n addIssueToContext      # zod v3.23.8
146 lines, from both copies, mixed together

LLMGRAPH separates them, and shows its work:

llmgraph · who_calls addIssueToContext (src/helpers/parseUtil.ts:72): 71 in a set
  ⚠︎ type checker starting: answers use our own reading for now; 71 calls unchecked
  ◇ within_these 71 calls -> one of 1 (closed: repo only) [c] w1
  ⚠︎ plus 7 dynamic calls nearby that could reach anything w2
  – ruled out: 71 same-name calls (proven: other target) [c] w3
  assumes [c]: our own reading, not confirmed by the checker
(lines trimmed)

71 look-alikes ruled out, and it shows why. And where the type checker hasn't confirmed yet, it says so.

Who's holding the other end?

Before your agent pulls a thread, it should know. In requests, change super_len(o) to super_len(o, strict), and ask check_my_changes:

llmgraph · check_my_changes: 1 file changed, 16 calls break
  16 breaks: misses "strict" w1
  ⚠︎ breaks if it runs super_len src/requests/models.py:526 PreparedRequest.prepare_body (within_these, one of 1, closed: repo only) [c] w2
  ⚠︎ breaks if it runs super_len src/requests/models.py:575 PreparedRequest.prepare_content_length (within_these, one of 1, closed: repo only) [c] w3
  ⚠︎ breaks if it runs super_len tests/test_utils.py:62 TestSuperLen.test_io_streams (within_these, one of 1, closed: repo only) [c] w4
  … 13 more test call sites
  ⚠︎ plus 9 dynamic calls nearby that could reach super_len w18
(lines trimmed)

16 broken calls named, exactly the real ones. A blind tester's text search found the same 16, no more and no fewer. And the 9 dynamic calls it can't follow are marked, not ignored.

Then the type checker catches up. Ask again a few seconds later:

llmgraph · who_calls super_len (src/requests/utils.py:135): 16 certain
  ✓ certain src/requests/models.py:526 PreparedRequest.prepare_body w33
  +1 more (all certain, same file) w34
  ✓ certain tests/test_utils.py:62 TestSuperLen.test_io_streams w35
  +13 more (all certain, same file) w36
  ⚠ plus 9 dynamic calls nearby that could reach anything w37
(lines trimmed)

From "our own reading" to 16 certain, on the released program. Its labels never say more than it has proven, and they upgrade the moment it can.

The five labels

Other tools sketch your codebase from rumour and fill the blind spots with confidence. LLMGRAPH works in two colours: ink for what it has proven, a plain warning for what it hasn't, and never one dressed up as the other.

LabelWhat it means
certainWe can prove it is exactly one function.
exactly_theseA known set, and every member really can run here.
within_theseOne of a known list; some listed may never happen here.
maybe_moreThere are candidates, but the door is open.
cannot_seeNothing to go on.

Answers carry no numbers about chance; they say what is ruled out.

Measured on our test projects

Callers are confirmed by the type checker in under a second after your agent asks (Python), and check_my_changes answers in under a second once LLMGRAPH has caught up with a save. On names that also appear in unrelated code, it named no wrong callers where a plain text search returned hundreds of wrong lines, and the agent read less than half as many tokens; on clean, unique names there is no saving.

How we measured, the raw data, and where LLMGRAPH loses: BENCHMARKS.md.

What your agent can ask

ToolWhat it answers
who_callsEvery place that calls this function, plus calls we can't see.
what_breaks_if_changedEverything that depends on this, directly or indirectly, and what we can't see.
check_my_changesAfter editing: callers you didn't update, and anything we can't see.
what_is_unknownWhere our view is blind (dynamic calls, unknown types, unreadable files) and why.
explainWhy we said this: the evidence behind one answer line.

Your code is read and analysed on your machine, and we never receive your code, paths, symbol or repo names, queries or answers. Checked on the released program: it contacts only beta.llmgraph.in. Usage counts and crash reports are on by default and can be switched off (npx -y llmgraph-mcp telemetry off); the licence check is always on. Privacy page.

Install

Claude Code (plugin):

claude plugin marketplace add brainfoods-studio/llmgraph-agent-plugin
claude plugin install llmgraph@llmgraph

The plugin offers LLMGRAPH's answer before your agent searches for a function or class name, and never blocks the search. When your agent is about to finish, it stops it once if the saved edits left calls that are certain to break, and lists them; it never blocks on anything less, and npx -y llmgraph-mcp hook off turns both off.

Any MCP agent: add the server npx -y llmgraph-mcp (on Windows some agents need cmd /c npx -y llmgraph-mcp), sign in once with Google, and your agent asks. Setup guides for Claude Code, Antigravity, Cursor, Codex, Gemini CLI, Windsurf and OpenCode; tested by us on Claude Code and Antigravity.

Today's limits: Windows x64 · Python and TypeScript/JavaScript (other languages are reported as cannot_see, not counted as nothing) · repos up to the plan's line limit · invite-only beta, request an invite · one plan for individuals with a trial, prices.

This repo holds the open setup files under MIT; the LLMGRAPH engine is closed source and runs on your machine under the EULA. Brainfoods Studio, India · [email protected] · [email protected]

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.