Skip to content
Aptos Documentation

Setting up Aptos MCP with Cursor

  1. Open the Cursor IDE
  2. On the project root folder, create a .cursor folder
  3. In the .cursor folder, create a mcp.json file
  4. Paste this content
{
  "mcpServers": {
    "aptos-mcp": {
      "command": "npx",
      "args": ["-y", "@aptos-labs/aptos-mcp"],
      "env": {
        "APTOS_BOT_KEY": "<bot_api_key>"
      }
    }
  }
}

  1. Obtain your APTOS_BOT_KEY:

    • Visit Geomi and log in with your account.
    • Navigate to the API Keys section and generate a new key.
    • Copy the generated key for use in the next step.

  2. Make sure to update the APTOS_BOT_KEY in the mcp.json file with the key you just generated.

Verify Cursor runs your MCP

Section titled “Verify Cursor runs your MCP”
  1. Open Cursor Settings: cursor -> settings -> cursor settings
  2. Head to the MCP or Tools & Integrations section
  3. Make sure it is enabled and showing a green color indicator

Make sure it is enabled and showing a green color indicator

  1. Click the “refresh” icon to update the MCP.

  2. Make sure the Cursor AI window dropdown is set to Agent

Make sure the Cursor AI window dropdown is set to Agent

  1. Prompt the agent with what aptos mcp version are you using? to verify the connection. The agent should reply with something like:

Prompt the agent with what aptos mcp version are you using? to verify the connection.