whatisgithub

What is openinterp-mcp?

openinterpretability/openinterp-mcp — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · researcherComplexity · 4/5LicenseSetup · hard

In one sentence

A privacy-first toolkit that lets AI coding assistants run mechanistic interpretability experiments on language models.

Mindmap

mindmap
  root((openinterp-mcp))
    What it does
      Interpretability research
      MCP tool primitives
      Causality protocol
    Tech stack
      Python
      MCP
      Colab
      ngrok
    Use cases
      Probe evaluation
      Model steering
      Feature lookup
    Audience
      AI researchers
      Interpretability teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run causality experiments on a language model's internal layers from a coding assistant.

USE CASE 2

Probe whether a concept is represented at a specific layer and position in a model.

USE CASE 3

Steer a model's output by injecting directions into its internals.

USE CASE 4

Publish interpretability findings to a shared research registry.

What is it built with?

PythonMCPFastAPIColabngrok

How does it compare?

openinterpretability/openinterp-mcp0xhassaan/nn-from-scratch3ks/embedoc
Stars00
LanguagePythonPythonPython
Last pushed2023-06-08
MaintenanceDormant
Setup difficultyhardmoderatehard
Complexity4/54/51/5
Audienceresearcherdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires a Colab or similar GPU compute session plus an ngrok or cloudflared tunnel.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

openinterp-mcp is a Python toolkit for researchers studying mechanistic interpretability, the field that tries to understand what is actually happening inside AI language models when they process information, rather than treating the model as a black box. The toolkit exposes eight tool primitives that an AI coding assistant, such as Claude Code, Cursor, Cline, or any tool that speaks the MCP protocol, can call to run experiments. The primitives cover: attaching to a running compute session, checking its health, listing loaded probes, extracting activations (the internal numerical signals a model produces at specific layers), evaluating a probe against a stored capture, steering the model's behavior by injecting a direction into its internals, looking up SAE features from a stored activation, and running a standardized causality protocol. That protocol checks whether an observed signal is genuinely causing a behavior or only correlated with it, and returns one of five verdicts, including causal, weak causal, or an epiphenomenal category. Two additional Python modules, not exposed as MCP tools, handle publishing results to a shared registry and running replication checks. The architecture is built to be privacy first. The MCP server runs as a stateless process on the researcher's own laptop, while the actual model runs on the researcher's own compute, for example Google Colab, vast.ai, or runpod, and is reached through an ngrok or cloudflared tunnel. No inference happens on the project's own servers, no API keys are collected, and no queries pass through the project's infrastructure. Setup involves running one cell in a Colab notebook to install the package and launch a session, then connecting an MCP-compatible coding assistant to that session's URL. The toolkit is still early, described as v0.1.0 beta, with the project noting the API may change before a 1.0 release. It is released under the Apache-2.0 license.

Copy-paste prompts

Prompt 1
Walk me through connecting openinterp-mcp to a Colab session running Qwen2.5-7B.
Prompt 2
Explain what the causality_protocol tool checks and what each verdict means.
Prompt 3
Show me how to extract activations at a specific layer using capture_acts.
Prompt 4
Help me set up openinterp-mcp inside my Claude Code MCP config.
Prompt 5
What is the difference between a probe evaluation and an SAE feature lookup in this toolkit?

Frequently asked questions

What is openinterp-mcp?

A privacy-first toolkit that lets AI coding assistants run mechanistic interpretability experiments on language models.

What language is openinterp-mcp written in?

Mainly Python. The stack also includes Python, MCP, FastAPI.

What license does openinterp-mcp use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is openinterp-mcp to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is openinterp-mcp for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.