home / mcp / kaspa mcp server

Kaspa MCP Server

MCP server for sending Kaspa (KAS) on the Kaspa blockDAG with address derivation, balance checks, fee estimates, and transaction handling.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kasanova-io-kaspa-mcp": {
      "command": "npx",
      "args": [
        "kaspa-mcp"
      ],
      "env": {
        "KASPA_NETWORK": "mainnet",
        "KASPA_MNEMONIC": "your twenty four word mnemonic phrase here ...",
        "KASPA_PRIVATE_KEY": "<optional hex private key>",
        "KASPA_ACCOUNT_INDEX": "0"
      }
    }
  }
}

You can deploy and manage Kaspa transactions through a dedicated MCP server that connects to the Kaspa blockDAG. This server provides programmatic tools to derive addresses, check balances, estimate fees, construct, sign, and broadcast KAS transfers, and inspect transactions, enabling automated workflows and integrations with your applications.

How to use

You will run the MCP server locally and connect to it using an MCP client. Use the provided stdio configuration to start a local server process that accepts commands to derive addresses, fetch balances, estimate fees, send Kaspa, and retrieve transaction details. When you issue a send, the server handles address validation, balance checks, transaction construction, and network broadcast, returning the transaction identifier for tracking.

How to install

Prerequisites: ensure Node.js and npm are installed on your system.

# using npm to install and build the MCP server
npm install
npm run build

Configuration

Configure the MCP server to use Kaspa credentials and network details. The server exposes a stdio interface that you run locally with npx Kaspa MCP. The following configuration example shows how to start the MCP using the included CLI entry point and environment variables.

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

Tools

The Kaspa MCP provides a set of functions you can call to interact with Kaspa networks.

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

Get balance for a Kaspa address.

Get current fee estimates from the network.

Send Kaspa tokens to a recipient.

Get transaction details including inputs and outputs.

Available tools

get_my_address

Derives the Kaspa address from the configured private key or mnemonic.

get_balance

Retrieves the balance for a Kaspa address.

get_fee_estimate

Fetches current fee estimates from the Kaspa network.

send_kaspa

Constructs, signs, and broadcasts a Kaspa transfer to a recipient.

get_transaction

Returns details for a specific transaction, including inputs and outputs.