Aptos Mcp

by aptos-labs

288 downloads

Not rated

GitHub

About

An AI-powered developer experience for Aptos that lets users vibe code and deploy full-stack dApps with minimal setup.

Details

Author: aptos-labs
Downloads: 288
Categories: Developer Tools, Finance, Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Aptos Mcp

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@aptos-labs/aptos-mcp"
                ],
                "env": {
                    "APTOS_BOT_KEY": "<bot_api_key>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@aptos-labs/aptos-mcp"
                ],
                "env": {
                    "APTOS_BOT_KEY": "<bot_api_key>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@aptos-labs/aptos-mcp"
                ],
                "env": {
                    "APTOS_BOT_KEY": "<bot_api_key>"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@aptos-labs/aptos-mcp"
                ],
                "env": {
                    "APTOS_BOT_KEY": "<bot_api_key>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@aptos-labs/aptos-mcp"
                ],
                "env": {
                    "APTOS_BOT_KEY": "<bot_api_key>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@aptos-labs/aptos-mcp"
                ],
                "env": {
                    "APTOS_BOT_KEY": "<bot_api_key>"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@aptos-labs/aptos-mcp"
                ],
                "env": {
                    "APTOS_BOT_KEY": "<bot_api_key>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@aptos-labs/aptos-mcp"
                ],
                "env": {
                    "APTOS_BOT_KEY": "<bot_api_key>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@aptos-labs/aptos-mcp"
                ],
                "env": {
                    "APTOS_BOT_KEY": "<bot_api_key>"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@aptos-labs/aptos-mcp"
                ],
                "env": {
                    "APTOS_BOT_KEY": "<bot_api_key>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@aptos-labs/aptos-mcp"
                ],
                "env": {
                    "APTOS_BOT_KEY": "<bot_api_key>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@aptos-labs/aptos-mcp"
                ],
                "env": {
                    "APTOS_BOT_KEY": "<bot_api_key>"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@aptos-labs/aptos-mcp"
                ],
                "env": {
                    "APTOS_BOT_KEY": "<bot_api_key>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@aptos-labs/aptos-mcp"
                ],
                "env": {
                    "APTOS_BOT_KEY": "<bot_api_key>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@aptos-labs/aptos-mcp"
                ],
                "env": {
                    "APTOS_BOT_KEY": "<bot_api_key>"
                }
            }
        }
    }
}

From the repository

Install Node.js and npm (npm ≥ 5.2.0). Generate a Build Bot API Key from build.aptoslabs.com and set it as the environment variable APTOS_BOT_KEY. Then follow the integration guides for Cursor or Claude Code to start using the MCP.

`get_aptos_build_applications`

Get your Aptos Build Organizations with their projects and applications and the API Keys. Api Keys are secret keys so it is important to keep them safe and secure. To get the full node api keys, you need to get the Applications with a serviceType of "Api". To get the gas station api keys, you need to get the Applications with a serviceType of "Gs".

`create_aptos_build_organization`

Create a new Organization for your Aptos Build.

`create_aptos_build_api_resource_application`

Create a new Application for your Aptos Build Organization. This tool can be used to create an API resource application to then create api keys for general blockchain interactions.

`create_aptos_build_project`

Create a new Project for your Aptos Build Organization.

`create_aptos_build_api_key`

Create a new API Key for your Aptos Build Organization. Api Keys are secret keys so it is important to keep them safe and secure. This tool can be used to create an Api Key (aka full node api key) for an Api resource application.

`update_aptos_build_api_key`

Update an API Key for your Aptos Build Organization.

`get_mcp_version`

Returns the version of the MCP server

`build_smart_contract_on_aptos`

Build an Aptos smart contract - returns all resources from move and management directories. Use this tool when you need guidance on how to build a smart contract for a dapp on Aptos.

`build_ui_frontend_on_aptos`

Build a UI frontend for Aptos dApp - returns all resources from frontend directory. Use this tool when you need guidance on how to build a frontend for a dapp on Aptos.

`build_dapp_on_aptos`

Build a complete full-stack Aptos dApp - returns all resources from move, management, and frontend directories. Use this tool when you need guidance on how to build a full-stack dapp on Aptos.

`list_aptos_resources`

Get a list of all available Aptos development resources. Use this first to see what guidance is available, then use get_specific_aptos_resource to fetch the relevant one.

`get_specific_aptos_resource`

Retrieve a specific Aptos development resource by its exact filename (without .md extension).

`build_dapp_on_aptos_guidance_prompt`

PRIMARY PROMPT: Use this as the main system prompt when building any Aptos dApp. Sets up mandatory MCP consultation workflow and prevents outdated knowledge usage.

`aptos_development_reminder_prompt`

MID-DEVELOPMENT REMINDER: Use this prompt when you notice the conversation has gone few exchanges without using MCP tools, or when implementing new Aptos features to reinforce MCP consultation habits.

`aptos_debugging_helper_prompt`

ERROR RECOVERY PROMPT: Use this immediately when encountering Aptos-related errors, stuck in debugging loops, or when about to try generic blockchain solutions. Redirects to MCP-first debugging approach.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@aptos-labs/aptos-mcp"
                ],
                "env": {
                    "APTOS_BOT_KEY": "<bot_api_key>"
                }
            }
        }
    }
}

McpServers

{
    "aptos-mcp": {
        "command": "npx",
        "args": [
            "-y",
            "@aptos-labs/aptos-mcp"
        ],
        "env": {
            "APTOS_BOT_KEY": "<bot_api_key>"
        }
    }
}

The Aptos MCP Server providesspecialized toolsanddevelopment guidesthat automate Aptos infrastructure and ensure AI agents use current best practices.

- 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)

- 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.

- node and npm(node ≥ 22.12.0, npm ≥ 10 — bundled with node 22)
- Geomi Bot Api Key

To be able to make Geomiactions like managing api keys, etc. Follow those instruction to generate a new Bot Api Key to use with the MCP
- 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 file as an env arg:APTOS_BOT_KEY=<your-bot-key>

Follow these guides on how to integrate the Aptos MCP with your prefered interface

Make sure to read the user guidefor best results.

Follow this guide on how to develop locally the Aptos MCP

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Read/write to over 2k blockchains, enabling data querying, contract analysis/deployment, and transaction execution, powered by Thirdweb.

Interact with Aptos documentation and create full-stack Aptos blockchain applications.

A comprehensive toolkit for Ethereum blockchain analysis directly within Claude AI.

A set of tools for interacting with the Flow blockchain through the Model Context Protocol.

A toolkit for building and deploying AI agents with blockchain capabilities, featuring a Model Context Protocol (MCP) server.

An MCP server for Solana development providing basic RPC methods and helpful prompts.

An MCP server providing access to various Starknet RPC methods.

An MCP server for interacting with the Tatara blockchain ecosystem. Requires configuration for the Tatara RPC endpoint and a wallet private key.

MCP server for Klever blockchain smart contract development, on-chain data exploration, and VM interaction. Public remote server available at https://mcp.klever.org/mcp.

50+ pay-per-call APIs for AI agents via HTTP 402 crypto micropayments. $0.001–$0.12 per call with USDC and USDm.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

get_aptos_build_applications

create_aptos_build_organization

create_aptos_build_api_resource_application

create_aptos_build_project

create_aptos_build_api_key

update_aptos_build_api_key

get_mcp_version

build_smart_contract_on_aptos

build_ui_frontend_on_aptos

build_dapp_on_aptos

list_aptos_resources

get_specific_aptos_resource

build_dapp_on_aptos_guidance_prompt

aptos_development_reminder_prompt

aptos_debugging_helper_prompt

Claude Desktop / Cursor

McpServers

Follow these guides on how to integrate the Aptos MCP with your prefered interface

Follow this guide on how to develop locally the Aptos MCP

Install

More like this

Sequential Thinking

Sentry

Github

Filesystem

EverArt

Google Drive

`get_aptos_build_applications`

`create_aptos_build_organization`

`create_aptos_build_api_resource_application`

`create_aptos_build_project`

`create_aptos_build_api_key`

`update_aptos_build_api_key`

`get_mcp_version`

`build_smart_contract_on_aptos`

`build_ui_frontend_on_aptos`

`build_dapp_on_aptos`

`list_aptos_resources`

`get_specific_aptos_resource`

`build_dapp_on_aptos_guidance_prompt`

`aptos_development_reminder_prompt`

`aptos_debugging_helper_prompt`