The [Aptos MCP server](https://github.com/aptos-labs/aptos-npm-mcp) (`npx @aptos-labs/aptos-mcp`) provides tools, prompts, and resources to help developers build applications on the Aptos blockchain through [Geomi](https://geomi.dev). It is designed to be used with AI tools like Cursor, Claude Code, Codex, and others that support the [Model Context Protocol](https://modelcontextprotocol.io/).

The published npm package is pinned on the [MCP Server Card](/.well-known/mcp/server-card.json). Do not use the `latest` tag in production configs; run `npx -y @aptos-labs/aptos-mcp` so npm resolves the current release, or pin the version from that card.

## Getting Started

[](#getting-started)

### Prerequisites

[](#prerequisites)

*   [Node.js and npm](https://nodejs.org/en) (Node.js 22.12 or later; npm 10 ships with Node.js 22)
*   A Geomi Bot Key

### Generate a Geomi Bot Key

[](#generate-a-geomi-bot-key)

To make Geomi actions such as managing API keys, follow these steps to create a Bot Key for the MCP server.

*   Go to [https://geomi.dev/](https://geomi.dev/)
*   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 as `APTOS_BOT_KEY=<your-bot-key>`

Never commit the Bot Key to git. Prefer interpolating an environment variable (for example Cursor’s `${env:APTOS_BOT_KEY}`) over hard-coding the secret in a shared config file.

### Supported Interfaces

[](#supported-interfaces)

We’ve provided guides for Claude Code, Cursor, and OpenAI Codex. Other MCP clients — including GitHub Copilot — can reuse the same stdio command and `APTOS_BOT_KEY` environment variable.

[Claude Code](/build/ai/aptos-mcp/claude) Set up for Claude Code

[Cursor](/build/ai/aptos-mcp/cursor) Set up for Cursor

[OpenAI Codex](/build/ai/aptos-mcp/codex) Set up for Codex