Skip to content
Aptos Docs

Aptos MCP & Cursor

Set up Cursor with Aptos MCP

Section titled “Set up Cursor with Aptos MCP”
  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 the Aptos Developer Portal 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

image

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

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


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


Screenshot 2025-06-26 at 3 54 44PM