Algorand MCP Server

<!-- Use this file to provide workspace-specific custom instructions to Copilot. For more details, visit https://code.visualstudio.com/docs/copilot/copilot-customization#_use-a-githubcopilotinstructionsmd-file --> # MCP Server Project Instructions This is a Model Context Protocol (MCP) server project designed to work with AI assistants. It provides Algorand blockchain transaction capabilities along with general utility tools. ## Key Information - **Framework**: TypeScript with MCP SDK - **Purpose**: Provides blockchain tools and general capabilities to AI assistants through the Model Context Protocol - **Blockchain**: Algorand network integration with secure transaction capabilities - **SDK Reference**: https://github.com/modelcontextprotocol/create-python-server - **Documentation**: You can find more info and examples at https://modelcontextprotocol.io/llms-full.txt - **Algoran Docs**: https://www.npmjs.com/package/@algorandfoundation/algokit-utils ## Development Guidelines 1. Use the MCP SDK types and patterns consistently 2. Implement proper error handling for tool execution, especially for blockchain operations 3. Use Zod schemas for input validation 4. Follow TypeScript best practices 5. Ensure tools are well-documented with clear descriptions 6. **Security First**: Handle mnemonic phrases and private keys securely 7. **Network Safety**: Default to testnet for development and testing ## Current Tools ### General Tools - **echo**: Simple message echoing for testing - **calculate**: Basic mathematical expression evaluation - **get_current_time**: Timezone-aware time retrieval ### Algorand Blockchain Tools - **generate_algorand_account**: Generate new Algorand accounts - **get_account_info**: Query account information and balances - **send_payment**: Send Algo payment transactions - **create_asset**: Create Algorand Standard Assets (ASAs) - **opt_in_to_asset**: Opt into assets before receiving them - **transfer_asset**: Transfer assets between accounts - **get_asset_info**: Query asset information - **get_transaction**: Get transaction details ## Security Considerations - **Mnemonic Phrases**: Never log or expose mnemonic phrases in error messages - **Environment Variables**: Use `.env` files for network configuration - **Default to Testnet**: Always default to testnet for development - **Input Validation**: Validate all blockchain parameters strictly - **Error Handling**: Provide clear error messages without exposing sensitive data ## Testing - Use the provided MCP configuration in `.vscode/mcp.json` for debugging - Test tools individually before integrating with AI assistants - Always test on testnet before using mainnet - Validate input schemas thoroughly - Test error scenarios and edge cases ## Algorand Development - Use AlgoSDK for low-level blockchain operations - Leverage AlgoKit Utils for higher-level abstractions - Implement proper transaction confirmation waiting - Handle network connectivity issues gracefully - Support multiple Algorand networks (testnet, mainnet, localnet)