algorand-plugin

Algorand Plugin for Claude Code

Algorand blockchain integration for Claude Code — by GoPlausible

Features

• MCP Server: Bundled @goplausible/algorand-mcp (122 tools) — wallet, transactions, smart contracts, TEAL, indexer, DEX, NFD, Haystack Router, Alpha Arcade, knowledge base
• x402 Payment Protocol: Claude autonomously pays for x402-protected HTTP resources using Algorand
• 10 Skills:
  • algorand-development — AlgoKit CLI, project creation, general workflows
  • algorand-typescript — TypeScript smart contracts (Algorand TypeScript / PuyaTs)
  • algorand-python — Python smart contracts (Algorand Python / PuyaPy)
  • algorand-interaction — Blockchain interaction via MCP (wallet, transactions, swaps, NFD)
  • algorand-x402-typescript — Build x402 payment servers/clients in TypeScript
  • algorand-x402-python — Build x402 payment servers/clients in Python
  • algorand-x402-payment — Runtime x402 payments (Claude as autonomous client)
  • haystack-router-interaction — Best-price swaps via Haystack Router DEX aggregator
  • haystack-router-development — Build swap UIs and Node.js automation with Haystack Router SDK
  • alpha-arcade-interaction — Prediction markets on Algorand via Alpha Arcade
• Agent: algorand-agent for complex multi-step Algorand tasks
• Multi-network: mainnet, testnet, localnet
• Secure wallet: Per-transaction and daily spending limits, private keys never exposed

Installation

From marketplace (recommended)

Inside Claude Code, add the marketplace and install:

/plugin marketplace add GoPlausible/claude-algorand-plugin
/plugin install algorand-plugin@goplausible-claude-plugins

From directory (development/testing)

For quick testing without installation, load directly:

claude --plugin-dir /path/to/claude-algorand-plugin

Note: --plugin-dir is session-scoped — the plugin is only loaded for that session. Use marketplace installation for persistent access from any directory.

Prerequisites

• Node.js (v20+) — the MCP server runs via npx @goplausible/algorand-mcp@latest, which auto-downloads the package on first use

Update

/plugin marketplace update
/plugin update algorand-plugin@goplausible-claude-plugins

Validate installation

After installing, verify the plugin is loaded:

/plugin list                  # Should show algorand-plugin
/mcp                          # Should show algorand-mcp server
/algorand-plugin:algorand-interaction   # Should load the interaction skill

Auto-Allow MCP Tools (Recommended)

By default, Claude will prompt for permission on every MCP tool call. To auto-allow all Algorand MCP tools, add this to your settings:

Project-level (recommended)

Add to .claude/settings.json in your project root:

{
  "permissions": {
    "allow": [
       "mcp__algorand-mcp__*",
      "claude mcp:*",
    ]
  }
}

User-level (all projects)

Add to ~/.claude/settings.json:

{
  "permissions": {
    "allow": [
       "mcp__algorand-mcp__*",
      "claude mcp:*",
    ]
  }
}

The pattern mcp__algorand-mcp__* matches all 122 tools from the Algorand MCP server.

Note: Plugins cannot ship their own permission allowlists — this is by design. Permissions are a trust decision made by the user, not the plugin author.

Tool Loading (Important)

This plugin provides 122 MCP tools. Claude Code automatically defers large tool sets to save context window space. This means Claude must use ToolSearch to load tools before calling them — the plugin handles this via SessionStart hooks and skill instructions.

If you prefer all 122 tools loaded directly into context (no ToolSearch needed), set this environment variable:

ENABLE_TOOL_SEARCH=false claude --plugin-dir /path/to/claude-algorand-plugin

Or add to ~/.claude/settings.json:

{
  "env": {
    "ENABLE_TOOL_SEARCH": "false"
  }
}

Trade-off: Disabling tool search loads all 122 tool definitions into context at session start, using more context window space but ensuring tools are always immediately available.

MCP Tool Categories (122 tools)