Content
# ValTown MCP Server
A Model Context Protocol (MCP) server for [ValTown](https://www.val.town/) that
allows AI assistants to execute code in the ValTown environment.
## Features
- Execute ValTown functions from AI assistants
- Compatible with all MCP clients (Claude Desktop, Claude Code, etc.)
- Cross-platform support (Windows, macOS, Linux)
## Installation
### Option 1: Use pre-built binaries
Download the appropriate binary for your platform from the
[latest release](https://github.com/PrashamTrivedi/valtown-mcp-server/releases/latest):
- Linux: `valtown-mcp-linux`
- Windows: `valtown-mcp-windows.exe`
- macOS: `valtown-mcp-macos`
### Option 2: Build from source
1. Install [Deno](https://deno.land/#installation)
2. Clone this repository
3. Build the binaries:
```
deno task build # Builds for all platforms
deno task build:linux # Builds only for Linux
deno task build:windows # Builds only for Windows
deno task build:macos # Builds only for macOS
```
### Option 3: Run directly with Deno
```
deno task start # Run the server
deno task dev # Run the server with watch mode for development
```
## Configuration
The server requires a ValTown API token to operate. Set the following
environment variable:
- `VAL_TOWN_API_TOKEN`: Your ValTown API token (starts with `vtwn_`)
You can obtain a ValTown API token from your
[ValTown account settings](https://www.val.town/settings).
## Usage with MCP Clients
### Online Connection (Hosted on ValTown)
The easiest way to use this MCP server is to connect to the hosted version running on ValTown:
```json
{
"mcpServers": {
"valtown": {
"type": "streamable-http",
"url": "https://prashamtrivedi-valtown-mcp-server.val.run/mcp",
"headers": {
"x-val-town-token": "YOUR_VAL_TOWN_TOKEN_HERE"
}
}
}
}
```
Replace `YOUR_VAL_TOWN_TOKEN_HERE` with your actual ValTown API token.
### Local Installation
If you prefer to run the server locally, you can use the following methods:
### Claude Desktop
#### Windows Configuration
Add the following to your Claude Desktop configuration:
```json
"valtown": {
"command": "C:\\path\\to\\valtown-mcp-windows.exe",
"env": {
"VAL_TOWN_API_TOKEN": "vtwn_KEY"
}
}
```
#### macOS Configuration
Add the following to your Claude Desktop configuration:
```json
"valtown": {
"command": "/path/to/valtown-mcp-macos",
"env": {
"VAL_TOWN_API_TOKEN": "vtwn_KEY"
}
}
```
#### Linux Configuration
Add the following to your Claude Desktop configuration:
```json
"valtown": {
"command": "/path/to/valtown-mcp-linux",
"env": {
"VAL_TOWN_API_TOKEN": "vtwn_KEY"
}
}
```
#### Running with Deno (all platforms)
If you have Deno installed, you can run the server directly:
```json
"valtown": {
"command": "deno",
"args": ["run", "--allow-net", "--allow-env", "--allow-read", "/path/to/mod.ts"],
"env": {
"VAL_TOWN_API_TOKEN": "vtwn_KEY"
}
}
```
### Claude Code
Add the ValTown MCP server to Claude Code using the CLI:
```bash
claude mcp add valtown /path/to/valtown-mcp-linux -e VAL_TOWN_API_TOKEN=vtwn_KEY
```
On Windows, use:
```bash
claude mcp add valtown C:\path\to\valtown-mcp-windows.exe -e VAL_TOWN_API_TOKEN=vtwn_KEY
```
On macOS, use:
```bash
claude mcp add valtown /path/to/valtown-mcp-macos -e VAL_TOWN_API_TOKEN=vtwn_KEY
```
### Other MCP Compatible Clients
For other MCP compatible clients, configure them to point to the ValTown MCP
server binary and ensure the `VAL_TOWN_API_TOKEN` environment variable is set.
## Troubleshooting
- Ensure your ValTown API token is valid
- Check that the server has network access
- Verify the correct permissions are set on the binary (Linux/macOS may require
`chmod +x`)
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## Changelog
See the [CHANGELOG](CHANGELOG.md) for a list of notable changes to this project.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
for details.
Connection Info
You Might Also Like
markitdown
MarkItDown-MCP is a lightweight server for converting URIs to Markdown.
servers
Model Context Protocol Servers
Time
A Model Context Protocol server for time and timezone conversions.
Filesystem
Node.js MCP Server for filesystem operations with dynamic access control.
Sequential Thinking
A structured MCP server for dynamic problem-solving and reflective thinking.
git
A Model Context Protocol server for Git automation and interaction.