Permaweb MCP 🧠⚡️

A streamlined MCP server for AO process management, Arweave deployment, and ArNS domain operations

Permaweb MCP is a Model Context Protocol (MCP) server that provides core infrastructure for interacting with the AO ecosystem and Arweave network. Built with TypeScript and FastMCP, it delivers 16 essential tools across 4 categories: Process management, Arweave deployment, wallet operations, and ArNS domain management.

🚀 Quick Start

NPM Package Installation

# Install globally for CLI usage
npm install -g permaweb-mcp

# Or install locally in your project
npm install permaweb-mcp

# Start the MCP server
npx permaweb-mcp

MCP Server Setup

For Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "permaweb-mcp": {
      "command": "npx",
      "args": ["permaweb-mcp"],
      "env": {
        "SEED_PHRASE": "your twelve word mnemonic phrase here for deterministic wallet"
      }
    }
  }
}

For VS Code with Claude Code Extension

1. Install Claude Code Extension: Search for “Claude Code” in VS Code marketplace
2. Configure MCP Server: Add to your VS Code settings or workspace configuration:

{
  "mcpServers": {
    "permaweb-mcp": {
      "command": "npx",
      "args": ["permaweb-mcp"],
      "env": {
        "SEED_PHRASE": "your twelve word mnemonic phrase here"
      }
    }
  }
}

Environment Configuration

Create a .env file or set environment variables:

# Required: Deterministic wallet generation
SEED_PHRASE="your twelve word mnemonic phrase here"

# Optional: Development mode
NODE_ENV=development

---

🌟 Why Permaweb MCP?

🚀 Key Features

🔧 Process Management (4 Tools)