stacks-mcp-server
> **This repository has been archived.** Development has moved to [aibtc-mcp-server](https://github.com/aibtcdev/aibtc-mcp-server).
# Stacks MCP Server
A Model Context Protocol (MCP) server that provides Stacks blockchain functionality for AI assistants like Claude.
## Tools
### Account Management
- **`generate_account`** - Generate a new Stacks account with private key
- **`get_account_balance`** - Check STX balance for any Stacks address
### Blockchain Information
- **`get_network_status`** - Get current network status and info
- **`get_block_info`** - Get block details by height or hash
- **`get_transaction_info`** - Get transaction details by ID
- **`search_transactions`** - Search transactions by address
### Configuration
- **`check_api_status`** - Check API key status and rate limits
## Quick Start
### Using with Claude Desktop
Add to your Claude Desktop config file:
**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%\ClaudeTDQS
Scored across 8 tools
Each tool has a clearly distinct purpose: account generation, balance lookup, transaction info, network status, transaction search, block info, read-only contract calls, and API status. No two tools overlap in what they do, making selection unambiguous.
All tool names follow a consistent verb_noun pattern with lowercase and underscores (e.g., generate_account, get_balance, search_transactions). The verbs are varied but consistent in style, and the nouns clearly indicate the resource being acted upon.
With 8 tools, the server is within the ideal 3-15 range. Each tool covers a distinct aspect of Stacks blockchain interaction without being overwhelming or sparse, making the count well-scoped.
The tool set covers core query and read-only operations: accounts, balances, transactions, blocks, network status, and contract reads. However, there is no tool for submitting transactions or write operations, which could be a gap for a full blockchain interaction server, though it may be intended for read-only/query use.