MCP 服务器

Kaspa MCP

Enables users to manage Kaspa wallets, check balances, and send KAS tokens directly on the Kaspa blockDAG. It provides tools for transaction fee estimation and retrieving detailed transaction history across mainnet and testnet environments.

README

Kaspa MCP

MCP server for sending KAS on the Kaspa blockDAG.

About Kaspa

Kaspa is a fast, scalable Layer-1 cryptocurrency built on proof-of-work (PoW) and powered by the GHOSTDAG protocol — a novel consensus mechanism that extends Nakamoto's original design. Unlike traditional blockchains that discard competing blocks, GHOSTDAG allows parallel blocks to coexist and orders them within a Directed Acyclic Graph (blockDAG), enabling high throughput while preserving decentralization and security.

Key Features:

10 blocks per second with sub-second finality (Crescendo upgrade, May 2025)
Proof of Work using kHeavyHash algorithm
Fair launch - no premine, no ICO, no token allocations
Decentralized - runs on standard hardware

Installation

npm install
npm run build

Configuration

Set these environment variables:

Variable	Required	Description
`KASPA_MNEMONIC`	Yes*	BIP39 mnemonic phrase (24 words)
`KASPA_PRIVATE_KEY`	Yes*	Hex-encoded private key (alternative to mnemonic)
`KASPA_NETWORK`	No	Network: `mainnet`, `testnet-10`, `testnet-11`. Defaults to `mainnet`
`KASPA_ACCOUNT_INDEX`	No	BIP44 account index when using mnemonic. Defaults to `0`

*Either KASPA_MNEMONIC or KASPA_PRIVATE_KEY must be set.

Usage with Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "kaspa": {
      "command": "npx",
      "args": ["kaspa-mcp"],
      "env": {
        "KASPA_MNEMONIC": "your twenty four word mnemonic phrase here ...",
        "KASPA_NETWORK": "mainnet"
      }
    }
  }
}

Tools

`get_my_address`

Get the Kaspa address derived from your configured private key or mnemonic.

Returns: { address: string }

`get_balance`

Get balance for a Kaspa address.

Parameters:

address (optional): Address to check. Defaults to your wallet address.

Returns: { address: string, balance: string, utxoCount: number }

`get_fee_estimate`

Get current fee estimates from the network.

Returns: { priorityFee: string, normalFee: string, lowFee: string }

`send_kaspa`

Send KAS tokens to a recipient.

Parameters:

to: Recipient Kaspa address (must match wallet network)
amount: Amount in KAS as string (e.g., "10.5", max 8 decimal places)
priorityFee (optional): Priority fee in sompi

Returns: { txId: string, fee: string }

Validations:

Address format and network prefix validation
Amount must be a valid positive decimal number
Maximum 8 decimal places (1 sompi = 0.00000001 KAS)
Insufficient balance check before broadcast

`get_transaction`

Get transaction details including inputs and outputs.

Parameters:

txId: Transaction ID

Returns:

{
  txId: string,
  accepted: boolean,
  blockHash?: string,
  blockTime?: number,
  inputs: Array<{ transactionId: string, index: number }>,
  outputs: Array<{ index: number, amount: string, address: string }>
}