playbooks
Learn Cursor Rules Windsurf Rules MCPs Modes
Log in

Algorand MCP server

Provides a robust toolkit for Algorand blockchain interactions, enabling AI agents to create accounts, manage assets, deploy smart contracts, and execute transactions through a TypeScript-based implementation.
Back to servers
Setup instructions
Provider
GoPlausible
Release date
Mar 17, 2025
Language
TypeScript
Package
npm
Stats
1.1K downloads
32 stars
View on GitHub

Algorand MCP is a server implementation that provides standardized tools and resources for interacting with the Algorand blockchain through the Model Context Protocol (MCP). It enables AI assistants to perform Algorand blockchain operations including account management, transactions, asset operations, and application interactions.

Installation

To install the Algorand MCP server:

Prerequisites

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

Step 1: Verify Node.js Version

node -v

Make sure you have version 23.6.1 or later installed.

Step 2: Create MCP Servers Directory

For Claude:

mkdir PATH_ON_YOUR_MACHINE/Claude/mcp-servers

For Cursor:

mkdir PATH_ON_YOUR_MACHINE/Cursor/mcp-servers

Step 3: Clone and Setup the Repository

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

Configuration

After installation, you need to configure the MCP server in your AI assistant's config file:

{
  "mcpServers": {
    "algorand-mcp": {
      "command": "node",
      "args": [
        "PATH_ON_YOUR_MACHINE/Claude/mcp-servers/algorand-mcp/packages/server/dist/index.js"
      ],
      "env": {
        "ALGORAND_NETWORK": "testnet",
        "ALGORAND_ALGOD_API": "https://testnet-api.algonode.cloud/v2",
        "ALGORAND_ALGOD": "https://testnet-api.algonode.cloud",
        "ALGORAND_INDEXER_API": "https://testnet-idx.algonode.cloud/v2",
        "ALGORAND_INDEXER": "https://testnet-idx.algonode.cloud",
        "ALGORAND_ALGOD_PORT": "",
        "ALGORAND_INDEXER_PORT": "",
        "ALGORAND_TOKEN": "",
        "ALGORAND_AGENT_WALLET": "problem aim online jaguar upper oil flight stumble mystery aerobic toy avoid file tomato moment exclude witness guard lab opera crunch noodle dune abandon broccoli",
        "NFD_API_URL": "https://api.nf.domains",
        "NFD_API_KEY": "",
        "TINYMAN_ACTIVE": "false",
        "ULTRADE_ACTIVE": "false",
        "ULTRADE_API_URL": "https://api.ultrade.io",
        "VESTIGE_ACTIVE": "false",
        "VESTIGE_API_URL": "https://api.vestigelabs.org",
        "VESTIGE_API_KEY": "",
        "ITEMS_PER_PAGE": "10"
      }
    }
  }
}

Replace PATH_ON_YOUR_MACHINE with your actual system path. For example, on macOS with Claude:

{
  "mcpServers": {
    "algorand-mcp": {
      "command": "node",
      "args": [
        "/Users/YOUR_USERNAME/Library/Application Support/Claude/mcp-servers/algorand-mcp/packages/server/dist/index.js"
      ]
    }
  }
}

Using the MCP Server

The Algorand MCP server provides over 125 tools for blockchain interaction, grouped into several categories:

Core Functionality Categories

Account Management

  • Create and manage Algorand accounts
  • Validate addresses
  • Handle account rekeying

Asset Operations

  • Create, configure, transfer, freeze and destroy assets

Application Interactions

  • Deploy, update, and delete applications
  • Make application calls
  • Compile TEAL code

Transaction Operations

  • Create and sign different transaction types
  • Submit transactions to the network
  • Simulate transactions before submission

Blockchain Queries

  • Get account information and balances
  • Query asset details
  • Check application state
  • Search transactions

API Integration

The server integrates with various Algorand ecosystem APIs:

Algod API

Access node status, account information, pending transactions, and more.

Indexer API

Search for accounts, applications, assets, and transactions with various filters.

NFDomains (NFD) API

Query and interact with Algorand's naming service.

Optional DeFi Integrations

  • Vestige (analytics)
  • Tinyman (AMM)
  • Ultrade (DEX)

Response Format

All responses follow a standardized format:

{
  "data": {
    // Response data here
  },
  "metadata": {  // Only for paginated responses
    "totalItems": number,
    "itemsPerPage": number,
    "currentPage": number,
    "totalPages": number,
    "hasNextPage": boolean,
    "pageToken": string,
    "arrayField": string  // Name of paginated array field
  }
}

Errors are returned in a consistent format:

{
  "error": {
    "code": string,
    "message": string
  }
}

Available Knowledge Resources

The server provides comprehensive Algorand documentation through its knowledge taxonomy:

  • Full documentation taxonomy (algorand://knowledge/taxonomy)
  • ARCs documentation (algorand://knowledge/taxonomy/arcs)
  • SDK documentation (algorand://knowledge/taxonomy/sdks)
  • AlgoKit documentation (algorand://knowledge/taxonomy/algokit)
  • AlgoKit Utils documentation (algorand://knowledge/taxonomy/algokit-utils)
  • TEALScript documentation (algorand://knowledge/taxonomy/tealscript)
  • Puya documentation (algorand://knowledge/taxonomy/puya)
  • Liquid Auth documentation (algorand://knowledge/taxonomy/liquid-auth)
  • Python documentation (algorand://knowledge/taxonomy/python)
  • Developer documentation (algorand://knowledge/taxonomy/developers)
  • CLI tools documentation (algorand://knowledge/taxonomy/clis)
  • Node management documentation (algorand://knowledge/taxonomy/nodes)
  • Technical details documentation (algorand://knowledge/taxonomy/details)

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "algorand-mcp" '{"command":"node","args":["PATH_ON_YOUR_MACHINE/Claude/mcp-servers/algorand-mcp/packages/server/dist/index.js"],"env":{"ALGORAND_NETWORK":"testnet","ALGORAND_ALGOD_API":"https://testnet-api.algonode.cloud/v2","ALGORAND_ALGOD":"https://testnet-api.algonode.cloud","ALGORAND_INDEXER_API":"https://testnet-idx.algonode.cloud/v2","ALGORAND_INDEXER":"https://testnet-idx.algonode.cloud","ALGORAND_ALGOD_PORT":"","ALGORAND_INDEXER_PORT":"","ALGORAND_TOKEN":"","ALGORAND_AGENT_WALLET":"problem aim online jaguar upper oil flight stumble mystery aerobic toy avoid file tomato moment exclude witness guard lab opera crunch noodle dune abandon broccoli","NFD_API_URL":"https://api.nf.domains","NFD_API_KEY":"","TINYMAN_ACTIVE":"false","ULTRADE_ACTIVE":"false","ULTRADE_API_URL":"https://api.ultrade.io","VESTIGE_ACTIVE":"false","VESTIGE_API_URL":"https://api.vestigelabs.org","VESTIGE_API_KEY":"","ITEMS_PER_PAGE":"10"}}'

See the official Claude Code MCP documentation for more details.

For 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 > Tools & Integrations and click "New MCP Server".

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

{
    "mcpServers": {
        "algorand-mcp": {
            "command": "node",
            "args": [
                "PATH_ON_YOUR_MACHINE/Claude/mcp-servers/algorand-mcp/packages/server/dist/index.js"
            ],
            "env": {
                "ALGORAND_NETWORK": "testnet",
                "ALGORAND_ALGOD_API": "https://testnet-api.algonode.cloud/v2",
                "ALGORAND_ALGOD": "https://testnet-api.algonode.cloud",
                "ALGORAND_INDEXER_API": "https://testnet-idx.algonode.cloud/v2",
                "ALGORAND_INDEXER": "https://testnet-idx.algonode.cloud",
                "ALGORAND_ALGOD_PORT": "",
                "ALGORAND_INDEXER_PORT": "",
                "ALGORAND_TOKEN": "",
                "ALGORAND_AGENT_WALLET": "problem aim online jaguar upper oil flight stumble mystery aerobic toy avoid file tomato moment exclude witness guard lab opera crunch noodle dune abandon broccoli",
                "NFD_API_URL": "https://api.nf.domains",
                "NFD_API_KEY": "",
                "TINYMAN_ACTIVE": "false",
                "ULTRADE_ACTIVE": "false",
                "ULTRADE_API_URL": "https://api.ultrade.io",
                "VESTIGE_ACTIVE": "false",
                "VESTIGE_API_URL": "https://api.vestigelabs.org",
                "VESTIGE_API_KEY": "",
                "ITEMS_PER_PAGE": "10"
            }
        }
    }
}

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 explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "algorand-mcp": {
            "command": "node",
            "args": [
                "PATH_ON_YOUR_MACHINE/Claude/mcp-servers/algorand-mcp/packages/server/dist/index.js"
            ],
            "env": {
                "ALGORAND_NETWORK": "testnet",
                "ALGORAND_ALGOD_API": "https://testnet-api.algonode.cloud/v2",
                "ALGORAND_ALGOD": "https://testnet-api.algonode.cloud",
                "ALGORAND_INDEXER_API": "https://testnet-idx.algonode.cloud/v2",
                "ALGORAND_INDEXER": "https://testnet-idx.algonode.cloud",
                "ALGORAND_ALGOD_PORT": "",
                "ALGORAND_INDEXER_PORT": "",
                "ALGORAND_TOKEN": "",
                "ALGORAND_AGENT_WALLET": "problem aim online jaguar upper oil flight stumble mystery aerobic toy avoid file tomato moment exclude witness guard lab opera crunch noodle dune abandon broccoli",
                "NFD_API_URL": "https://api.nf.domains",
                "NFD_API_KEY": "",
                "TINYMAN_ACTIVE": "false",
                "ULTRADE_ACTIVE": "false",
                "ULTRADE_API_URL": "https://api.ultrade.io",
                "VESTIGE_ACTIVE": "false",
                "VESTIGE_API_URL": "https://api.vestigelabs.org",
                "VESTIGE_API_KEY": "",
                "ITEMS_PER_PAGE": "10"
            }
        }
    }
}

3. Restart Claude Desktop for the changes to take effect

Want to 10x your AI skills?

Get a free account and learn to code + market your apps using AI (with or without vibes!).

Nah, maybe later