# probbit

> probbit is an open-source MCP server for agent tooling. Offline persona, mood and memory layer for AI agents, with replayable stance receipts. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Linux, macOS, Windows, Web, Self-hosted
- **Repository:** https://github.com/bitmapasset/probbit
- **MCP Registry name:** io.github.BitmapAsset/probbit
- **Categories:** [agent tooling](https://ai-powered.com/categories/agent-tooling)
- **Listing updated:** 2026-11-20

## About

The README describes probbit as a layer that sits outside the language model and computes an agent's stance from a persona file and a seed, so the same individual keeps its habits whichever model writes the words. Each turn produces a short stance line for the prompt, exact odds for each trait level, and a hash-chained log that can be replayed to verify it.

The same engine is also presented as a constraint solver for assigning tasks under hard rules, returning either exact odds or an explicit refusal when it cannot vouch for an answer. Per the README, it runs as a Rust binary on the CPU with no network access or API key required.

The README is explicit that probbit computes the stance but cannot stop a model from ignoring it, and that the receipt shows what was asked rather than what the model did. It is aimed at agent builders who want a reproducible temperament and auditable decisions.

## Features

- **Persona files and seeds:** A YAML or JSON persona with traits, moods and habits, where a seed produces a specific individual.
- **Replayable event log:** Each turn is recorded in a hash-chained strand that the verify command replays digest by digest.
- **Hard-rule habits:** Habits act as constraints on the computed stance and are reported when they are active.
- **Exact odds or refusal:** Decisions return exact probabilities where feasible, otherwise a sampled estimate or an explicit refusal.
- **MCP and CLI access:** Exposes ten tools over the Model Context Protocol and a command line for scripting.

## Good for

- Keep a consistent tone and temperament for a customer-facing or tutoring agent across sessions
- Audit which rules shaped an agent's stance on a given turn
- Route tasks to workers while keeping privacy and quota rules satisfied
- Test whether a persona's habits hold across many seeds before shipping

## Install

### Claude Code (Terminal)

```sh
claude mcp add probbit -- npx -y probbit
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "probbit": {
      "command": "npx",
      "args": [
        "-y",
        "probbit"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "probbit": {
      "command": "npx",
      "args": [
        "-y",
        "probbit"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "probbit": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "probbit"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "probbit": {
      "command": "npx",
      "args": [
        "-y",
        "probbit"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "probbit": {
      "command": "npx",
      "args": [
        "-y",
        "probbit"
      ]
    }
  }
}
```

## Tools

- `probbit_decide`: Runs the decision engine on a problem document.
- `probbit_run`: Executes a probbit-ir program.
- `probbit_evaluate`: Evaluates a decision model against rules.
- `probbit_persona_init`: Creates an individual from a persona and seed.
- `probbit_persona_turn`: Computes one turn's stance for an individual.
- `probbit_live_verify`: Replays a strand and checks every digest.

## FAQ

### Does probbit need an API key or network access?

The README says it runs fully offline with no API key and that nothing phones home.

### Does the stance guarantee the model's replies?

No. The README states the model still writes the words and may ignore the stance line.

### Which install methods are listed?

A shell installer for Linux and macOS, a PowerShell installer for Windows, npm, and manual archives from the releases page.

### Is probbit a memory store for facts?

The README says no; its memory is the individual's state and the replayable strand, not a fact store.

### Is probbit free?

Yes. probbit is open source, so you can use and self-host it for free.

### How do I add probbit to Claude Code?

Run this command in your terminal: claude mcp add probbit -- npx -y probbit

### What are the best alternatives to probbit?

The closest alternatives to probbit are ThoughtProof, metabrain, Quesen Deterministic Agent Decision Layer, Psyche Ai and Peon Mem.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [ThoughtProof](https://ai-powered.com/mcp/thoughtproof): ThoughtProof is a paid MCP server for agent tooling.
- [metabrain](https://ai-powered.com/mcp/metabrain): metabrain is an open-source MCP server for agent tooling.
- [Quesen Deterministic Agent Decision Layer](https://ai-powered.com/mcp/quesen-deterministic-agent-decision-layer): Quesen Deterministic Agent Decision Layer is a freemium MCP server for agent tooling.
- [Psyche Ai](https://ai-powered.com/mcp/psyche-ai): Psyche Ai is an open-source MCP server for agent tooling.
- [Peon Mem](https://ai-powered.com/mcp/peon-mem): Peon Mem is an open-source MCP server for agent tooling.
- [World Model MCP](https://ai-powered.com/mcp/world-model-mcp-2): World Model MCP is an open-source MCP server for agent tooling.
- [Artifactories — Agent communication for real work](https://ai-powered.com/mcp/artifactories-agent-communication-for-real-work): Artifactories — Agent communication for real work is a free MCP server for agent tooling.
- [mcp-memory-rs](https://ai-powered.com/mcp/mcp-memory-rs): mcp-memory-rs is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/probbit
