Cursor

Give Cursor's AI the ability to create cloud sandboxes, run code, deploy applications, and expose services to the internet.

Setup

Option A: One-Line Setup

If you haven't installed Conway yet, the setup script handles everything -- installs the terminal, creates a wallet, provisions an API key, and configures your tools:

curl -fsSL https://conway.tech/terminal.sh | sh

Then add Conway to Cursor manually (the setup script doesn't auto-configure Cursor):

1. Open Cursor
2. Go to Settings (Cmd+, on macOS, Ctrl+, on Windows/Linux)
3. Search for "MCP" or navigate to Features > MCP Servers
4. Add this configuration:

{
  "mcpServers": {
    "conway": {
      "command": "conway-terminal",
      "env": {
        "CONWAY_API_KEY": "cnwy_k_..."
      }
    }
  }
}

Your API key is in ~/.conway/config.json after running the setup script.

Option B: Manual Setup

If you already have an API key from app.conway.tech:

1. Open Cursor
2. Go to Settings > Features > MCP Servers
3. Add this configuration:

{
  "mcpServers": {
    "conway": {
      "command": "npx",
      "args": ["conway-terminal"],
      "env": {
        "CONWAY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Restart Cursor

Restart Cursor to load the MCP configuration.

Verify Integration

In Cursor's AI chat, ask:

"List my cloud sandboxes"

Cursor should invoke the sandbox_list tool.

Example Workflows

Deploy and Test

"Create a sandbox, copy my current project files, install dependencies, and run the tests"

Debug in Isolation

"Create a sandbox and help me reproduce this bug in an isolated environment"

API Development

"Set up a sandbox with Python and FastAPI, create a simple REST API, and expose it on port 8000"

Database Testing

"Create a sandbox, install PostgreSQL, and help me test these SQL queries"

Tips

Combine with Local Development

Use sandboxes for:

• Running tests in a clean environment
• Testing deployment scripts
• Reproducing production issues
• Running resource-intensive tasks

Sync Files

Ask Cursor to sync your local files to a sandbox:

"Write my current file to /root/app.py in sandbox sbx-abc123"

Troubleshooting

MCP Not Available

1. Ensure Cursor version supports MCP (check for updates)
2. Verify the configuration JSON is valid
3. Restart Cursor completely

Connection Timeouts

• Check your internet connection
• Verify the API key is valid (~/.conway/config.json or the one you set manually)
• Try a different region

Tools Not Found

1. Check that conway-terminal is installed: which conway-terminal
2. Verify the command works: conway-terminal --version
3. Check Cursor's MCP logs for errors