1Money Network MCP

MCP (stdio) server for the 1Money Network Protocol, backed by @1money/protocol-ts-sdk.

What This MCP Server Does

• Exposes protocol API endpoints (accounts, tokens, transactions, checkpoints, chain) as MCP tools.

• Includes utility tools for signing, hashing, RLP encoding, and address derivation.

• Uses the SDK client configuration and respects network/base URL/timeouts.

Related MCP server: BCH MCP Server

Configuration

Environment variables:

• ONEMONEY_PROTOCOL_NETWORK: testnet, mainnet, or local (default: testnet)

• ONEMONEY_PROTOCOL_BASE_URL: override the network base URL

• ONEMONEY_PROTOCOL_TIMEOUT_MS: request timeout in ms (default: 10000)

• ONEMONEY_PROTOCOL_HEADERS: optional JSON string of headers to include in all requests (only needed for custom gateways/proxies)

Example .env file (see .env.example):

export ONEMONEY_PROTOCOL_NETWORK=testnet
export ONEMONEY_PROTOCOL_TIMEOUT_MS=15000

Most users can omit ONEMONEY_PROTOCOL_HEADERS.

Integration

Cursor (one-click install)

After installation, add your configuration to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "1money-network": {
      "command": "npx",
      "args": ["-y", "@1money/network-mcp"],
      "env": {
        "ONEMONEY_PROTOCOL_NETWORK": "testnet"
      }
    }
  }
}

Claude Code

Run the following command in your terminal:

claude mcp add --transport stdio 1money-network --env ONEMONEY_PROTOCOL_NETWORK=testnet -- npx -y @1money/network-mcp

Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\\Claude\\claude_desktop_config.json

{
  "mcpServers": {
    "1money-network": {
      "command": "npx",
      "args": ["-y", "@1money/network-mcp"],
      "env": {
        "ONEMONEY_PROTOCOL_NETWORK": "testnet"
      }
    }
  }
}

Codex Integration

Add the MCP server to your Codex config file, then restart Codex:

[mcp_servers.1money-network]
command = "npx"
args = ["-y", "@1money/network-mcp"]
env = { ONEMONEY_PROTOCOL_NETWORK = "testnet" }

Example Tool Calls

{
  "tool": "accounts.get_nonce",
  "input": {
    "address": "0x9E1E9688A44D058fF181Ed64ddFAFbBE5CC74ff3"
  }
}

{
  "tool": "transactions.estimate_fee",
  "input": {
    "from": "0x9E1E9688A44D058fF181Ed64ddFAFbBE5CC74ff3",
    "value": "1000000000",
    "token": "0x2cd8999Be299373D7881f4aDD11510030ad1412F"
  }
}

{
  "tool": "utils.sign_message",
  "input": {
    "payload": [
      1212101,
      2,
      "0x0000000000000000000000000000000000000000",
      "1000000000000000000",
      "0x0000000000000000000000000000000000000000"
    ],
    "private_key": "0xYOUR_PRIVATE_KEY"
  }
}

Note: utils.sign_message accepts a private key directly. Avoid using real keys in shared environments.

Example Prompts

• "Get the current chain id."

• "Fetch the latest checkpoint number on testnet."

• "Estimate fee for sending 1000000000 units from 0x... with token 0x...."

• "Get token metadata for 0x...."

• "Derive the token account address for wallet 0x... and mint 0x...."

Tools

accounts

• accounts.get_nonce

• accounts.get_bbnonce

• accounts.get_token_account

chain

• chain.get_chain_id

checkpoints

• checkpoints.get_number

• checkpoints.get_by_hash

• checkpoints.get_by_number

• checkpoints.get_receipts_by_number

tokens

• tokens.get_token_metadata

• tokens.manage_blacklist

• tokens.manage_whitelist

• tokens.burn

• tokens.grant_authority

• tokens.issue

• tokens.mint

• tokens.pause

• tokens.update_metadata

• tokens.bridge_and_mint

• tokens.burn_and_bridge

transactions

• transactions.get_by_hash

• transactions.get_receipt_by_hash

• transactions.get_finalized_by_hash

• transactions.estimate_fee

• transactions.payment

utils

• utils.derive_token_address

• utils.sign_message

• utils.encode_payload

• utils.to_hex

• utils.calc_tx_hash

• utils.typeof

• utils.safe_promise_all

• utils.safe_promise_line

Batch tools (utils.safe_promise_all and utils.safe_promise_line) accept a calls array of { tool, input } objects. The safe_promise_all variant executes in parallel and fails on the first error. The safe_promise_line variant executes sequentially and ignores errors.

Schema

schemas/tools.json is the JSON Schema source for all tools.