Back to Browse

Kaspa Script MCP Server

Developer ToolsModerate7.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

Disassemble Kaspa script hex, estimate compute cost, explain txscript errors, look up opcodes.

About

Disassemble Kaspa script hex, estimate compute cost, explain txscript errors, look up opcodes.

Security Report

7.2
Moderate7.2Low Risk

This is a pure-computation MCP server for disassembling Kaspa scripts, estimating compute cost, explaining txscript errors, and looking up opcodes. It has no network, filesystem, shell, or environment access, and no credentials, malicious patterns, or dangerous operations were found. Findings are limited to low-severity quality issues: a cost-budget formula with an unexplained divisor, a README claim of no SDK dependency that conflicts with package.json, and the absence of input-size limits on the cost and opcode tools. Supply chain analysis found 2 known vulnerabilities in dependencies (0 critical, 1 high severity). Package verification found 1 issue.

8 files analyzed · 7 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "kaspa-script-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "kaspa-script-mcp@0.1.0"
      ]
    }
  }
}

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub README.

kaspa-script-mcp

An MCP server with tooling for Kaspa's Toccata-era script/covenant layer. Pure TypeScript, no node or SDK dependency at runtime — the opcode table and pricing constants are generated from rusty-kaspa v2.1.0 (commit 01b532e).

Tools

  • disassemble_script — hex → opcodes + data pushes, the way the engine's parser walks it; flags disabled/reserved opcodes and truncated pushes.
  • estimate_script_cost — approximate script units, compute-mass grams, share of the 500,000-gram block compute limit, and the minimum per-input compute budget to commit. Size a budget before signing to avoid ExceededCommittedScriptUnits.
  • explain_script_error — plain-language explanation + fix for txscript errors (metering, stack, opcode, push-encoding, ZK integrity).
  • lookup_opcode — by hex code or name.

Install

No build needed. Add it to your MCP client (Claude Code, Claude Desktop, Cursor, VS Code):

{ "mcpServers": { "kaspa-script": { "command": "npx", "args": ["-y", "kaspa-script-mcp"] } } }

In Claude Code: claude mcp add kaspa-script -- npx -y kaspa-script-mcp

Build from source

npm install && npm run build
node dist/selftest.js   # 17 checks
node dist/index.js      # stdio MCP server

To run a local build instead, point the client at it:

{ "mcpServers": { "kaspa-script": { "command": "node", "args": ["<path>/kaspa-script-mcp/dist/index.js"] } } }

Scope & honesty

estimate_script_cost is an estimate of the dominant charges (per-byte, pushed bytes, hash opcodes, fixed ZK costs), not the consensus value; ZK per-public-input VK pricing isn't fully derivable statically and is flagged in the output. The opcode table and constants are pinned to a specific rusty-kaspa commit; regenerate on consensus changes.

License

MIT

Reviews

No reviews yet

Be the first to review this server!