Skip to content
DocumentationAptos MCP

📘 Aptos MCP Documentation

Overview

The Aptos Model Context Protocol (MCP) is a server designed to be used with AI tools like Cursor, Claude Code, and others that support the Model Context Protocol. It provides you with dozens of tools and guides to help AI and developers build applications on the Aptos blockchain. It automates interactions with the Aptos Geomi platform while providing current best practices for Aptos development.

What This MCP Server Can Do

🚀 Geomi Platform Automation

  • 22 specialized tools that automate Geomi platform interactions
  • Instant setup vs. 5-15 minutes of manual web interface navigation
  • Complete gas station automation with sponsorship rules (eliminates weeks of custom infrastructure development)
  • Enterprise project management through programmatic API calls

🧠 AI Agent Development Guidance

  • 15 comprehensive development guides ensures your AI agent is using current Aptos best practices and wallet adapters
  • MCP-first workflow enforcement prevents outdated pattern usage
  • Current Move development patterns for code that compiles on first try
  • Cutting-edge feature support for Geomi’s APIs, sponsored transactions and no-code indexers

Aptos MCP + Geomi Integration

The Aptos MCP enables AI agents to programmatically manage key components of the Geomi platform:

  • Organizations - Create and manage organizational structures
  • Projects - Set up development projects within organizations
  • API Keys - Create API keys for higher rate limits and usage tracking
  • Gas Stations - Set up sponsored transaction infrastructure

This eliminates manual web interface navigation, letting you automate Geomi platform management.

Getting Started

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

Prerequisites

Generate a Geomi Bot API Key

To enable Geomi platform automation, follow these instructions:

  1. Go to https://geomi.dev/manage/bot-keys
  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>

Create New API Resource

The MCP can automatically create API resources and applications for you. You can either:

  • Use the MCP to create everything programmatically (recommended)
  • Manually create resources in your Geomi dashboard if you prefer

The MCP will guide you through the automated setup process when you use the prompt examples below.

💡 Prompt Examples

Here are examples of how to prompt an agent to use the supported tools:

Creating API Resources

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

Setting Up Gas Station (Sponsored Transactions)

In Geomi, create a gas station application called "MyGasStation" in my "Web3App" project with sponsorship rules for user onboarding functions

Managing Organizations

Create a new organization called "MyCompany" and set up a project called "Web3App" with an application called "MainApp" in Geomi

Getting Development Guidance

Help me build a complete Aptos dApp with sponsored transactions and wallet integration

Querying NFT Data

Query the top 10 NFT collections by volume in the last 24 hours using the NFT Analytics API

These prompts will generate the necessary resources and provide example code for integration.

Available APIs Through Geomi

The Aptos MCP helps you manage API keys for all Geomi APIs:

Core APIs

  • Node API (REST) - Direct blockchain access

  • Indexer API (GraphQL) - Advanced blockchain queries

    • Endpoint: https://api.mainnet.aptoslabs.com/v1/graphql
    • Documentation

  • Transaction Stream (GRPC) - Real-time transaction data

NFT APIs

  • NFT Aggregator API (GraphQL) - Marketplace activity across integrated platforms

  • NFT Analytics API (REST) - Market intelligence and historical data

Complete API Reference

For comprehensive API documentation including endpoints, authentication, rate limits, and examples:

View API Reference

All APIs use the same authentication method with your Geomi API key. Pricing and rate limit information is dynamically loaded in the Billing Documentation.

REST API ReferenceBilling