MIMIR MCP server

mimir-decisions

Decisions your agents can act on. MIMIR is a non-generative decision model: give it a context, a question and the options, and get back a typed answer with calibrated probabilities, the evidence behind it, and a certified verdict on whether to act or escalate. No text generated. Nothing to parse. Nothing to hallucinate.

It beats Laya and GLiNER2.5-Decide head-to-head on six of ten tasks — by 54.7 points on Banking77, 42.3 on MASSIVE, 36.3 on typed decisions — and where it cannot back an answer, it abstains instead of guessing.

pip install "mimir-decisions[local]"        # the local engine (CPU and CUDA)
pip install mimir-decisions                  # data models and HTTP client only

Python 3.11+. Documentation:

Why MIMIR

Most agents route, classify, and verify using a general-purpose language model: slow, expensive, and impossible to audit. MIMIR is built for structured decisions. It runs on Torch in milliseconds, returns calibrated probabilities with every answer, and issues a certificate — measured evidence that answers passing its threshold stayed at or below the risk level you ask for, on held-out data.

• No generation. Answers are drawn from the options you supply, not synthesised. The model cannot hallucinate an answer that wasn't on the list.
• Calibrated confidence. Probabilities are not softmax scores; they are calibrated to match realised accuracy on held-out data.
• Answers, always. Every decision returns the model's prediction with its probabilities. In threshold and certified modes, answers below the floor come back deferred for review — never withheld.
• One typed contract. Seven decision types — choice, multi-choice, yes/no, verify, rank, rate, estimate — all returning the same result shape, over any context.
• Portable. The same Python interface works locally on CPU or GPU, over HTTP, and over MCP. Framework adapters exist for eight agent SDKs.

Quickstart

from mimir import Mimir

model = Mimir.from_pretrained("Mythologic/MIMIR-1")
result = model.choose(
    "Hi, we were billed twice for March. Please refund the duplicate today or we will cancel our plan.",
    "Which department should handle this request?",
    options={
        "billing": "Billing: invoices, payments, refunds",
        "technical": "Technical: bugs, outages, system errors",
        "sales": "Sales: pricing, new contracts",
        "other": "Other: everything else",
    },
)

result.status         # Status.DECIDED, Status.ABSTAINED or Status.DEFERRED
result.answer         # an option id, or None when no option applies
result.probabilities  # calibrated probability of each option id
result.certificate    # the evidence, when the answer is certified

answer is always the model's prediction. status says whether it cleared the operating floor:

• DECIDED — act on answer.
• ABSTAINED — no listed option applies.
• DEFERRED — the answer came in below the floor; have a person review it. The answer is still there.

Give the model the ticket as a person wrote it — the same options over a one-line summary can come back ABSTAINED. The Decisions guide covers the question and option shapes that decide.

The first call downloads the model from the Hugging Face Hub at the revision this package version pins, verifies its Sigstore signature, checks every file against the manifest's SHA-256, and loads it.

Decision types

Shortened. The full README is on GitHub.