Stacks

Provides an MCP server to interact with the Stacks blockchain for wallets, trading, stacking, and portfolio tracking.

typescript

0

GitHub Stars

typescript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kai-builder-stacksagent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "stacksagent-mcp"
      ],
      "env": {
        "STACKS_NETWORK": "mainnet"
      }
    }
  }
}

This MCP server lets Claude Desktop talk to the Stacks blockchain to manage wallets, swap tokens, stack STX for BTC rewards, and track your portfolio through natural conversations. It exposes practical tools for everyday blockchain actions and is designed as a concise MVP with ongoing enhancements.

How to use

Start by installing or building the server, then add it to Claude Desktop so you can interact with Stacks through natural language prompts. You will unlock your wallet to perform actions like checking balances, getting swap quotes, trading tokens, stacking STX, and viewing your portfolio. Use simple questions or commands to explore available capabilities and verify that the tools respond with clear summaries and transaction details.

How to install

Prerequisites: you need Node.js 18 or higher and Claude Desktop installed.

Option 1: Install from npm (when published)

npm install -g stacksagent-mcp

Option 2: Build from source (recommended)

Clone the repository, install dependencies, and build the project. Note the absolute path to the built file dist/index.js as you will need it for configuration.

git clone https://github.com/kai-builder/stacksagent-mcp.git
cd stacksagent-mcp
npm install
npm run build

Additional installation notes

When you are ready to connect Claude Desktop, you must restart Claude Desktop after updating the MCP configuration so the new server becomes available.

The server can be run in two ways as shown in the configuration examples below. Choose the one that matches how you installed it.

Available tools

wallet_create

Create a new wallet with encrypted storage and a mnemonic phrase.

wallet_import

Import an existing wallet from a mnemonic or private key into the local keystore.

wallet_unlock

Unlock the wallet to perform sensitive actions like swaps or staking.

wallet_lock

Lock the wallet to protect keys when not actively used.

wallet_get_address

Retrieve the current wallet address.

wallet_get_balance

Query STX and token balances for the wallet.

wallet_status

Check if a wallet exists and whether it is unlocked.

market_get_price

Fetch real-time token prices in USD.

market_get_tokens

List trending or newly available tokens.

market_get_pools

List liquidity pools with APY information.

dex_quote

Get swap quotes from supported DEX routes.

dex_swap

Execute a token swap with slippage protection.

dex_add_liquidity

Add liquidity to a pool.

dex_remove_liquidity

Remove liquidity from a pool.

stacking_get_info

Get current PoX cycle information and rewards pricing.

stacking_get_status

Check the current stacking status.

stacking_stack

Submit a request to stack STX for BTC rewards.

stacking_delegate

Delegate to a stacking pool.

portfolio_summary

Provide a comprehensive portfolio summary.

portfolio_transactions

Show the wallet's transaction history.

portfolio_history

Show portfolio value over time.