Algorand Blockchain Integration MCP Server

Overview

The Algorand Blockchain Integration is a Model Context Protocol (MCP) implementation that provides comprehensive tools for interacting with the Algorand blockchain. It includes a server package for blockchain interactions and a client package (work in progress) for wallet management and transaction signing.

Installation

Prerequisites

• Node.js v23.6.1 or later
• npm v10.2.4 or later

Installation Steps

1. First, verify your Node.js version:

   node -v
   

   Upgrade to Node.js 23.6.1 or later if needed.

2. Create an MCP servers directory in your Claude or Cursor application folder:

   mkdir PATH_ON_YOUR_MACHINE/Claude/mcp-servers
   # or for Cursor
   mkdir PATH_ON_YOUR_MACHINE/Cursor/mcp-servers
   

3. Clone the repository and install dependencies:

   cd PATH_ON_YOUR_MACHINE/Claude/mcp-servers
   # or for Cursor
   cd PATH_ON_YOUR_MACHINE/Cursor/mcp-servers
   
   # Clone the repository
   git clone https://github.com/GoPlausible/algorand-mcp.git
   cd algorand-mcp
   
   # Install dependencies
   npm install
   
   # Build the project
   npm run build
   

4. Configure your environment by editing the environment variables in your MCP configuration.

Configuration

The Algorand MCP server can be configured with the following environment variables:

• ALGORAND_NETWORK: Network to connect to (testnet, mainnet)
• ALGORAND_ALGOD_API: Algod API endpoint
• ALGORAND_ALGOD: Algod base URL
• ALGORAND_INDEXER_API: Indexer API endpoint
• ALGORAND_INDEXER: Indexer base URL
• ALGORAND_ALGOD_PORT: Algod port (if needed)
• ALGORAND_INDEXER_PORT: Indexer port (if needed)
• ALGORAND_TOKEN: API token (if needed)
• ALGORAND_AGENT_WALLET: Mnemonic for the agent wallet
• NFD_API_URL: NFD API URL (for NFD integration)
• NFD_API_KEY: NFD API key (if needed)
• TINYMAN_ACTIVE: Enable/disable Tinyman integration
• ULTRADE_ACTIVE: Enable/disable Ultrade integration
• ULTRADE_API_URL: Ultrade API URL
• VESTIGE_ACTIVE: Enable/disable Vestige integration
• VESTIGE_API_URL: Vestige API URL
• VESTIGE_API_KEY: Vestige API key
• ITEMS_PER_PAGE: Number of items per page for paginated results

Usage

Once installed and configured, the Algorand MCP server provides a comprehensive set of tools for interacting with the Algorand blockchain. You can:

• Access the complete Algorand documentation and knowledge taxonomy
• Manage wallets and accounts
• Create, sign, and submit transactions
• Query blockchain state and account information
• Interact with Algorand Standard Assets (ASAs)
• Work with smart contracts and applications
• Integrate with DeFi platforms like Tinyman, Ultrade, and Vestige (when enabled)

The server handles all the complexity of blockchain interactions, allowing you to focus on your specific use cases and applications.

Features

• Complete Algorand Documentation Integration: Access the full Algorand knowledge taxonomy, developer documentation, ARCs, SDKs, and tools documentation directly.
• Blockchain Interaction: Comprehensive capabilities for interacting with the Algorand blockchain.
• Wallet Management: Extensive system for managing wallets and accounts.
• Transaction Handling: Create, sign, and submit various types of transactions.
• Blockchain State Querying: Rich capabilities for querying the blockchain state.
• Security Features: Built-in security features to protect sensitive operations.
• Integration Support: Support for Claude Desktop and Cursor integration.