Aptos MCP Server

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.

Is there any way to increase API rate limits?

Yes, by setting the GITHUB_TOKEN environment variable to your GitHub token before starting the server.

Can I run the server in development mode?

Yes, use the command mcp dev aptos_mcp_server.py to launch the server with the MCP Inspector for testing and debugging.

What types of Aptos projects can I create?

You can create fullstack, contract-only, or client-only Aptos projects.