Val Town MCP server
Commit 28. Okt. 2026Enables AI agents to deploy serverless TypeScript, manage SQLite databases, schedule crons, and handle OAuth via the Val Town platform.
Auch bekannt als val-town/plugins, plugins
- Stars
- 10
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 1.0.0
- Letzter Commit
- 28. Okt. 2026
- Lizenz
- MIT
Was ist Val Town MCP?
Val Town ist ein MCP server. Enables AI agents to deploy serverless TypeScript, manage SQLite databases, schedule crons, and handle OAuth via the Val Town platform.
Zusammenfassung generiert aus dem README des Projekts
Über 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.
Was du damit machen kannst
- 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.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Val Town MCP
Formate geprüft am 10. Nov. 2026Val Town MCP in Claude Code installieren
$ claude mcp add --transport http plugins https://api.val.town/v3/mcpVal Town MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"plugins": {
"url": "https://api.val.town/v3/mcp"
}
}
}Val Town MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"plugins": {
"type": "http",
"url": "https://api.val.town/v3/mcp"
}
}
}Val Town MCP in Codex installieren
~/.codex/config.toml
[mcp_servers.plugins] url = "https://api.val.town/v3/mcp"
Val Town MCP in Gemini CLI installieren
~/.gemini/settings.json
{
"mcpServers": {
"plugins": {
"httpUrl": "https://api.val.town/v3/mcp"
}
}
}Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarval-town/plugins is public and reachablegithub.com/val-town/plugins ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Herkunft (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-28github.com/val-town/plugins ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Kein kritischer Hinweis im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeHTTPS endpoint answered 401 (sign-in required)Bestanden
README
Auf GitHub ansehenAgent 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 Fragen
Wie füge ich Val Town MCP zu Claude Code hinzu?
Führe claude mcp add --transport http plugins https://api.val.town/v3/mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Val Town MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
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.