Cursor

Setup

1. Install the Val Town CLI and log in
2. Open Cursor

Creating and editing vals

The most reliable way to write vals in Cursor is with vt watch, which will automatically sync your changes to Val Town as you save files.

1. vt create, vt remix, or vt clone a val. Select “Yes” to add editor files*
2. cd into your val’s directory
3. vt checkout -b <branch> to isolate changes (optional)
4. vt watch to sync with Val Town

* Running vt create|remix|clone will prompt you to add editor files, including AGENTS.md with our system prompt, which Cursor should recognize.

MCP

1. Go to Cursor Settings > Tools & Models > New MCP server.
2. Create an API token in the Val Town console.
3. Add the following to mpc.json, replace API_TOKEN_HERE:

   {
     "mcpServers": {
       "val-town": {
         "url": "https://api.val.town/v3/mcp",
         "headers": {
           "Authorization": "Bearer API_TOKEN_HERE"
         }
       }
     }
   }