# Val Town [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/val-town/plugins  
**GitHub Stars:** 10  
**npm Downloads (last month):** 23417713  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/val-town

## Description
Deploy serverless TypeScript on Val Town: HTTP vals, cron, SQLite, email, OAuth.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "val-town": {
    "command": "npx",
    "args": ["-y","@changesets/cli"]
  }
}
```

## Documentation

## 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:

```text
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.

_Full upstream README: https://allmcps.com/mcp/val-town/readme_