The Aptos MCP server (npx @aptos-labs/aptos-mcp) provides tools, prompts, and resources to help
developers build applications on the Aptos blockchain through Geomi. It is designed to be used with AI tools like Cursor, Claude Code,
Codex, and others that support the Model Context Protocol.
The published npm package is pinned on the MCP Server Card. 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
Section titled “Getting Started”Prerequisites
Section titled “Prerequisites”- Node.js and npm (Node.js 22.12 or later; npm 10 ships with Node.js 22)
- A Geomi Bot Key
Generate a Geomi Bot Key
Section titled “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/
- 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
Section titled “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.