Aptos Mcp

by cuongpo

267 downloads Not rated yet

GitHub Website

Other

About

# Aptos MCP Server A Model Context Protocol (MCP) server for interacting with the Aptos blockchain testnet. This server provides AI assistants with the ability to perform blockchain operations, query data, and manage digital assets on Aptos. ## Features ### 🔐 Account Management ff - Generate new Aptos accounts - Get…

Explore

- Generate, fund, and manage Aptos accounts
- Transfer APT tokens and execute custom transactions
- Query blockchain information, blocks, events, and gas prices
- Manage fungible tokens and NFTs (create, mint, transfer)
- Simulate transactions for gas estimation

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-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "aptos-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "aptos-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "aptos-mcp-server"
                ]
            }
        }
    }
}

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-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "aptos-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "aptos-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "aptos-mcp-server"
                ]
            }
        }
    }
}

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-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "aptos-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "aptos-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "aptos-mcp-server"
                ]
            }
        }
    }
}

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-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "aptos-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "aptos-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "aptos-mcp-server"
                ]
            }
        }
    }
}

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-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "aptos-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "aptos-mcp-server"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "aptos-mcp-server"
                ]
            }
        }
    }
}

From the repository

The server is configured for Aptos testnet by default. Key configuration:

- Network: Testnet
- Timeout: 30 seconds for requests
- Gas Limits: Configurable per transaction
- Error Handling: Comprehensive error messages

// Deploy a new fungible token
const deployResult = await deployFungibleToken({
  creatorPrivateKey: "0x...",
  name: "My Token",
  symbol: "MTK",
  decimals: 8
});
// Create an NFT collection

const collectionResult = await createNFTCollection({

  creatorPrivateKey: "0x...",

  name: "My NFT Collection",

  description: "A collection of unique digital assets",

  uri: "https://example.com/collection.json"

});
// Mint an NFT in the collection

const nftResult = await mintNFT({

  creatorPrivateKey: "0x...",

  collectionName: "My NFT Collection",

  tokenName: "NFT #1",

  description: "First NFT in the collection",

  uri: "https://example.com/nft1.json",

  recipientAddress: "0x..."

});
// Mint fungible tokens

const mintResult = await mintFungibleToken({

  creatorPrivateKey: "0x...",

  recipientAddress: "0x...",

  amount: 1000

});

This server is designed to be deployed to mcp.so. The build output in build/index.js is the entry point for the MCP server.

`generate_account`

Generate a new Aptos account

`get_account_info`

Get detailed account information

`get_account_balance`

Check APT balance

`fund_account`

Fund account from testnet faucet

`check_account_exists`

Verify if account exists

`get_account_resources`

Get all account resources

`transfer_apt`

Transfer APT tokens

`get_transaction`

Get transaction details by hash

`simulate_transaction`

Simulate transaction for gas estimation

`get_account_transactions`

Get account transaction history

`execute_function`

Execute custom smart contract functions

`get_chain_info`

Get blockchain information

`get_block`

Get block data by height/version

`get_events`

Query blockchain events

`get_account_modules`

Get published modules

`get_gas_price`

Get current gas price

`get_table_item`

Query table items

`view_function`

Call read-only functions

`get_account_tokens`

Get owned NFTs

`get_token_data`

Get token metadata

`get_collection_data`

Get collection information

`get_account_coin_balances`

Get all coin balances

`transfer_token`

Transfer NFTs

`get_account_token_activities`

Get token activity history

`deploy_fungible_token`

Deploy a new fungible token

`create_nft_collection`

Create a new NFT collection

`mint_nft`

Mint an NFT in an existing collection

`mint_fungible_token`

Mint fungible tokens to an account

- generate_account - Generate a new Aptos account
- get_account_info - Get detailed account information
- get_account_balance - Check APT balance
- fund_account - Fund account from testnet faucet
- check_account_exists - Verify if account exists
- get_account_resources - Get all account resources

- transfer_apt - Transfer APT tokens
- get_transaction - Get transaction details by hash
- simulate_transaction - Simulate transaction for gas estimation
- get_account_transactions - Get account transaction history
- execute_function - Execute custom smart contract functions

- get_chain_info - Get blockchain information
- get_block - Get block data by height/version
- get_events - Query blockchain events
- get_account_modules - Get published modules
- get_gas_price - Get current gas price
- get_table_item - Query table items
- view_function - Call read-only functions

- get_account_tokens - Get owned NFTs
- get_token_data - Get token metadata
- get_collection_data - Get collection information
- get_account_coin_balances - Get all coin balances
- transfer_token - Transfer NFTs
- get_account_token_activities - Get token activity history
- deploy_fungible_token - Deploy a new fungible token
- create_nft_collection - Create a new NFT collection
- mint_nft - Mint an NFT in an existing collection
- mint_fungible_token - Mint fungible tokens to an account

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "aptos mcp": {
            "aptos-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "aptos-mcp-server"
                ]
            }
        }
    }
}

McpServers

{
    "aptos-mcp-server": {
        "command": "npx",
        "args": [
            "-y",
            "aptos-mcp-server"
        ]
    }
}

A Model Context Protocol (MCP) server for interacting with the Aptos blockchain testnet. This server provides AI assistants with the ability to perform blockchain operations, query data, and manage digital assets on Aptos.

Features

🔐 Account Management ff

- Generate new Aptos accounts - Get account information and balances - Fund accounts from t estnet faucet - Validate addresses and check account existence. d - Query account resources

💸 Transaction Operations

- Transfer APT tokens between accounts - Build, sign, and submit transactions - Simulate transactions for gas estimation - Track transaction status and history - Execute custom smart contract functions

🔍 Blockchain Queries

- Get current blockchain information - Query blocks by height or version - Search for events and activities - Get gas price estimations - Call view functions (read-only) - Query table items

🎨 Token & NFT Management

- Get account token balances (fungible tokens) - Query owned NFTs and collections - Transfer tokens and NFTs - Get token and collection metadata - Track token-related activities - Deploy new fungible tokens - Create NFT collections - Mint NFTs and fungible tokens

Installation

Local Development

npm install
npm run build

mcp.so Hosting

This server is ready for deployment on mcp.so:

1. Upload to GitHub: Push your code to a public repository
2. Submit to mcp.so: Use the submission form
3. Automatic hosting: Supports both stdio and REST transports
4. Docker support: Includes Dockerfile for containerized deployment

Usage

With Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "aptos": {
      "command": "node",
      "args": ["/path/to/aptos-mcp-server/build/index.js"],
      "env": {}
    }
  }
}

Standalone Testing

```bash

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

Explore

Setting up with Highlight

From the repository

generate_account

get_account_info

get_account_balance

fund_account

check_account_exists

get_account_resources

transfer_apt

get_transaction

simulate_transaction

get_account_transactions

execute_function

get_chain_info

get_block

get_events

get_account_modules

get_gas_price

get_table_item

view_function

get_account_tokens

get_token_data

get_collection_data

get_account_coin_balances

transfer_token

get_account_token_activities

deploy_fungible_token

create_nft_collection

mint_nft

mint_fungible_token

Claude Desktop / Cursor

McpServers

Features

🔐 Account Management ff

💸 Transaction Operations

🔍 Blockchain Queries

🎨 Token & NFT Management

Installation

Local Development

mcp.so Hosting

Usage

With Claude Desktop

Standalone Testing

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

`generate_account`

`get_account_info`

`get_account_balance`

`fund_account`

`check_account_exists`

`get_account_resources`

`transfer_apt`

`get_transaction`

`simulate_transaction`

`get_account_transactions`

`execute_function`

`get_chain_info`

`get_block`

`get_events`

`get_account_modules`

`get_gas_price`

`get_table_item`

`view_function`

`get_account_tokens`

`get_token_data`

`get_collection_data`

`get_account_coin_balances`

`transfer_token`

`get_account_token_activities`

`deploy_fungible_token`

`create_nft_collection`

`mint_nft`

`mint_fungible_token`