Val Town — Claude Code MCP server: deploy TypeScript without a server
Hooks your agent up to Val Town so it can ship HTTP vals, cron jobs, SQLite and email from the chat. Handy when you want a backend without running your own box.
claude mcp add --transport http mcp https://api.val.town/v3/mcpWhat Val Town does
The plugin registers the hosted MCP server at https://api.val.town/v3/mcp and ships skills — markdown guides covering HTTP vals, cron, SQLite, email, OAuth, frontend work and API integrations. Your agent pulls in the relevant skill on its own once a request matches.
The first time an MCP tool fires, the agent opens a browser and walks through OAuth. No Val Town account, no working tools — that is the catch to plan for.
Skills live in plugin/skills/<name>/SKILL.md with YAML frontmatter. name and description are required; triggers is optional and only nudges searchSkills ranking, since Claude's native loader skips it. Build with npm install and npm run build, verify with npm test.
What it helps with
- ship an HTTP endpoint on Val Town straight from the agent
- set up a cron job without provisioning a server
- wire SQLite into a val and run a query
- add OAuth sign-in to a Val Town app
- send mail from a val using built-in email
Example prompts for the agent
- Create an HTTP val that takes a POST and writes the body to SQLite
- Set up a cron val that pulls data hourly into a table
- Add OAuth login to my Val Town val
How to install Val Town
Platform CLI: remote server
claude mcp add --transport http mcp https://api.val.town/v3/mcpPlatform CLI: remote server
codex mcp add val-town --url https://api.val.town/v3/mcpConfig file
{
"mcpServers": {
"val-town": {
"url": "https://api.val.town/v3/mcp"
}
}
}Config file
{
"servers": {
"val-town": {
"type": "http",
"url": "https://api.val.town/v3/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http val-town https://api.val.town/v3/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Val Town
How do I install Val Town in Claude Code?
Run claude plugin install valtown@claude-plugins-official. The plugin registers the MCP server and exposes the skills to your agent.
What does Val Town do?
It gives your agent access to the Val Town platform, so you can write and deploy serverless TypeScript functions and use cron, SQLite, email and OAuth.
Do I need to authorize anything?
Yes. On the first MCP tool call the agent starts an OAuth flow in your browser, and tools stay silent until you sign in to Val Town.
