PlugWiki
loki-mode logo

Loki Mode MCP Server: Setup for Claude, Cursor and Other Apps

CommunityLocal
Getnpmloki-modeasklokesh/loki-mode

Lets Claude or Cursor start and track autonomous Loki coding runs, and search the project memory and code Loki builds up.

Loki Mode is a command-line tool that builds software from a spec with several AI agents. Its built-in MCP server lets Claude, Cursor and other assistants start a run, follow its status, verify its receipt, and search the memory and code index Loki keeps in your project. It runs on your computer and needs no account. The tools that start runs can edit your files and run commands, so point them at a repo you can roll back. The license is BUSL-1.1, which is source-available and not open source.

Good for

  • Developers who want an assistant to hand a task or issue to Loki and check on it later
  • Teams that want a signed receipt proving what a coding run changed
  • People who want assistant memory and code search that persist in the repo

Works in

12 should work

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

Install loki-mode MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the loki-mode MCP server to Claude Code. Run this command:
    
    claude mcp add loki-mode -- npx -y loki-mode 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, Python 3 (first run builds a venv).

Read-only mode: Add --read-only after mcp in the command (or set LOKI_MCP_READ_ONLY=1). Only 24 read tools stay.

The command needs the mcp subcommand after the package name. The first run offers to create a .loki/mcp-venv folder and pip install the Python packages; run npx -y loki-mode mcp once in a terminal and say yes, or set LOKI_MCP_AUTO_BOOTSTRAP=1 for apps with no terminal. The README gives the Cursor and VS Code one-click links; other apps use the same command, adapted by us.

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

Tools

  • Shows project progress, agent activity and task counts

    Gives the broad picture of the current Loki project: where it is in its work cycle, what the agents are doing and how many tasks are done.

    Try: “How far along is the Loki project?”

    Read · loki_project_status

  • Shows the current phase and whether Loki is running

    Reads the .loki folder for the current phase, autonomy state and whether project memory exists.

    Try: “What phase is Loki in right now?”

    Files · loki_state_get

  • Checks how a background Loki run is going

    Reads a run's event log and reports its phase, verdict and cost so far. Use it after starting a run.

    Try: “Check the status of the latest Loki run in this repo.”

    Files · loki_v10_status

  • Shows review scores, verdicts and test coverage

    Returns the quality gate results for the project, including blind review scores, council verdicts and test coverage.

    Try: “Show the quality report for this project.”

    Read · loki_quality_report

  • Lists the code-review findings from one round

    Reads the structured review findings for one iteration, newest by default.

    Try: “List the review findings from the last iteration.”

    Read · loki_findings

  • Lists lessons Loki recorded earlier

    Reads the most recent entries from the learnings file, newest first, so past mistakes are not repeated.

    Try: “What did Loki learn recently?”

    Read · loki_learnings

  • Starts a Loki build run in the background

    Starts the same engine as the loki command for a task text or issue reference, inside a repo you name. It runs in the background and can change files in that repo.

    Try: “Use Loki to implement issue 42 in /Users/me/app.”

    Runs code · loki_v10_run

  • Re-checks the receipt of a finished run

    Runs loki verify on a receipt file, or on the newest run in a repo, to confirm the run's proof still holds.

    Try: “Verify the receipt of the last Loki run.”

    Runs code · loki_v10_verify

  • Turns your own edits into a signed Loki receipt

    Takes changes you already made in a repo and a short statement of intent, then produces the same verified receipt a Loki run gives. It starts a Loki process that can take up to 30 minutes by default.

    Try: “Seal my current diff in /Users/me/app with the intent "fix login redirect".”

    Runs code · loki_seal_diff

  • Checks a repo or diff in milliseconds, no AI call

    Runs Loki's built-in deterministic checks on a repo or on its changes against a git ref. The tool says it makes no model call and no network call.

    Try: “Run the fast verify on my changes against main.”

    Runs code · loki_verify_fast

  • Starts a Loki project from a product spec

    Initializes a Loki project from a PRD you paste in or point to by path, and begins the work.

    Try: “Start a Loki project from docs/prd.md.”

    Runs code · loki_start_project

  • Lists queued tasks with status and priority

    Shows every task in Loki's task queue before you add or change one.

    Try: “What tasks are in the Loki queue?”

    Read · loki_task_queue_list

Read from the source code

Permissions

high risk · 4 things to watch

High risk

It can start autonomous coding runs that change files in your repo, restore checkpoints and redact memory. Use a clean git branch, or start the server read-only so only 24 read tools stay.

What it can do

Watch out for

  • It can start coding runs that edit your repo

    The run and project tools launch Loki, which builds software and runs commands in the repo you name. Use a clean git branch, or turn on read-only mode. github.com

  • It can roll back state and redact memory

    Restoring a checkpoint changes project state, and the redact tool overwrites matching managed-memory versions. Check the ID or pattern before approving. github.com

  • First run installs Python packages

    On first launch Loki offers to create a .loki/mcp-venv folder and pip install the packages in requirements.txt. Apps without a terminal need LOKI_MCP_AUTO_BOOTSTRAP=1 to allow it. github.com

  • HTTP mode has no password by default

    The optional HTTP mode listens only on 127.0.0.1, with no sign-in unless LOKI_MCP_AUTH_TOKEN is set. Stdio, the default, opens no port. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Turning on read-onlyStart the server with --read-only (or set LOKI_MCP_READ_ONLY=1). Only 24 read tools stay: 16 for memory, status, search and review data, plus 8 Control Plane read tools.
Talks toLoki Control Plane URL, only if you set LOKI_CP_URL or LOKI_CONTROL_URL
Sign-in and keysNo sign-in. The server reads the environment of the app that starts it.

Questions

Is the Loki Mode MCP server official?

It is the project's own server, built into Loki Mode and published in the same npm package, not a third-party wrapper. Autonomi, Inc. holds the license. We do not mark it as an official vendor listing because the repository sits under a personal GitHub account.

Is Loki Mode open source?

No. It uses the Business Source License 1.1, which is source-available. Personal, non-commercial, internal-business and academic use are allowed, and offering it to third parties as a product needs a different license. Read the license file before commercial use.

Does it need an API key?

No key is needed for the MCP server itself. Loki runs on your machine and may call AI services with credentials already in your environment. The Control Plane tools also need a URL, and usually a token, in the environment.

Can I run it read-only?

Yes. Add --read-only after the mcp subcommand, or set LOKI_MCP_READ_ONLY=1. That leaves 24 read tools and removes everything that starts runs or writes.

Does it run locally or in the cloud?

Locally. It starts as a local process over stdio, and an optional HTTP mode binds only to 127.0.0.1.

Why does it ask to install Python packages?

The server is written in Python. On first run Loki offers to create a project-local virtual environment and install the packages it needs. In an app with no terminal, set LOKI_MCP_AUTO_BOOTSTRAP=1 or run the command once in a terminal first.

How many tools does it have?

48 in the published package: 32 core tools, 8 for the Control Plane, 7 for UI components and 1 for memory redaction. The tool list above shows all of them.

Information

updated Nov 2, 2026

Publisher
Community
Package
loki-mode
Registry
npm
Transport
stdio, Streamable HTTP
Auth
None
Version
10.9.1
License
BUSL-1.1
Last commit
Oct 31, 2026
Open issues
184
Listed in
Official MCP registry

WebsiteGitHubnpmOfficial MCP RegistryChangelogIssues

Sources

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

Show all 6
  1. github.com · github.com
  2. github.com · github.com
  3. github.com · github.com
  4. github.com · github.com
  5. github.com · github.com
  6. github.com · github.com

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