Cursor MCP Setup

Configure Cursor IDE to connect to the Aether MCP server.

🤖🤖 Your Agent Has Access to All This

Once the Cursor MCP is connected, your agent will have full access to these docs. No need to learn this yourself...unless you want to! 👀

Prerequisites

Cursor IDE installed
Aether bridge running (see Quickstart)
Unity project with Aether SDK installed

Configuration

Method 1: MCP Configuration File (Recommended)

Create a file called .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "aether": {
      "command": "node",
      "args": [
        "-e",
        "const WebSocket = require('ws'); const ws = new WebSocket('ws://localhost:7891'); ws.on('open', () => { process.stdin.pipe(ws); ws.pipe(process.stdout); });"
      ]
    }
  }
}

ℹ️Simpler Alternative

If the above doesn't work, try this simpler configuration:

{
  "mcpServers": {
    "aether": {
      "url": "ws://localhost:7891"
    }
  }
}

Method 2: Cursor Settings UI

Open Cursor Settings
Navigate to Features → MCP Servers
Click Add Server
Enter:
- Name: aether
- URL: ws://localhost:7891
Click Save

Verification

After configuration, verify the connection:

Restart Cursor (required after configuration changes)
Open the AI chat in Cursor
Type: @aether snapshot
You should see a GTML snapshot response

✅Connection Success

If you see a structured response with game state, the connection is working!

Available Tools

Once connected, you can use these MCP tools in Cursor:

@aether snapshot - Get current Unity state
@aether tail - Stream recent events
@aether mark - Create a markpoint
@aether clip - Get a clip of events
@aether package - Create a capsule
@aether viewCapsule - View a capsule

See the Tools Reference for complete documentation.

Troubleshooting

Connection Refused

Problem: Cursor can't connect to the bridge.

Solutions:

Verify the bridge is running: Check terminal for MCP server listening on 127.0.0.1:7891
Check firewall: Ensure localhost connections aren't blocked
Verify port: Make sure port 7891 isn't in use by another application

Tools Not Appearing

Problem: Aether tools don't show up in Cursor.

Solutions:

Restart Cursor completely
Check .cursor/mcp.json syntax (valid JSON, no trailing commas)
Verify the bridge is running before starting Cursor
Check Cursor's MCP server logs for errors

Invalid Configuration

Problem: Cursor shows configuration errors.

Solutions:

Validate JSON syntax in .cursor/mcp.json
Ensure the file is in the project root
Check Cursor's console for specific error messages

For more help, see the Troubleshooting Guide.