by GoPlausible
Provides a Model Context Protocol (MCP) server for Algorand blockchain interactions and a client library for wallet management and transaction signing, enabling seamless integration of Algorand data and tools into LLM-powered agents.
The project delivers a full‑stack MCP server that exposes Algorand blockchain operations (account, asset, application, transaction, and query APIs) as MCP tools and resources. It also includes a client package for wallet connectivity and transaction signing, intended for use in browser or Node.js environments.
Claude/mcp-servers).npm install.npm run build..env file (network URLs, tokens, wallet mnemonic, optional DeFi integrations, etc.).npx -y algorand-mcp.Q: Which Node.js version is required? A: Node.js v23.6.1 or later (npm v10.2.4+).
Q: Do I need to run both server and client? A: The server is production‑ready; the client is still work‑in‑progress and optional for wallet‑related use cases.
Q: How are environment variables set?
A: Create a .env file at the project root and populate keys such as ALGORAND_NETWORK, ALGORAND_ALGOD_API, ALGORAND_INDEXER_API, ALGORAND_AGENT_WALLET, and any optional service flags (VESTIGE_ACTIVE, TINYMEN_ACTIVE, etc.).
Q: Can I disable optional DeFi integrations?
A: Yes, set the corresponding <SERVICE>_ACTIVE flag to false in the .env file.
Q: How do I add the server to Claude or Cursor?
A: Add an entry under mcpServers in the agent’s MCP config JSON, using the node command with the path to packages/server/dist/index.js (or use the npx shortcut provided below).
Model context protocol or MCP, is an open protocol that standardizes how applications provide context to LLMs. MCP provides specification standards to give LLMs tools, resources and instructions to be more useful and effective.
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:
📦 Packages in this repository:
📦 NPM:
To install or update the Algorand MCP implementation, clone the repository, install the dependencies and build the project":
First check node version to be 23.6.1 or later:
node -v
Upgrade to 23.6.1 or later if needed!
Then check the Claude or Cursor container folders to have mcp-servers folder (if not create one):
mkdir PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# or for Cursor
mkdir PATH_ON_YOUR_MACHINE/Cursor/mcp-servers
Then clone this repository under mcp-servers folder and install dependencies:
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
# Edit the .env file to set your configurations
And you are done! Now you can open you MCP config and add the server as :
{
"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",
"VESTIGE_ACTIVE": "false",
"ULTRADE_API_URL": "https://api.ultrade.io",
"VESTIGE_API_URL": "https://api.vestigelabs.org",
"VESTIGE_API_KEY": "",
"ITEMS_PER_PAGE": "10"
}
}
}
}
Make sure yopu change the paths to match your local system's paths.
For example on MACOS and Claud, the path would be something like this:
{
"mcpServers": {
"algorand-mcp": {
"command": "node",
"args": [
" /Users/YOUR_USERNAME/Library/Application\ Support/Claude/mcp-servers/algorand-mcp/packages/server/dist/index.js"
]
}
}
}
The project follows a modular architecture with two main packages:
Server Package (@algorand-mcp/server)
Client Package (@algorand-mcp/client)
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 (User-invokable endpoints)
│ │ │ ├── knowledge/ # Documentation and taxonomy
│ │ │ │ ├── taxonomy/ # Markdown documentation
│ │ │ │ └── index.ts # Knowledge resource handler
│ │ │ ├── wallet/ # Wallet management
│ │ │ │ └── index.ts # Wallet resource handler
│ │ │ └── index.ts # Resource registration
│ │ ├── tools/ # MCP Tools (Agent-invokable operations)
│ │ │ ├── accountManager.ts # Account operations
│ │ │ ├── algodManager.ts # Node interactions
│ │ │ ├── utilityManager.ts # Utility functions
│ │ │ ├── apiManager/ # API Tools
│ │ │ │ ├── algod/ # Algod API tools
│ │ │ │ ├── indexer/ # Indexer API tools
│ │ │ │ ├── nfd/ # NFDomains tools
│ │ │ │ ├── vestige/ # Vestige DeFi tools
│ │ │ │ ├── tinyman/ # Tinyman AMM tools
│ │ │ │ └── ultrade/ # Ultrade DEX tools
│ │ │ └── transactionManager/ # Transaction handling
│ │ ├── env.ts # Environment configuration
│ │ └── index.ts # Server entry point
│ ├── package.json
│ └── tsconfig.json
├── package.json # Root package file
└── tsconfig.json # Root TypeScript config
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 standardized format:
{
"error": {
"code": string,
"message": string
}
}
The Algorand MCP implementation provides 125 tools and resources for blockchain interaction:
MIT
Please log in to share your review and rating for this MCP.
Explore related MCPs that share similar capabilities and solve comparable challenges
by modelcontextprotocol
A Model Context Protocol server for Git repository interaction and automation.
by zed-industries
A high‑performance, multiplayer code editor designed for speed and collaboration.
by modelcontextprotocol
Model Context Protocol Servers
by modelcontextprotocol
A Model Context Protocol server that provides time and timezone conversion capabilities.
by cline
An autonomous coding assistant that can create and edit files, execute terminal commands, and interact with a browser directly from your IDE, operating step‑by‑step with explicit user permission.
by upstash
Provides up-to-date, version‑specific library documentation and code examples directly inside LLM prompts, eliminating outdated information and hallucinated APIs.
by daytonaio
Provides a secure, elastic infrastructure that creates isolated sandboxes for running AI‑generated code with sub‑90 ms startup, unlimited persistence, and OCI/Docker compatibility.
by continuedev
Enables faster shipping of code by integrating continuous AI agents across IDEs, terminals, and CI pipelines, offering chat, edit, autocomplete, and customizable agent workflows.
by github
Connects AI tools directly to GitHub, enabling natural‑language interactions for repository browsing, issue and pull‑request management, CI/CD monitoring, code‑security analysis, and team collaboration.
{
"mcpServers": {
"algorand-mcp": {
"command": "npx",
"args": [
"-y",
"algorand-mcp"
],
"env": {
"ALGORAND_NETWORK": "<YOUR_NETWORK>",
"ALGORAND_ALGOD_API": "<ALGOD_API_URL>",
"ALGORAND_ALGOD": "<ALGOD_BASE_URL>",
"ALGORAND_INDEXER_API": "<INDEXER_API_URL>",
"ALGORAND_INDEXER": "<INDEXER_BASE_URL>",
"ALGORAND_TOKEN": "<ALGOD_TOKEN>",
"ALGORAND_AGENT_WALLET": "<MNEMONIC>",
"NFD_API_URL": "https://api.nf.domains",
"NFD_API_KEY": "<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": "<VESTIGE_API_KEY>",
"ITEMS_PER_PAGE": "10"
}
}
}
}claude mcp add algorand-mcp npx -y algorand-mcp