Overview

Tip We recommend using Townie or installing the Val Town plugin, which bundles the MCP server with platform skills. Choose your app in the plugin guide for instructions for Claude, ChatGPT, Claude Code, Codex, or Cursor.

• Val Town Plugin ⭐️ — Val Town MCP server + Skills
• Townie ⭐️ — In-browser agent on val.town
• Val Town MCP — MCP server for compatible AI apps
• vt CLI — CLI for Val Town
• Custom skills — Custom skills for your LLM

Popular tools#

• Claude Code ⭐️ — Val Town + Claude Code
• Codex ⭐️ — Val Town + OpenAI Codex
• Cursor ⭐️ — Val Town + Cursor
• Claude Web/Desktop — Val Town + Claude Web/Desktop
• ChatGPT Web/Desktop — Val Town + ChatGPT
• GitHub Copilot — Val Town + GitHub Copilot
• Warp — Val Town + Warp
• Zed — Val Town + Zed
• Windsurf — Val Town + Windsurf
• Other compatible apps — Connect with remote MCP

Note Are we missing your favorite LLM? Click "Edit page" to update these docs, or ask us to help.

Check your setup#

After installing, connect your Val Town account and start a new chat or session. Ask: “Use Val Town to list my vals. Don’t create or change anything.” A response from Val Town, even an empty list, confirms the connection. See setup troubleshooting if it doesn’t work.

Tips, Troubleshooting#

• Ask to list or examine your vals or read sqlite data, logs, etc.
• Ask your LLM to edit vals and even agentically iterate
• Broken code? Visit the Versions tab or History of your val to revert
• Large changes? Use feature branches and merge when stable
• Need help? Ask in the Val Town Discord server