@verusidx/definecurrency-mcp

@verusidx/definecurrency-mcp

MCP server for defining and launching new currencies on Verus — simple tokens, fractional basket currencies, centralized tokens, ID control tokens, and Ethereum ERC-20 mapped tokens.

Setup

Prerequisite: @verusidx/chain-mcp must be configured and refresh_chains called at least once so the chain registry exists.

Add to your MCP client config (e.g., Claude Code claude_desktop_config.json):

{
  "mcpServers": {
    "verusidx-definecurrency": {
      "command": "npx",
      "args": ["-y", "@verusidx/definecurrency-mcp"],
      "env": {}
    }
  }
}

Alternative: local install. If you prefer a pinned version or offline use, install into a project directory with npm install @verusidx/definecurrency-mcp (or pnpm add / yarn add) and point your config at the local path instead of using npx.

Environment Variables

Variable	Default	Description
VERUSIDX_READ_ONLY	false	Set to true to disable all tools. This is a write-only MCP — no tools are available in read-only mode.
VERUSIDX_AUDIT_LOG	true	Set to false to disable audit logging.
VERUSIDX_AUDIT_DIR	OS default	Custom directory for audit log files.

Read-Only Mode

This is a write-only MCP. Setting VERUSIDX_READ_ONLY=true disables the only tool (definecurrency), leaving zero tools registered.

Tools

Tool	Description
definecurrency	Define a new currency — returns signed tx hex to broadcast via sendrawtransaction (chain-mcp)

Launch Workflow

definecurrency creates a signed transaction but does not broadcast it:

• Ensure a VerusID with the currency name exists and is controlled by the wallet
• definecurrency — returns {txid, tx, hex}
• sendrawtransaction (chain-mcp) with the hex — broadcasts the definition
• Wait for the preconversion timeframe (minimum 20 blocks)
• getcurrency (chain-mcp) to verify the currency launched

Currency Types

Options	Type	Description
32	Simple token	Basic token, optionally with preconversion funding
33	Basket currency	Fractional reserve currency supporting on-chain conversions
2080	ID control token	Single-satoshi token granting revoke/recover authority

Common options shown. Combine values for variants (e.g., 41 = basket + referrals, 34 = token + ID-restricted). See tool-specs/definecurrency.md for the full options table, field reference, and examples.

Set proofprotocol: 2 for centralized tokens (rootID can mint/burn), or proofprotocol: 3 for Ethereum ERC-20 mapped tokens.

Audit Logging

All definecurrency calls are logged to date-stamped JSONL files in the audit directory. The hex is truncated in audit entries. Logs are append-only with 0600 permissions.

Requirements

• Node.js >= 18.0.0
• @verusidx/chain-mcp installed and refresh_chains called (chain registry must exist)
• At least one Verus daemon running
• A VerusID matching the currency name, controlled by the wallet