Devtoolwatch BoardGet it every Monday

jCodeMunch MCP review

jCodeMunch MCP is an MCP server that retrieves source code by symbol instead of by file, using tree-sitter AST parsing.

Updated Nov 1, 2026. Review written Oct 22, 2026 from the project's own sources; usage data refreshed every Monday.

TL;DR

jCodeMunch MCP indexes a codebase once and lets AI agents fetch exact functions, classes, methods and outlines instead of reading whole files. It is for developers using Claude Code, Cursor, VS Code and other MCP clients who want to spend fewer tokens on code exploration. It also answers structural questions such as importers, blast radius and dead code.

jCodeMunch MCP at a glance

Category
MCP and agent tools
Maintained by
J. Gravelle (individual, @jgravelle on GitHub)
Language
Python, TypeScript, Dockerfile
Repository
github.com/jgravelle/jcodemunch-mcp
Website
jcodemunch.com
PyPI package
jcodemunch-mcp 1.108.390
Latest release
v1.108.390 on GitHub, Oct 21, 2026
First published
Feb 9, 2026

What jCodeMunch MCP does

  • jCodeMunch MCP searches symbols and returns the exact source of a function or class, byte-precise, instead of loading the whole file.
  • jCodeMunch MCP assembles a task's context in one call with assemble_task_context, running a tool sequence under one token budget.
  • jCodeMunch MCP answers structural queries such as find_importers, get_blast_radius, get_call_hierarchy, find_dead_code and get_changed_symbols.
  • jCodeMunch MCP preflights risky changes with check_edit_safe, check_delete_safe, get_pr_risk_profile and plan_refactoring.
  • jCodeMunch MCP redacts secrets automatically before anything reaches the LLM and reports confidence scores and freshness flags.
  • jCodeMunch MCP keeps the index fresh through watch modes, agent hooks and a VS Code extension.
  • jCodeMunch MCP reports tokens served and session savings through get_session_stats.

How it works

jCodeMunch MCP runs as a local MCP server, usually launched with uvx by your MCP client. It parses source with tree-sitter and stores symbol metadata (signature, kind, qualified name, summary, byte offsets) with raw file content in a local index. Agents then call tools like search_symbols and get_symbol_source. The init command detects clients such as Claude Code, Claude Desktop, Cursor, Windsurf and Continue and writes their config.

How to install and start using jCodeMunch MCP

With uv (recommended)

uv tool install jcodemunch-mcp

Zero install with uvx

uvx jcodemunch-mcp

Manual Claude Code setup

claude mcp add -s user jcodemunch -- uvx jcodemunch-mcp

Requirements

  • Python 3.10 or later.
  • An MCP-compatible client such as Claude Code, Cursor, VS Code, Codex CLI, Windsurf or Continue.
  • The uv tool is recommended for installation; enforcement hooks need uv tool install, pipx or pip rather than uvx.

First steps

  1. Run jcodemunch-mcp init to detect your MCP clients, write their config and optionally index your project.
  2. Add "Call the jcodemunch_guide tool and strictly follow its instructions." to your CLAUDE.md so the agent prefers the tools.
  3. Ask your agent: "Index this repo with jcodemunch."
  4. Ask the agent to find a function with jcodemunch, then confirm savings with get_session_stats.

Who jCodeMunch MCP is for

  • Developers using Claude Code or Cursor who want agents to read less code per lookup.
  • Developers onboarding to large, unfamiliar repositories who want to search symbols directly.
  • Teams that want pre-change checks like blast radius and PR risk profiles in agent workflows or CI.
  • Organizations tracking LLM token spend on code reading.

Limitations to know

  • jCodeMunch MCP is free for personal use only; commercial use requires a paid license, which init lists at $79.
  • jCodeMunch MCP tools are not used automatically after install; the agent must be told to prefer them.
  • jCodeMunch MCP does not run type checkers for you; you must supply checker output for diagnostics-aware answers.
  • On Python 3.10, the gcm explain feature is unavailable because it needs Python 3.11.

Is jCodeMunch MCP growing? Usage data

jCodeMunch MCP was not ranked on the Devtoolwatch Board in the week of Oct 25–31, 2026: it needs 25 or more new stars or 1,000 or more added downloads in a week to rank.

New GitHub stars per week for jCodeMunch MCP12 weeks from Aug 9, 2026: 37, 38, 34, 32, 29, 15, 16, 17, 29, 27, 29, 26 new stars, an average of 27 a week.Aug 9week of Oct 25
New GitHub stars per week for the last 12 weeks, from GitHub's stargazer history (today's stargazers by the week they starred).
Show the weekly numbers
New GitHub stars per week for jCodeMunch MCP
Week ofNew stars
Aug 9, 202637
Aug 16, 202638
Aug 23, 202634
Aug 30, 202632
Sep 6, 202629
Sep 13, 202615
Sep 20, 202616
Sep 27, 202617
Oct 4, 202629
Oct 11, 202627
Oct 18, 202629
Oct 25, 202626

The Board ranks tools by four signals each week: new stars, new stars for the repo's size, added downloads and download growth beyond the market. How the ranking works.

jCodeMunch MCP alternatives

Other MCP servers and agent tools on the Board in the week of Oct 25–31, 2026, by momentum:

MCP and agent tools ranked by momentum, the week of Oct 25–31, 2026
RankToolStarsDownloads/wk
#1REAREA is an MCP server and CLI that lets coding agents reverse engineer native binaries, JavaScript and Electron apps, .NET assemblies,…415.5k760.6k
#2ha-mcpha-mcp is an unofficial Model Context Protocol server that lets AI assistants control and manage Home Assistant using natural language.5.4k118.1k
#3TregTreg is a registry and proxy that gives AI agents one token for a catalog of paid third-party API endpoints and team-shared tools.6.9k6.7k
#4Chrome DevTools MCPChrome DevTools MCP is an MCP server and CLI that lets coding agents control and inspect a live Chrome browser using Chrome DevTools.54.6k2.7M
#5codebase-memory-mcpHigh-performance code intelligence MCP server. Indexes codebases into a persistent knowledge graph — average repo in milliseconds. 162…47.9k–
#6open-computer-use👾 Open Computer Use – Open-Source Alternative to Codex Computer Use2.8k–

All MCP servers and agent tools, ranked

Recent jCodeMunch MCP releases

jCodeMunch MCP FAQ

Is jCodeMunch MCP free and open source?

jCodeMunch MCP's code is on GitHub (jgravelle/jcodemunch-mcp), but the repository doesn't declare a standard open-source license. Check its license file before using it commercially. Its website links to a pricing page: https://jcodemunch.com/#pricing.

How do I install jCodeMunch MCP?

Run uv tool install jcodemunch-mcp. The jcodemunch-mcp package needs Python 3.10 or newer. The install section above has the other options from the project's README.

Is jCodeMunch MCP still maintained?

Yes. The jgravelle/jcodemunch-mcp repository was last updated on Oct 22, 2026, and the latest release, v1.108.390 on GitHub, came out on Oct 21, 2026.

How popular is jCodeMunch MCP?

jCodeMunch MCP has 2.8k GitHub stars as of Nov 1, 2026. It gained 26 new stars in the week of Oct 25–31, 2026, against a 12-week average of 27 a week.

What are the best alternatives to jCodeMunch MCP?

Other MCP servers and agent tools on the Devtoolwatch Board in the week of Oct 25–31, 2026, by momentum: REA (#1), ha-mcp (#2), Treg (#3), Chrome DevTools MCP (#4), codebase-memory-mcp (#5). The alternatives table above has their numbers.

How does jCodeMunch MCP reduce token usage?

jCodeMunch MCP returns only the symbols an agent needs instead of whole files. The README's pinned benchmark on express, fastapi and gin reports 96.6% fewer tokens per lookup than a grep-and-read agent, measured with tiktoken cl100k_base on version 1.108.364.

Which MCP clients does jCodeMunch MCP work with?

jCodeMunch MCP works with Claude Code, Cursor, VS Code, Codex CLI, Windsurf, Continue and any MCP-compatible client. The README also lists tested configurations for Antigravity, Gemini CLI, Qwen Code, Kiro, Cline, Zed, Goose and others in CLIENTS.md.

What is the difference between check_references and find_references in jCodeMunch MCP?

check_references in jCodeMunch MCP finds where a name is used, including import sites and any file mentioning it. find_references only finds who imports it, using the import graph, so call sites are invisible to it.

Does jCodeMunch MCP send secrets to the LLM?

jCodeMunch MCP applies automatic secret redaction before anything reaches the LLM, according to its README.

Can jCodeMunch MCP skip indexing popular frameworks?

jCodeMunch MCP offers pre-built starter packs for popular frameworks, listed with jcodemunch-mcp install-pack --list. Free packs need no license.

Sources

  1. jgravelle/jcodemunch-mcp on GitHub
  2. jCodeMunch MCP README
  3. jcodemunch-mcp on PyPI
  4. jCodeMunch MCP website
  5. Release v1.108.390 (Oct 21, 2026)
  6. Release v1.108.389 (Oct 21, 2026)
  7. Release v1.108.388 (Oct 21, 2026)
  8. Devtoolwatch Board, the week of Oct 25–31, 2026

jCodeMunch MCP README badge

Maintainers can show the tool's weekly Board rank in their README:

Devtoolwatch badge for jCodeMunch MCP

[![Devtoolwatch](https://index.devtoolwatch.com/badge/jgravelle-jcodemunch-mcp.svg)](https://index.devtoolwatch.com/tools/jgravelle-jcodemunch-mcp/)

How this page is made: Devtoolwatch writes each review from the project's README, releases, package metadata and website, with an AI model, then checks every claim against the source it cites and drops what the sources don't support. The numbers come from Devtoolwatch's daily GitHub snapshots, GitHub's stargazer history, and the npm and PyPI download APIs. Spotted an error? Email [email protected].