Skip to content
MCP server

Strategic Agent Reasoning MCP

Belief-desire-intention reasoning engine for agents: goals, utility scoring and replanning

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.4.1
Listing updated
1 day ago

About Strategic Agent Reasoning MCP

Strategic Agent Reasoning MCP is an open-source MCP server for ai models and llm tooling. It runs locally on your machine and is started by your AI client.

This server gives an agent an explicit decision loop rather than leaving planning implicit in a prompt. Beliefs carry confidence that decays exponentially and is swept by time-to-live, goals decompose into directed acyclic graphs with progress rolling up from the leaves, and candidate actions are ranked by multi-attribute expected utility over weights for aggression, caution, greed, exploration, efficiency and cooperation. Each proposal gets a risk score covering failure probability, reversibility and worst-case blast radius.

The 15 tools split into ten deliberation tools and five fast decision primitives. The fast layer runs locally with in-memory caches and no external calls: classify, ask_noul, ask_choice, ask_score and a gate_intention check that issues signed HMAC dispatch tokens. Its README reports cache-hit latencies in microseconds on Node 22, and it credits the typed pattern to TypeSafe's Jev.

Selected actions become intentions queued for runtime engines, with explainable decision traces and a SHA-256 Merkle audit of the reasoning database. The site stresses it provides functional agency, not consciousness. It is MIT licensed and starts with npx.

Install

Run in a terminal

claude mcp add agent-reasoning-mcp -- npx -y @putervision/agent-reasoning-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "agent-reasoning-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@putervision/agent-reasoning-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "agent-reasoning-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@putervision/agent-reasoning-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "agent-reasoning-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@putervision/agent-reasoning-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "agent-reasoning-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@putervision/agent-reasoning-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "agent-reasoning-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@putervision/agent-reasoning-mcp"
      ]
    }
  }
}

Tools this server provides (15)

Taken from the project documentation; the running server may differ.

set_goal
Manages goal hierarchy, task DAGs and success criteria.
evaluate_situation
Scores and ranks candidate actions from environment snapshots.
replan
Rebuilds subgoals after blockers or events and aborts stale intentions.
assess_risk
Calculates failure, reversibility and blast-radius risk for actions or plans.
query_knowledge
Searches heuristics, tactics and past decision patterns.
set_utility_weights
Configures and activates utility weight profiles.
get_decision_trace
Returns explainable rationale and latency stats.
manage_beliefs
Maintains beliefs with exponential confidence decay.
manage_intentions
Creates, dispatches and tracks intention directives.
manage_reasoning_db
Provides stats, audit, snapshots and restore.
classify
Fast categorical labelling over state packets.
ask_noul
Typed probabilistic Boolean verification.
ask_choice
Discrete one-of-N choice selection.
ask_score
Bounded numeric utility scoring.
gate_intention
Blast-radius audit gate issuing signed dispatch tokens.

What it does

Hierarchical goals
Decomposes objectives into DAGs with rolled-up progress.
Expected utility ranking
Scores actions against configurable utility weights.
Risk assessment
Rates failure severity, reversibility and blast radius.
Belief decay
Fades belief confidence over time and sweeps stale facts.
Reactive replanning
Rebuilds goals when blockers or events arrive.
Fast decision primitives
Five local tools for labelling, probability, choice and scoring.
Audit and traces
Explainable decision traces and a Merkle audit.

Good for

  • Give an autonomous agent a structured plan with sub-goals
  • Rank possible actions under cautious or aggressive profiles
  • Check an action's blast radius before dispatching it
  • Replan when an unexpected blocker appears
  • Explain why an agent chose an action

Pricing

Open source

MIT licensed; free to run via npm

Prices change. Check agentreasoningmcp.com before you buy.

Strategic Agent Reasoning MCP FAQ

How do I start?

Run npx @putervision/agent-reasoning-mcp init, then doctor and inspect.

Does it call an external AI?

The fast layer runs locally with deterministic heuristics and no external API calls.

How many tools does it have?

15: ten strategic deliberation tools and five fast decision tools.

What licence?

MIT, per the README badge.

Is Strategic Agent Reasoning MCP free?

Yes. Strategic Agent Reasoning MCP is open source, so you can use and self-host it for free.

How do I add Strategic Agent Reasoning MCP to Claude Code?

Run this command in your terminal: claude mcp add agent-reasoning-mcp -- npx -y @putervision/agent-reasoning-mcp

What are the best alternatives to Strategic Agent Reasoning MCP?

The closest alternatives to Strategic Agent Reasoning MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Strategic Agent Reasoning MCP

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools