Val Town MCP server
Commit Oct 28, 2026Enables AI agents to deploy serverless TypeScript, manage SQLite databases, schedule crons, and handle OAuth via the Val Town platform.
Also known as val-town/plugins, plugins
- Stars
- 10
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Oct 28, 2026
- License
- MIT
What is Val Town MCP?
Val Town enables AI agents to deploy serverless TypeScript, manage SQLite databases, schedule crons, and handle OAuth via the Val Town platform.
Summary generated from the project's README
About Val Town MCP server
Deploying serverless TypeScript functions and managing cloud infrastructure from within an AI coding agent is what this server enables. Developers using Claude Code, Codex, or Cursor can connect to the Val Town platform to build and maintain web services. The server provides specialized skills that allow an agent to handle HTTP endpoints, schedule cron jobs, manage SQLite databases, and configure OAuth flows.
Setup requires installing the plugin through the specific CLI or settings menu of your chosen agent. On the first attempt to use a tool, the agent initiates an OAuth flow in your web browser to authenticate your account. This connection allows the agent to act as a developer on your behalf, utilizing platform-specific knowledge to create webhooks, API routes, and frontend components directly through the MCP interface.
What you can do with it
- 1Deploying web endpointsAsk your AI agent to create a new API route or webhook using TypeScript.
- 2Managing persistent dataInstruct an agent to set up or modify a SQLite database for your application.
Written from the project's README. Every use case is checked against a quote from it.
How to install Val Town MCP
Formats verified 10 Nov 2026Install Val Town MCP in Claude Code
$ claude mcp add --transport http plugins https://api.val.town/v3/mcpInstall Val Town MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"plugins": {
"url": "https://api.val.town/v3/mcp"
}
}
}Install Val Town MCP in VS Code
.vscode/mcp.json
{
"servers": {
"plugins": {
"type": "http",
"url": "https://api.val.town/v3/mcp"
}
}
}Install Val Town MCP in Codex
~/.codex/config.toml
[mcp_servers.plugins] url = "https://api.val.town/v3/mcp"
Install Val Town MCP in Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"plugins": {
"httpUrl": "https://api.val.town/v3/mcp"
}
}
}Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work
- Source repository linked and reachableval-town/plugins is public and reachablegithub.com/val-town/plugins ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-28github.com/val-town/plugins ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubAgent plugins for Val Town
Installs the Val Town MCP server and Skills for Claude Code, Codex, and Cursor.
Skills are markdown files with platform guidance for building on Val Town. Used by Val Town's own tools (Townie, the MCP server) and by AI coding agents. Skills include HTTP vals, crons, SQLite, email, OAuth, frontend, and API integrations.
Install
Installing the plugin makes platform skills available to your agent and registers
the hosted Val Town MCP server (https://api.val.town/v3/mcp). On first use of
an MCP tool, the agent runs the OAuth flow in your browser.
Claude Code
Install the Val Town plugin by running:
claude plugin install valtown@claude-plugins-official
Codex
codex CLI
First, run:
codex plugin marketplace add val-town/plugins
Then fire up codex and run:
/plugins
Search for Val Town, hit install, and it'll take you through the OAuth path.
Codex desktop app
- Click "Plugins" in the sidebar
- In the dropdown that says "Built by OpenAI" click "Add more +"
- Copy-paste
https://github.com/val-town/pluginsand select "Add marketplace"
Cursor
In Cursor, run:
/add-plugin valtown
Or in Cursor Settings, copy-paste https://github.com/val-town/plugins in the search box and select "Add to Cursor."
Contributing
Authoring skills
Skills live in plugin/skills/<name>/SKILL.md with YAML frontmatter:
---
name: http-endpoints
description: Use when building an HTTP val — a web endpoint, API route, webhook...
triggers: [http, endpoint, webhook, api, request, response]
---
# HTTP Endpoints
...guide body...
name(required) — must match the directory name; lowercase, hyphens, ≤64 chars.description(required) — written as "Use when…"; this is how Claude decides to load the skill. ≤1024 chars.triggers(optional) — keyword hints that boostsearchSkillsranking; ignored by Claude Code's native loader.
Keep content audience-neutral: only platform knowledge true for every consumer. No product-flow or chat-only advice.
Then build:
npm install
npm run build # generate src/generated/skills.ts, then tsc
npm test # build + smoke tests
npm run generate validates every skill against both our schema and Claude
Code's frontmatter constraints — a skill that wouldn't load in Claude Code
fails the build.
Relationship to the Val Town monorepo
This package is the source of truth for skill content. The Val Town app and MCP
server consume it as a dependency rather than holding their own copy. See
docs/SKILLS_PLUGIN.md in the main repo for the full design.
Versioning
This repository uses Changesets for publishing. See their documentation for more information.
- For each change that should trigger a new version, you should run
npx @changesets/cliand fill out the interactive prompts to describe the changes. This will generate a new changeset in the.changesetsdirectory. - Each change in that directory will prompt the
release.ymlGitHub action to create a new release PR. - Merging a release PR will automatically publish a new version of this module.
Configuration
Claude Code
The official Claude plugin marketplace pulls from .plugins/marketplace.json.
Codex
Codex reads the native marketplace at .agents/plugins/marketplace.json (and
falls back to the Claude .claude-plugin/marketplace.json for compatibility).
Cursor
Cursor reads .cursor-plugin/marketplace.json and the per-plugin plugin/.cursor-plugin/plugin.json.
Val Town MCP questions
How do I add Val Town MCP to Claude Code?
Run claude mcp add --transport http plugins https://api.val.town/v3/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Val Town MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I install the Val Town plugin for Claude Code?
You can install it by running the command: claude plugin install valtown@claude-plugins-official.
How does the authentication process work?
On the first use of an MCP tool, the agent will initiate an OAuth flow in your web browser.
Can I use this with Cursor?
Yes, you can add it in Cursor by running /add-plugin valtown or by searching for the plugin URL in Cursor Settings.