@manifest-network/manifest-mcp-node

Node.js CLI entry points for the Manifest MCP servers with stdio transport and encrypted keyfile wallet.

Provides three binaries:

• manifest-mcp-chain -- Chain MCP server (5 tools: queries, transactions, module discovery)
• manifest-mcp-lease -- Lease MCP server (6 tools: credit balance, funding, lease queries, SKUs, providers)
• manifest-mcp-fred -- Fred MCP server (8 tools: catalog, deployment, status, logs, restart, update, diagnostics, releases)

Setup

# From the monorepo root
npm install
npm run build

Wallet setup

All three servers need a wallet to sign transactions. Choose one of the options below.

Option A -- Generate a new keyfile (recommended)

npx manifest-mcp-chain keygen

All CLIs share the same keyfile (~/.manifest/key.json), so any of the three commands works for keygen and import. You will be prompted for an encryption password. The keyfile is written with mode 0600.

Option B -- Import an existing mnemonic

npx manifest-mcp-chain import

You will be prompted for your mnemonic (any valid BIP-39 length: 12, 15, 18, 21, or 24 words) and an encryption password. The wallet is derived from the mnemonic, encrypted, and stored in the same keyfile location. The raw mnemonic is not retained.

Option C -- Mnemonic via environment variable (fallback)

Set COSMOS_MNEMONIC in your .env or shell environment. This is used only when no keyfile exists.

Wallet resolution order

1. If the keyfile exists at the path specified by MANIFEST_KEY_FILE (default ~/.manifest/key.json), use it
2. Otherwise, if COSMOS_MNEMONIC is set, use it
3. Exit with an error if neither is available

CLI reference

manifest-mcp-chain                Start the chain MCP server (stdio)
manifest-mcp-chain keygen         Generate a new encrypted keyfile
manifest-mcp-chain import         Import a mnemonic into an encrypted keyfile

manifest-mcp-lease                Start the lease MCP server (stdio)
manifest-mcp-lease keygen         Generate a new encrypted keyfile
manifest-mcp-lease import         Import a mnemonic into an encrypted keyfile

manifest-mcp-fred                 Start the fred MCP server (stdio)
manifest-mcp-fred keygen          Generate a new encrypted keyfile
manifest-mcp-fred import          Import a mnemonic into an encrypted keyfile

MCP client integration

Claude Desktop

Add the following to your claude_desktop_config.json:

Replace the placeholder values below with your actual chain ID, RPC/REST endpoint, gas price, and keyfile password.

{
  "mcpServers": {
    "manifest-chain": {
      "command": "npx",
      "args": ["manifest-mcp-chain"],
      "env": {
        "COSMOS_CHAIN_ID": "your-chain-id",
        "COSMOS_RPC_URL": "https://your-rpc-endpoint/",
        "COSMOS_GAS_PRICE": "0.01umfx",
        "MANIFEST_KEY_PASSWORD": "your-keyfile-password"
      }
    },
    "manifest-lease": {
      "command": "npx",
      "args": ["manifest-mcp-lease"],
      "env": {
        "COSMOS_CHAIN_ID": "your-chain-id",
        "COSMOS_RPC_URL": "https://your-rpc-endpoint/",
        "COSMOS_GAS_PRICE": "0.01umfx",
        "MANIFEST_KEY_PASSWORD": "your-keyfile-password"
      }
    },
    "manifest-fred": {
      "command": "npx",
      "args": ["manifest-mcp-fred"],
      "env": {
        "COSMOS_CHAIN_ID": "your-chain-id",
        "COSMOS_RPC_URL": "https://your-rpc-endpoint/",
        "COSMOS_GAS_PRICE": "0.01umfx",
        "MANIFEST_KEY_PASSWORD": "your-keyfile-password"
      }
    }
  }
}

If you use a mnemonic instead of a keyfile, replace MANIFEST_KEY_PASSWORD with COSMOS_MNEMONIC.

Query-only mode (REST/LCD)

To use query-only mode without transaction signing, replace COSMOS_RPC_URL and COSMOS_GAS_PRICE with COSMOS_REST_URL:

{
  "mcpServers": {
    "manifest-chain": {
      "command": "npx",
      "args": ["manifest-mcp-chain"],
      "env": {
        "COSMOS_CHAIN_ID": "your-chain-id",
        "COSMOS_REST_URL": "https://your-rest-endpoint/",
        "MANIFEST_KEY_PASSWORD": "your-keyfile-password"
      }
    }
  }
}

A wallet is still required at startup even in query-only mode. Transaction tools will return an INVALID_CONFIG error.

Environment variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | COSMOS_CHAIN_ID | Yes | -- | Chain ID (e.g. manifest-ledger-beta) | | COSMOS_RPC_URL | One of COSMOS_RPC_URL or COSMOS_REST_URL required | -- | RPC endpoint URL (HTTPS required; HTTP allowed for localhost) | | COSMOS_GAS_PRICE | Required when COSMOS_RPC_URL is set | -- | Gas price with denom (e.g. 0.01umfx) | | COSMOS_REST_URL | One of COSMOS_RPC_URL or COSMOS_REST_URL required | -- | LCD/REST endpoint URL for query-only mode | | COSMOS_ADDRESS_PREFIX | No | manifest | Bech32 address prefix | | MANIFEST_KEY_FILE | No | ~/.manifest/key.json | Path to the encrypted keyfile | | MANIFEST_KEY_PASSWORD | No | -- | Password to decrypt the keyfile | | COSMOS_MNEMONIC | No | -- | BIP-39 mnemonic (fallback when no keyfile exists) | | LOG_LEVEL | No | warn | Log level: debug, info, warn, error, or silent |

Set COSMOS_RPC_URL + COSMOS_GAS_PRICE for full access (queries + transactions). Set COSMOS_REST_URL alone for query-only mode (LCD/REST). When both are set, COSMOS_REST_URL is preferred for queries.

COSMOS_CHAIN_ID and at least one endpoint URL are only required when starting an MCP server, not for keygen or import.

Chain server tools (5)

| Tool | Description | |------|-------------| | get_account_info | Get account address for the configured key | | cosmos_query | Execute any Cosmos SDK query command | | cosmos_tx | Execute any Cosmos SDK transaction | | list_modules | List all available query and transaction modules | | list_module_subcommands | List available subcommands for a specific module |

Lease server tools (6)

| Tool | Description | |------|-------------| | credit_balance | Query on-chain credit balance | | fund_credit | Send tokens to the billing account | | leases_by_tenant | List leases for the current account by state | | close_lease | Close a lease on-chain | | get_skus | List available SKUs | | get_providers | List available providers |

Fred server tools (8)

| Tool | Description | |------|-------------| | browse_catalog | Browse available providers and service tiers with health checks | | deploy_app | Deploy a new application (create lease + deploy container) | | app_status | Get detailed status for a deployed app by lease UUID | | get_logs | Get logs for a deployed app by lease UUID | | restart_app | Restart a deployed app via the provider | | update_app | Update a deployed app with a new manifest | | app_diagnostics | Get provision diagnostics for a deployed app | | app_releases | Get release/version history for a deployed app |

License

MIT