Model context protocol:
Quoting from MCP website, MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to LLMs. Think of MCP like a USB-C port for AI applications. Just as USB-C provides a standardized way to connect your devices to various peripherals and accessories, MCP provides a standardized way to connect AI models to different data sources and tools.
MCP Github contains more information and different tools and specifications plus documentation of MCP.
This repository is a Model Context Protocol (MCP) implementation for Algorand blockchain interactions. The implementation consists of:
- (PRODUCTION) A server package for blockchain interactions (Node.js only)
- (WIP) A client package for wallet management and transaction signing (supports both browser and Node.js)
📦 Packages:
- Algorand MCP Server - Algorand MCP server full implementation.
- Algorand MCP Client - Algorand MCP Client for client side Wallet management and transaction signing, as well as integration by other Agent hosts.
📦 Smithery:
- Algorand MCP Server on Smithery - Algorand MCP server implementation via smithery.
IMPORTANT: The client package is still a work in progress and is not yet fully functional. The server package, however, is fully operational and can be used for to integrate Algorand blockchain to any agent system that supports Model Context Protocol (MCP).
- Complete Algorand blockchain interaction capabilities
- Extensive wallet management system
- Comprehensive transaction handling
- Rich blockchain state querying
- Built-in security features
- Support for Claude Desktop and Cursor integration
- Node.js v23.6.1 or later
- npm v10.2.4 or later
# Install both client and server packages
npm install algorand-mcp
Go to Algorand MCP Server on Smithery and select your AI tool and platform. Copy either command or copy depending on if you are using the command or MCP config JSON to connect to MCP Server. Click connect to start!
First let's copy the command from Smithery (Please make sure your tool of choice and platform are selected correctly!)
Then paste that in the command field of New MCP server dialog
Then The MCP server is detected and loading tools and resources
And it is good to go!
Copy the JSON from Smithery
Now open MCP settings in your tool of choice (Claud Desktop, Cursor,...) and Paste the copied JSON there as a whole and save the file.
You are good to go!
Please not that if you receive "Server Closed" or "Connection Closed" Then you need to try and change the cmd command with C:\Windows\System32\cmd.exe as suggested by Smithery!
Cursor does not yet support the Resources Capability of MCP protocol! They are working on it.
| Client | [Resources] | [Prompts] | [Tools] | [Sampling] | Roots | Notes |
|---|---|---|---|---|---|---|
| [Claude Desktop App][Claude] | ✅ | ✅ | ✅ | ❌ | ❌ | Full support for all MCP features |
| [5ire][5ire] | ❌ | ❌ | ✅ | ❌ | ❌ | Supports tools. |
| [BeeAI Framework][BeeAI Framework] | ❌ | ❌ | ✅ | ❌ | ❌ | Supports tools in agentic workflows. |
| [Cline][Cline] | ✅ | ❌ | ✅ | ❌ | ❌ | Supports tools and resources. |
| [Continue][Continue] | ✅ | ✅ | ✅ | ❌ | ❌ | Full support for all MCP features |
| [Cursor][Cursor] | ❌ | ❌ | ✅ | ❌ | ❌ | Supports tools. |
| [Emacs Mcp][Mcp.el] | ❌ | ❌ | ✅ | ❌ | ❌ | Supports tools in Emacs. |
| [Firebase Genkit][Genkit] | ✅ | ✅ | ❌ | ❌ | Supports resource list and lookup through tools. | |
| [GenAIScript][GenAIScript] | ❌ | ❌ | ✅ | ❌ | ❌ | Supports tools. |
| [Goose][Goose] | ❌ | ❌ | ✅ | ❌ | ❌ | Supports tools. |
| [LibreChat][LibreChat] | ❌ | ❌ | ✅ | ❌ | ❌ | Supports tools for Agents |
| [mcp-agent][mcp-agent] | ❌ | ❌ | ✅ | ❌ | Supports tools, server connection management, and agent workflows. | |
| [oterm][oterm] | ❌ | ❌ | ✅ | ❌ | ❌ | Supports tools. |
| [Roo Code][Roo Code] | ✅ | ❌ | ✅ | ❌ | ❌ | Supports tools and resources. |
| [Sourcegraph Cody][Cody] | ✅ | ❌ | ❌ | ❌ | ❌ | Supports resources through OpenCTX |
| [Superinterface][Superinterface] | ❌ | ❌ | ✅ | ❌ | ❌ | Supports tools |
| [TheiaAI/TheiaIDE][TheiaAI/TheiaIDE] | ❌ | ❌ | ✅ | ❌ | ❌ | Supports tools for Agents in Theia AI and the AI-powered Theia IDE |
| [Windsurf Editor][Windsurf] | ❌ | ❌ | ✅ | ❌ | ❌ | Supports tools with AI Flow for collaborative development. |
| [Zed][Zed] | ❌ | ✅ | ❌ | ❌ | ❌ | Prompts appear as slash commands |
| [SpinAI][SpinAI] | ❌ | ❌ | ✅ | ❌ | ❌ | Supports tools for Typescript AI Agents |
| [OpenSumi][OpenSumi] | ❌ | ❌ | ✅ | ❌ | ❌ | Supports tools in OpenSumi |
| [Daydreams Agents][Daydreams] | ✅ | ✅ | ✅ | ❌ | ❌ | Support for drop in Servers to Daydreams agents |
The project follows a modular architecture with two main packages:
-
Server Package (
@algorand-mcp/server)- Provides MCP tools and resources
- Manages blockchain interactions
- Handles transaction creation and submission
- Offers comprehensive blockchain queries
-
Client Package (
@algorand-mcp/client)- Handles wallet connections and transaction signing
- Supports both local and external wallets
- Universal compatibility (browser/Node.js)
- Secure credential management
- Still work in progress (Server works irrelevant to client status)
algorand-mcp/
├── packages/
│ ├── client/ # Client Package
│ │ ├── src/
│ │ │ ├── index.ts # Client entry point and wallet management
│ │ │ └── LocalWallet.ts # Local wallet implementation
│ │ ├── package.json
│ │ └── tsconfig.json
│ └── server/ # Server Package
│ ├── src/
│ │ ├── resources/ # MCP Resources
│ │ │ ├── algod/ # Real-time blockchain state
│ │ │ └── indexer/ # Historical blockchain data
│ │ ├── tools/ # MCP Tools
│ │ │ ├── accountManager.ts # Account operations
│ │ │ ├── algodManager.ts # Node interactions
│ │ │ ├── utilityManager.ts # Utility functions
│ │ │ └── transactionManager/ # Transaction handling
│ │ │ ├── accountTransactions.ts
│ │ │ ├── assetTransactions.ts
│ │ │ ├── generalTransaction.ts
│ │ │ └── appTransactions/
│ │ ├── env.ts # Environment configuration
│ │ └── index.ts # Server entry point
│ ├── package.json
│ └── tsconfig.json
├── package.json # Root package file
└── tsconfig.json # Root TypeScript config
- Local wallet with secure storage
- External wallet support (Pera, Defly, Daffi)
- Transaction signing
- Session management
- Universal ES module support
- Account management
- Asset operations
- Application interactions
- Transaction creation and submission
- Blockchain state queries
- Comprehensive utility functions
The Algorand MCP implementation provides 100+ tools and resources for blockchain interaction. For detailed documentation and usage instructions, please refer to the server package README.
- resource_tool_get_account_info: Get current account balance, assets, and auth address from algod
- resource_tool_get_account_application_info: Get account-specific application information from algod
- resource_tool_get_account_asset_info: Get account-specific asset information from algod
- resource_tool_get_application_by_id: Get application information
- resource_tool_get_application_box: Get application box by name
- resource_tool_get_application_boxes: Get all application boxes
- resource_tool_get_asset_by_id: Get current asset information from algod
- resource_tool_get_pending_transaction: Get pending transaction information
- resource_tool_get_pending_transactions_by_address: Get pending transactions for an address
- resource_tool_get_pending_transactions: Get all pending transactions
- resource_tool_get_transaction_params: Get suggested transaction parameters
- resource_tool_get_node_status: Get current node status
- resource_tool_get_node_status_after_block: Get node status after a specific round
- resource_tool_lookup_account_by_id: Get account information from indexer
- resource_tool_lookup_account_transactions: Get account transaction history
- resource_tool_lookup_account_assets: Get account assets
- resource_tool_lookup_account_app_local_states: Get account application local states
- resource_tool_lookup_account_created_applications: Get applications created by this account
- resource_tool_lookup_applications: Get application information from indexer
- resource_tool_lookup_application_logs: Get application log messages
- resource_tool_lookup_application_box: Get application box by name
- resource_tool_lookup_application_boxes: Get all application boxes
- resource_tool_lookup_asset_by_id: Get asset information and configuration
- resource_tool_lookup_asset_balances: Get accounts holding this asset and their balances
- resource_tool_lookup_asset_transactions: Get transactions involving this asset
- resource_tool_lookup_transaction_by_id: Get transaction information by ID
- resource_tool_search_accounts: Search for accounts with various criteria
- resource_tool_search_for_applications: Search for applications with various criteria
- resource_tool_search_for_assets: Search for assets with various criteria
- resource_tool_search_for_transactions: Search for transactions with various criteria
- create_account
- rekey_account
- mnemonic_to_mdk
- mdk_to_mnemonic
- secret_key_to_mnemonic
- mnemonic_to_secret_key
- seed_from_mnemonic
- mnemonic_from_seed
- validate_address
- encode_address
- decode_address
- make_app_create_txn
- make_app_update_txn
- make_app_delete_txn
- make_app_optin_txn
- make_app_closeout_txn
- make_app_clear_txn
- make_app_call_txn
- get_application_address
- make_asset_create_txn
- make_asset_config_txn
- make_asset_destroy_txn
- make_asset_freeze_txn
- make_asset_transfer_txn
- make_payment_txn
- assign_group_id
- sign_transaction
- sign_bytes
- send_raw_transaction
- simulate_raw_transactions
- generate_key_pair
- derive_key
- encode_obj
- decode_obj
- bytes_to_bigint
- bigint_to_bytes
- encode_uint64
- decode_uint64
- compile_teal
- disassemble_teal
- accounts/{address}
- accounts/{address}/application/{app-id}
- accounts/{address}/asset/{asset-id}
- applications/{app-id}
- applications/{app-id}/box/{name}
- applications/{app-id}/boxes
- assets/{asset-id}
- transactions/pending/{txid}
- accounts/{address}/transactions/pending
- transactions/pending
- transactions/params
- status
- blocks/latest
- blocks/{round}
- blocks/{round}/transactions
- indexer/blocks/{round}
- health
- indexer/health
- genesis
- indexer/genesis
- versions
- metrics
- ledger/supply
- indexer/supply
- participation
- participation/keys
- participation/keys/{id}
- transactions/fee
- indexer/fee-distribution
- protocol
- indexer/protocol-upgrades
- ready
- sync
- peers
- catchup
- compile/teal
- compile/teal/disassemble
- compile/teal/dryrun
- debug/accounts/{address}
- debug/txns/{txid}
- debug/blocks/{round}
- debug/ledger
- indexer/accounts/{address}
- indexer/accounts/{address}/transactions
- indexer/accounts/{address}/apps-local-state
- indexer/accounts/{address}/created-applications
- indexer/applications/{app-id}
- indexer/applications/{app-id}/logs
- indexer/applications/{app-id}/box/{name}
- indexer/applications/{app-id}/boxes
- indexer/applications
- indexer/assets/{asset-id}
- indexer/assets/{asset-id}/balances
- indexer/assets/{asset-id}/transactions
- indexer/assets/{asset-id}/balances/{address}
- indexer/assets/{asset-id}/transactions/{txid}
- indexer/assets
- indexer/transactions/{txid}
- indexer/transactions
Note: The server path in the configuration should be the absolute path to your compiled server's index.js file.
- algosdk: Algorand JavaScript SDK
- @perawallet/connect: Pera Wallet connector
- @blockshake/defly-connect: Defly Wallet connector
- @daffiwallet/connect: Daffi Wallet connector
MIT