Algorand MCP server for AI agents

Algorand MCP is a comprehensive implementation of the Model Context Protocol for Algorand blockchain interactions. It provides a standardized way for applications to interact with the Algorand blockchain, offering tools for blockchain queries, transaction handling, and wallet management through an easy-to-use MCP server interface.

Installation Options

Via NPM

To install and run your own instance of the Algorand MCP server:

npm install algorand-mcp

Via Smithery (for Claude Desktop)

Run this command in your terminal to install and configure the server with Claude Desktop:

npx -y @smithery/cli@latest install @GoPlausible/algorand-mcp --client claude --config "{\"NFD_API_KEY\":\"\",\"NFD_API_URL\":\"https://api.nf.domains\",\"ALGORAND_ALGOD\":\"https://testnet-api.algonode.cloud\",\"ALGORAND_TOKEN\":\"\",\"ITEMS_PER_PAGE\":\"10\",\"VESTIGE_API_KEY\":\"\",\"VESTIGE_API_URL\":\"https://api.vestigelabs.org\",\"ALGORAND_INDEXER\":\"https://testnet-idx.algonode.cloud\",\"ALGORAND_NETWORK\":\"testnet\",\"ALGORAND_ALGOD_API\":\"https://testnet-api.algonode.cloud/v2\",\"ALGORAND_ALGOD_PORT\":\"\",\"ALGORAND_INDEXER_API\":\"https://testnet-idx.algonode.cloud/v2\",\"ALGORAND_INDEXER_PORT\":\"\"}"

Via Smithery (for Cursor)

Run this command in your terminal to install and configure the server with Cursor:

npx -y @smithery/cli@latest install @GoPlausible/algorand-mcp --client cursor --config "{\"NFD_API_KEY\":\"\",\"NFD_API_URL\":\"https://api.nf.domains\",\"ALGORAND_ALGOD\":\"https://testnet-api.algonode.cloud\",\"ALGORAND_TOKEN\":\"\",\"ITEMS_PER_PAGE\":\"10\",\"VESTIGE_API_KEY\":\"\",\"VESTIGE_API_URL\":\"https://api.vestigelabs.org\",\"ALGORAND_INDEXER\":\"https://testnet-idx.algonode.cloud\",\"ALGORAND_NETWORK\":\"testnet\",\"ALGORAND_ALGOD_API\":\"https://testnet-api.algonode.cloud/v2\",\"ALGORAND_ALGOD_PORT\":\"\",\"ALGORAND_INDEXER_API\":\"https://testnet-idx.algonode.cloud/v2\",\"ALGORAND_INDEXER_PORT\":\"\"}"

Important: When using Smithery UI, make sure to set ITEMS_PER_PAGE before clicking connect to ensure all environment variables are included in the command.

Server Features

The Algorand MCP server provides comprehensive capabilities for interacting with the Algorand blockchain:

Core Functionality

Blockchain Interaction: Query account balances, asset information, and application states
Transaction Handling: Create, sign, and submit various transaction types
Wallet Management: Create and manage Algorand accounts
Documentation Access: Built-in access to complete Algorand documentation
Third-Party Integrations: Support for NFDomains, Vestige DeFi, Tinyman AMM, and Ultrade DEX

Available Tool Categories

Account Management Tools: Create accounts, validate addresses, rekey accounts
Application Tools: Create, update, call and manage Algorand applications
Asset Tools: Create, configure, and transfer Algorand Standard Assets (ASAs)
Transaction Tools: Build, sign, and send various transaction types
Key Management Tools: Handle mnemonics, keys, and cryptographic operations
Utility Tools: Perform various conversion and helper operations

Using the MCP Server

Once installed, you can access the MCP server through the protocols specified by the Model Context Protocol. The server provides 125+ tools across various categories:

Account Operations Examples

To create a new Algorand account:

Tool: create_account

To validate an Algorand address:

Tool: validate_address
Params: {"address": "YOUR_ADDRESS_HERE"}

Transaction Examples

To create a payment transaction:

Tool: make_payment_txn
Params: {
  "from": "SENDER_ADDRESS",
  "to": "RECEIVER_ADDRESS",
  "amount": 1000000,
  "note": "Example payment"
}

To create an asset transfer:

Tool: make_asset_transfer_txn
Params: {
  "from": "SENDER_ADDRESS",
  "to": "RECEIVER_ADDRESS",
  "assetIndex": 12345,
  "amount": 1000
}

Blockchain Query Examples

To get account information:

Tool: api_algod_get_account_info
Params: {"address": "YOUR_ADDRESS_HERE"}

To get asset details:

Tool: api_indexer_lookup_asset_by_id
Params: {"assetId": 12345}

Response Format

All responses follow a standardized format:

For successful operations:

{
  "data": {
    // Response data here
  },
  "metadata": {  // Only for paginated responses
    "totalItems": 100,
    "itemsPerPage": 10,
    "currentPage": 1,
    "totalPages": 10,
    "hasNextPage": true,
    "pageToken": "token_string",
    "arrayField": "results"
  }
}

For errors:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Error description"
  }
}

Requirements

To run the Algorand MCP server, you need:

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

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.