Glama
Sign In

Algorand MCP

by GoPlausible
npmGitHub
TypeScript
MIT License
110
5
  • Linux
  • Apple
RedditDiscord
OverviewInspectSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Provides comprehensive Algorand blockchain interaction capabilities, including account management, asset operations, application interactions, transaction creation/submission, and blockchain state queries.

  • Provides a server package for Algorand blockchain interactions specifically built for Node.js environments.

  • Uses TypeScript for type-safe interaction with the Algorand blockchain across both client and server implementations.

Algorand MCP Implementation

Overview

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:

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).

Features

  • 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

Requirements

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

Installation

Via NPM (for developers who wish to run their own instances)

# Install both client and server packages npm install algorand-mcp

Via Smithery (For all users)

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!

Using command

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!

Using settings JSON

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!

Important note for Windows OS Users

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!

Important note for Cursor Users

Cursor does not yet support the Resources Capability of MCP protocol! They are working on it.

MCP Server Feature support matrix

Client[Resources][Prompts][Tools][Sampling]RootsNotes
[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

Project Architecture

The project follows a modular architecture with two main packages:

  1. Server Package (@algorand-mcp/server)
    • Provides MCP tools and resources
    • Manages blockchain interactions
    • Handles transaction creation and submission
    • Offers comprehensive blockchain queries
  2. 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)

Project Structure

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

Core Functionalities

Client Features

  • Local wallet with secure storage
  • External wallet support (Pera, Defly, Daffi)
  • Transaction signing
  • Session management
  • Universal ES module support

Server Features

  • Account management
  • Asset operations
  • Application interactions
  • Transaction creation and submission
  • Blockchain state queries
  • Comprehensive utility functions

Available Tools and Resources

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.

Available Tools (40)

Account Management Tools

  • 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

Application Tools

  • 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

Asset Tools

  • make_asset_create_txn
  • make_asset_config_txn
  • make_asset_destroy_txn
  • make_asset_freeze_txn
  • make_asset_transfer_txn

Transaction Tools

  • make_payment_txn
  • assign_group_id
  • sign_transaction
  • sign_bytes
  • send_raw_transaction
  • simulate_raw_transactions

Key Management Tools

  • generate_key_pair
  • derive_key

Utility Tools

  • encode_obj
  • decode_obj
  • bytes_to_bigint
  • bigint_to_bytes
  • encode_uint64
  • decode_uint64
  • compile_teal
  • disassemble_teal

Available Resources (60)

Algod Resources

  • 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

Block Resources

  • blocks/latest
  • blocks/{round}
  • blocks/{round}/transactions
  • indexer/blocks/{round}

Health Resources

  • health
  • indexer/health

Genesis Resources

  • genesis
  • indexer/genesis

Network Resources

  • versions
  • metrics

Supply Resources

  • ledger/supply
  • indexer/supply

Participation Resources

  • participation
  • participation/keys
  • participation/keys/{id}

Fee Resources

  • transactions/fee
  • indexer/fee-distribution

Protocol Resources

  • protocol
  • indexer/protocol-upgrades

Node Resources

  • ready
  • sync
  • peers
  • catchup

Compile Resources

  • compile/teal
  • compile/teal/disassemble
  • compile/teal/dryrun

Debug Resources

  • debug/accounts/{address}
  • debug/txns/{txid}
  • debug/blocks/{round}
  • debug/ledger

Indexer Resources

  • 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.

Dependencies

  • algosdk: Algorand JavaScript SDK
  • @perawallet/connect: Pera Wallet connector
  • @blockshake/defly-connect: Defly Wallet connector
  • @daffiwallet/connect: Daffi Wallet connector

License

MIT

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

A comprehensive MCP server for tooling interactions(40+) and resource accessibility(60+) with Algorand blockchain, plus many useful prompts.

  1. Overview
    1. Features
      1. Requirements
        1. Installation
          1. Via NPM (for developers who wish to run their own instances)
            1. Via Smithery (For all users)
              1. Using command
                1. Using settings JSON
                  1. Important note for Windows OS Users
                    1. Important note for Cursor Users
                      1. MCP Server Feature support matrix
                    2. Project Architecture
                      1. Project Structure
                        1. Core Functionalities
                          1. Client Features
                            1. Server Features
                            2. Available Tools and Resources
                              1. Available Tools (40)
                                1. Account Management Tools
                                  1. Application Tools
                                    1. Asset Tools
                                      1. Transaction Tools
                                        1. Key Management Tools
                                          1. Utility Tools
                                          2. Available Resources (60)
                                            1. Algod Resources
                                              1. Block Resources
                                                1. Health Resources
                                                  1. Genesis Resources
                                                    1. Network Resources
                                                      1. Supply Resources
                                                        1. Participation Resources
                                                          1. Fee Resources
                                                            1. Protocol Resources
                                                              1. Node Resources
                                                                1. Compile Resources
                                                                  1. Debug Resources
                                                                    1. Indexer Resources
                                                                  2. Dependencies
                                                                    1. License

                                                                      Related Resources