mcpField
A
Aptos Mcp

Aptos Mcp

Local
github.com/aptos-labsDeveloper Tools13Updated 17w ago
Repository

About Aptos Mcp

Aptos MCP Server helps developers and AI agents build Aptos dApps by automating Geomi infrastructure tasks and providing guidance on current Move patterns and Aptos workflows.

Key features

  1. 01Automates Geomi project management
  2. 02Sets up sponsored-transaction gas stations
  3. 03Configures API keys and rate limits
  4. 04Provides current Move development guidance
  5. 05Explains Aptos CLI workflows

Use cases

  1. 01Set up Aptos project infrastructure
  2. 02Enable sponsored transactions
  3. 03Guide agents through Move contract development

MCP support

Exposes Aptos infrastructure management tools and development guidance to MCP clients, helping AI agents work with current Aptos capabilities.

#aptos#dapp#developer-tools

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "aptos-npm": {
      "command": "npx",
      "args": [
        "-y",
        "@aptos-labs/aptos-mcp"
      ],
      "env": {
        "APTOS_BOT_KEY": "<APTOS_BOT_KEY>"
      }
    }
  }
}
Run commandnpx -y @aptos-labs/aptos-mcp
Environment variables to set
APTOS_BOT_KEYSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@aptos-labs/aptos-mcp

Tools

15

Saved tool list · updated 2w ago

This tool takes no parameters.

Details

From the project README

Aptos NPM MCP

What This MCP Server Can Do

The Aptos MCP Server provides specialized tools and development guides that automate Aptos infrastructure and ensure AI agents use current best practices.

🚀 Infrastructure Automation
  • Automate Aptos Geomi platform management (skip manual setup steps and let the agent manage your projects)
  • Create gas stations for sponsored transactions (give your users free transactions with web2 UX)
  • Handle API keys and rate limits (automated setup for production apps)
🤖 AI Agent Guidance
  • Current Move smart contract patterns (MCP-specialized up-to-date language vs outdated general models)
  • Modern Aptos features (sponsored transactions, no-code indexer, wallet adapters for Google login)
  • Proper CLI usage and workflows (current Aptos commands vs generic blockchain knowledge)

Why This Exists: Aptos moves so fast that generic AI models don't know about new features like Aptos Geomi gas stations, no-code indexers, or current Move patterns.

📋 View Complete Capabilities →

Prerequisites

  • node and npm (node ≥ 22.12.0, npm ≥ 10 — bundled with node 22)
  • Geomi Bot Api Key
Generate a Geomi Bot Api Key

To be able to make Geomi actions like managing api keys, etc. Follow those instruction to generate a new Bot Api Key to use with the MCP

  1. Go to https://geomi.dev/
  2. Click on your name in the bottom left corner
  3. Click on "Bot Keys"
  4. Click on the "Create Bot Key" button
  5. Copy the Bot Key and paste it into the MCP configuration file as an env arg: APTOS_BOT_KEY=<your-bot-key>

Production Usage

Follow these guides on how to integrate the Aptos MCP with your prefered interface
Start vibe coding.

Make sure to read the user guide for best results.

Development Usage

Follow this guide on how to develop locally the Aptos MCP

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.