Aptos MCP Server

Name: Aptos MCP Server
Author: Tlazypanda

@Tlazypanda

About Aptos MCP Server

A Model Context Protocol (MCP) server for interacting with Aptos documentation and creating full-stack Aptos blockchain applications.

#aptos #mcp #blockchain #server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "aptos-dev": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/aptos-mcp-server",
        "run",
        "aptos_mcp_server.py"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Aptos MCP Server?

A Model Context Protocol (MCP) server for browsing and searching Aptos documentation and creating full-stack Aptos blockchain applications. It is designed for developers building on the Aptos ecosystem who want to use natural language to interact with Aptos docs, scaffold projects, generate components, test Move contracts, and produce TypeScript ABIs.

How to use Aptos MCP Server?

Install prerequisites (Python 3.10+, Node.js, npm, and optionally the Aptos CLI), install the mcp[cli] package, clone the repository, and install dependencies (httpx). Optionally set a GITHUB_TOKEN environment variable for increased API rate limits. Then configure the server with Claude Desktop using either the mcp install command or by manually editing the Claude Desktop configuration JSON file. Once connected, you can issue natural language queries to browse docs, create projects, generate components, test contracts, or generate TypeScript ABIs.

Key features of Aptos MCP Server

Browse and search Aptos documentation
Create new Aptos projects (fullstack, contract, or client)
Generate components for Aptos projects
Test Aptos Move contracts
Generate TypeScript ABI interfaces for Move contracts

Use cases of Aptos MCP Server

Browse Aptos documentation to find information about Move modules or table implementations
Scaffold a new Aptos full-stack project, such as an NFT marketplace
Generate a React component for connecting to an Aptos wallet
Test a Move contract’s withdraw function and review results
Generate TypeScript bindings for an existing Move contract

FAQ from Aptos MCP Server

What are the system requirements for using this server?

Python 3.10 or later, Node.js and npm, and optionally the Aptos CLI for some tooling features.

How do I set up the server with Claude Desktop?

You can run mcp install aptos_mcp_server.py in the repository directory, or manually edit the Claude Desktop configuration file (e.g., claude_desktop_config.json) to point uv at the server script.