PlugWiki

sem MCP Server by Ataraxy Labs: Setup for Claude, Cursor and Other Apps

CommunityLocal
Getnpm@ataraxy-labs/semataraxy-labs/sem

Lets your coding assistant ask which functions a change touches, who calls them and whether the checks pass.

sem is a command-line tool from Ataraxy Labs that understands code as functions and classes instead of lines. Its sem mcp command is the MCP server, so the assistant gets the same questions as tools.

The server runs on your computer in your Git folder. One tool runs your project's own test and lint commands, so treat it like running them yourself.

Good for

  • Developers who want an assistant to see what a change would break
  • Reviewers who want a summary of changed functions, not a line diff
  • Teams who want an assistant to run the project's checks

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install @ataraxy-labs/sem MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the @ataraxy-labs/sem MCP server to Claude Code. Run this command:
    
    claude mcp add sem -- npx -y @ataraxy-labs/sem mcp
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js, Node.js (for the npm wrapper).

Read-only mode: There is no read-only switch. The tools read your code, and the check tool runs your project's own test and lint commands.

The npm package is a thin wrapper that downloads the sem program for your system, and the command ends with mcp, which starts the server. The README instead installs sem with a script, Homebrew, winget, Scoop or cargo and runs sem mcp, which also works. On a machine with GNU Parallel, sem may mean a different program, so use the npx command or the full path. Run the server from your project folder so it reads the right Git checkout.

Built from the package data we hold. Not yet tested by us.

Tools

  • Finds where a function or class is defined

    Looks up an entity by name, or by a free-text description if you do not know the name. Modes also list its callers, its references, or a compact context with its source and callers and callees.

    Try: “Where is submitOrder defined, and who calls it?”

    Read · sem_find

  • Searches code for exact text

    Finds an exact string such as an error message or config key, and reports the function or class it sits in rather than just the line.

    Try: “Where does the text "retry limit" appear?”

    Read · sem_grep

  • Shows what a change would touch

    Lists what depends on an entity, what it depends on, and which tests are affected, following dependents a few steps out.

    Try: “What breaks if I change submitOrder?”

    Read · sem_impact

  • Runs the project's checks and gives a verdict

    Runs the project's compiler, type checker, linter and tests, and any commands from its .sem/check.json, then returns pass, fail or could not decide. It only rechecks what a change can affect when that is provably the same result.

    Try: “Check that my change is correct.”

    Runs code · sem_check

  • Summarizes what a human should review

    Builds a review summary for a commit range: touched entities, signature changes, callers left behind and affected tests.

    Try: “What should I review in main..HEAD?”

    Read · sem_certify

  • Shows which entities changed between two versions

    Compares two refs, or the working tree, and lists the functions and classes that changed, optionally with before and after source.

    Try: “Which functions changed since main?”

    Read · sem_diff

  • Shows how code connects

    Returns a graph of entities and their calls, JS/TS modules, data flow, or the system as a whole.

    Try: “Show the module graph of this package.”

    Read · sem_graph

  • Shows how an entity changed over time

    Traces the history of one function or class, or gives repo-wide hotspots and files that change together. It can also give blame for a file.

    Try: “How has submitOrder changed over time?”

    Read · sem_history

Read from the source code

Permissions

high risk · 3 things to watch

High risk

Most tools only read your code and Git history, but the check tool runs your project's compiler, linter, tests and custom commands. Use it only in repositories you trust.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • The check tool runs your project's own commands

    It runs compilers, linters, tests and any commands listed in .sem/check.json, which can do anything those commands can. Use it only in repositories you trust. github.com

  • Local usage counts, optional upload

    sem counts command names on your machine only, and uploads counts only if you turn telemetry on. DO_NOT_TRACK=1 turns it off. github.com

  • Name clash with GNU Parallel

    On systems with GNU Parallel, the command sem may start a different program. Use the npx command or the full path. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details
Talks toNone by default; optional cloud acceleration and opt-in telemetry
Sign-in and keysNo credentials for local use. The optional cloud feature signs in with GitHub.
Scopes
  • Files in the Git checkout it runs in

Questions

Is sem official?

It is the project's own server, from Ataraxy Labs. It is not tied to Git or any language vendor.

Does it need an account or API key?

No. Local use needs no account. Cloud acceleration is optional and signs in with GitHub.

Can it change my code?

The tools read code and history. The check tool runs your project's tests and linters, which could write files if those commands do.

Does it send my code anywhere?

Not for local use. The README says the default telemetry stays on your machine and records only command names. Cloud features are optional.

What languages does it support?

The README lists many languages it parses, including TypeScript, Python, Go, Rust, C and C++. See the README for the full list.

Is the tool list complete?

It lists the 8 tools in the README and source. A review mode adds four more, and older tool names still work but are not listed.

Information

updated Nov 2, 2026

Publisher
Community
Package
@ataraxy-labs/sem
Registry
npm
Transport
stdio
Version
0.29.0
License
MIT OR Apache-2.0
Last commit
Oct 31, 2026
Listed in
Official MCP registry

WebsiteGitHubnpmOfficial MCP Registry

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 3
  1. tools.rs · github.com
  2. README.md · github.com
  3. sem · npmjs.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.