📘 Aptos MCP Documentation

Overview

The Aptos Model Context Protocol (MCP) is a server that provides a set of tools, prompts, and resources to help developers build applications on the Aptos blockchain. It is designed to be used with AI tools like Cursor, Claude Code, and others that support the Model Context Protocol.

Aptos MCP + Geomi Integration

The Aptos MCP enables agents to interact with key components of the Geomi platform, specifically for managing:

• Organizations
• Projects
• Applications
• API Keys

This allows developers to programmatically bootstrap environments, rotate credentials, and manage access to Build tooling without direct human intervention.

Getting Started

Prerequisite

• node and npm
• Build 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

• Go to https://build.aptoslabs.com/
• Click on your name in the bottom left corner
• Click on “Bot Keys”
• Click on the “Create Bot Key” button
• Copy the Bot Key and paste it into the MCP configuration file as an env arg: APTOS_BOT_KEY=<your-bot-key>

Follow this guide on how to integrate the Aptos MCP into your development environment

💡 Prompt Example

Here is an example of how to prompt an agent to use one of the supported tools:

Create a new API key called "my-api-key" in my application called "MyDashboard" in the "growth-tools" project under the "MarketingOps" organization

This prompt will generate a new API key and modify the dapp code to use it.