Aptos NPM MCP
Official# 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 ā](./capabilities.md)**
---
## Prerequisites
- [node and npm](https://nodejs.org/en) (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](https://geomi.dev/) 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/](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
- [Cursor](./integration_guides/cursor.md)
- [Claude Code](./integration_guides/claude_code.md)
- [Codex](./integration_guides/codex.md)
### Start vibe coding.
Make sure to read the [user guide](./integration_guides/user_guide.md) for best results.
## Development Usage
#### Follow this guide on how to develop locally the Aptos MCP
- [Local development with the Aptos MCP](./integration_guides/development_usage.md)
TDQS
Scored across 22 tools
The tools have some clear distinctions, such as between Geomi CRUD operations and Aptos resource management, but there is significant overlap and ambiguity. For example, multiple 'build' tools (build_dapp_on_aptos, build_smart_contract_on_aptos, build_ui_frontend_on_aptos) cover similar development guidance with unclear boundaries, and several 'prompt' tools (aptos_debugging_helper_prompt, aptos_development_reminder_prompt, build_dapp_on_aptos_guidance_prompt) serve overlapping advisory functions, which could confuse agents about when to use each.
Naming conventions are inconsistent and chaotic. There is a mix of snake_case (e.g., list_aptos_resources), verbose phrases with underscores (e.g., aptos_debugging_helper_prompt), and camelCase-like patterns (e.g., get_mcp_version). Verbs vary widely (e.g., 'build', 'create', 'get', 'list', 'update', 'delete'), and some names are overly descriptive while others are terse, lacking a predictable pattern across the set.
With 22 tools, the count is borderline high for the server's purpose of Aptos development and Geomi management. While the domain is broad, the tools include many overlapping or redundant ones (e.g., multiple prompt tools and build guidance tools), making the set feel heavy and potentially over-scoped. A more streamlined set of 10-15 tools might better cover the core functionalities without excess.
The tool set provides good coverage for the inferred domains of Aptos development resources and Geomi organization management. For Geomi, it offers full CRUD operations for organizations, projects, applications, and API keys, with no obvious gaps. For Aptos resources, it includes listing and fetching, though it lacks direct blockchain interaction tools. Minor gaps exist, such as no tools for deploying or testing smart contracts, but agents can work around these with the available guidance tools.