Log inSubmit server
Val Town logo

Val Town

Deploy TypeScript vals on Val Town with MCP tools for HTTP endpoints, cron jobs, SQLite, email, OAuth, and API integrations.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Val Town

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "val-town": {
      "command": "npx",
      "args": [
        "-y",
        "@changesets/cli"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @changesets/cli

Process exited before answering initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1d ago.

Overview

The Val Town MCP server connects AI coding agents to Val Town's hosted platform for building and deploying serverless TypeScript. It supports work with HTTP vals, scheduled jobs, SQLite, email, OAuth, frontend projects, and API integrations. The plugin also supplies platform skills that guide agents through these development tasks. Reach for it when an agent needs to create or manage Val Town applications through MCP, with browser-based OAuth on first tool use.

Use cases

  • Deploy HTTP TypeScript vals
  • Schedule recurring Val Town jobs
  • Build SQLite-backed applications
  • Add email or OAuth flows
  • Connect Val Town apps to external APIs

Key features

  • Hosted MCP endpoint
  • Browser OAuth authentication
  • HTTP vals and cron guidance
  • SQLite, email, and OAuth support
  • Frontend and API integration skills

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

7/7 checks healthy over the last 44d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · @changesets/cli (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars10Stargazers on the source repository.
npm downloads23MPackage downloads in the last 30 days.
Last commit9d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Val Town works

What the Val Town MCP server does

The Val Town MCP server gives supported AI coding agents access to Val Town's hosted development platform. Its documented scope covers serverless TypeScript applications, known as vals, and several platform features: HTTP endpoints, cron jobs, SQLite databases, email, OAuth, frontend work, and API integrations.

The repository packages two related pieces: the hosted MCP connection and a collection of platform skills. Skills are Markdown guidance files that explain how to build for Val Town. They are intended for Val Town's own tools and for coding agents, so an agent can receive platform-specific instructions alongside access to MCP tools.

This fits projects where an agent needs to build or deploy a TypeScript service on Val Town rather than only edit local source files. It is also relevant when the work involves scheduled execution, persistent SQLite data, outbound email, authentication flows, or external APIs.

How it works

Installing the plugin registers Val Town's hosted MCP endpoint at https://api.val.town/v3/mcp and makes the platform skills available to the agent. When an MCP tool is used for the first time, the agent starts an OAuth flow in a browser.

The skills are organized by platform topic, including HTTP endpoints, crons, SQLite, email, OAuth, frontend development, and API integrations. Each skill contains YAML metadata and a Markdown body. Skill metadata includes a required name and description, with optional trigger terms used to improve skill search ranking.

The Val Town MCP server is consumed as part of the plugin rather than being built from this repository during normal installation. The repository is the source of truth for the skill content, while the Val Town application and MCP server use that content as a dependency.

Setup and configuration

The repository documents installation paths for Claude Code, Codex, and Cursor. In Claude Code, install the marketplace plugin with:

Terminal
claude plugin install valtown@claude-plugins-official

For Codex CLI, add val-town/plugins as a marketplace, open the plugins interface, and install Val Town. The Codex desktop app can add the same GitHub repository from its Plugins area. In Cursor, run /add-plugin valtown, or add https://github.com/val-town/plugins through Cursor Settings.

After installation, the plugin registers the hosted MCP server. Authentication is handled through the browser OAuth flow when an MCP tool is first used.

Tools and capabilities

The Val Town MCP server and its accompanying skills cover these documented areas:

  • Building HTTP vals and web endpoints
  • Creating cron-based scheduled jobs
  • Using SQLite from Val Town applications
  • Sending email
  • Implementing OAuth
  • Building frontend code
  • Connecting to APIs

The plugin's skills are reusable Markdown guidance rather than a list of separately documented command names. The repository also includes validation and build tooling for maintainers: npm install, npm run build, npm test, and npm run generate. Those commands build generated skill code, run TypeScript compilation, execute smoke tests, and validate skill metadata.

The Val Town MCP server is therefore most suitable when the agent needs both platform instructions and a remote MCP connection to Val Town.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Val Town

Val Town is an MCP server that connects AI coding agents to Val Town’s hosted platform. Its tools support working with serverless TypeScript vals, including HTTP endpoints, scheduled jobs, SQLite, email, OAuth, frontend work, and API integrations. Agents authenticate through a browser OAuth flow when they first use an MCP tool.

Install the Val Town plugin through Claude Code, Codex, or Cursor. Claude Code uses `claude plugin install valtown@claude-plugins-official`; Cursor supports `/add-plugin valtown`; Codex adds `val-town/plugins` as a marketplace and installs Val Town from its plugins interface.

Yes, Val Town works with Cursor through the plugin marketplace. Run `/add-plugin valtown`, or add `https://github.com/val-town/plugins` in Cursor Settings and select “Add to Cursor.” The plugin registers the hosted MCP server and provides Val Town platform skills.

Authentication uses OAuth in a browser when an MCP tool is used for the first time.

Related MCP servers

All in Developer Tools All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewVal Town AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/val-town?style=directory)](https://allmcps.com/mcp/val-town)
HTML Embed
<a href="https://allmcps.com/mcp/val-town"><img src="https://allmcps.com/api/badge/val-town?style=directory" alt="Val Town on AllMCPs" /></a>