Skip to content
MCP server

Psyseal scan

Offline scan of local AI agent folders for heartbeat cost, exposed keys and planted memory

Runs locallyStatus and history
Pricing
Freemium
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.3.3
Listing updated
3 days ago

About Psyseal scan

Psyseal scan is a freemium MCP server for security. It runs locally on your machine and is started by your AI client.

Agents that wake on a schedule reload their instructions and memory each time, and that adds up on the bill. This scanner reads the files of agents on your own computer, including OpenClaw, Hermes Agent, nanobot, PicoClaw, ZeroClaw, NanoClaw or any agent folder, and reports what loads on every message and what heartbeats and scheduled tasks cost.

It also looks for plaintext secrets in memory or skills and for memory that looks planted or bloated, attaching a concrete fix to each finding. The README says it reads files only, uses no network, writes or deletes nothing, has no dependencies and needs Node.js 20 or newer. The website's worked example puts a 100,000-token context against a lean 2,000 to 5,000 tokens per run; that is an illustration and your figure depends on your agent and model.

As an MCP server it exposes the same scan as one read-only tool, scan_agents, over stdio. It can also run as npx psyseal-scan or be installed as an agent skill. The scanner is MIT-0 licensed; the separate Psyseal cleanup and signed seal service is paid.

Install

Run in a terminal

claude mcp add psyseal-scan -- npx -y psyseal-scan

Add to claude_desktop_config.json

{
  "mcpServers": {
    "psyseal-scan": {
      "command": "npx",
      "args": [
        "-y",
        "psyseal-scan"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "psyseal-scan": {
      "command": "npx",
      "args": [
        "-y",
        "psyseal-scan"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "psyseal-scan": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "psyseal-scan"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "psyseal-scan": {
      "command": "npx",
      "args": [
        "-y",
        "psyseal-scan"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "psyseal-scan": {
      "command": "npx",
      "args": [
        "-y",
        "psyseal-scan"
      ]
    }
  }
}

Tools this server provides (1)

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

scan_agents
Runs the read-only scan of local agent folders.

What it does

Heartbeat cost estimate
Calculates what scheduled runs cost based on how much context each one loads.
Plaintext secret detection
Finds keys left in agent memory or skill files.
Planted and bloated memory
Flags memory entries that look injected or unusually large.
Fix per finding
Each result comes with a concrete suggested fix.
Read-only and offline
Reads files only, makes no network calls and has no dependencies.
Multiple entry points
Run it with npx, as an agent skill or through the scan_agents MCP tool.

Good for

  • Find out why an always-on agent is expensive to run
  • Check agent folders for leaked API keys before sharing them
  • Spot suspicious instructions added to an agent's memory
  • Run a pre-publish check on a skill or agent repository

Pricing

Freemium, from $8.99 a month

Scanner free (MIT-0); Psyseal cleanup and seal from $8.99 USD a month

Prices change. Check psyseal.com before you buy.

Psyseal scan FAQ

Does it send data anywhere?

No. The README says it uses no network and only reads files.

Which agents does it check?

OpenClaw, Hermes Agent, nanobot, PicoClaw, ZeroClaw, NanoClaw or any folder passed with --path.

What does it cost?

The scanner is free under MIT-0. Cleanup and sealing is a separate paid service from $8.99 USD a month.

What does it require?

Node.js 20 or newer.

Is Psyseal scan free?

Psyseal scan has a free plan, with paid plans for more usage or features. Paid plans start at $8.99 a month.

How do I add Psyseal scan to Claude Code?

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

What are the best alternatives to Psyseal scan?

The closest alternatives to Psyseal scan are REA, Claude Code Ultimate Guide, Agent Roast, Midplane and Leash.

Alternatives to Psyseal scan

  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. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  3. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  4. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  5. Leash

    MCP server

    Review what your AI touched, approve risky actions and undo supported changes

    • 1 tool
    • Remote
    • Free
    • 1 GitHub star
    • Security