ValTown MCP Server

A Model Context Protocol (MCP) server for ValTown 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:

• Linux: valtown-mcp-linux
• Windows: valtown-mcp-windows.exe
• macOS: valtown-mcp-macos

Option 2: Build from source

1. Install Deno
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.

Usage with MCP Clients

Claude Desktop

Windows Configuration

Add the following to your Claude Desktop configuration:

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

"valtown": {
  "command": "/path/to/valtown-mcp-macos",
  "env": {
    "VAL_TOWN_API_TOKEN": "vtwn_KEY"
  }
}

Linux Configuration

Add the following to your Claude Desktop configuration:

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

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

claude mcp add valtown /path/to/valtown-mcp-linux -e VAL_TOWN_API_TOKEN=vtwn_KEY

On Windows, use:

claude mcp add valtown C:\path\to\valtown-mcp-windows.exe -e VAL_TOWN_API_TOKEN=vtwn_KEY

On macOS, use:

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 for a list of notable changes to this project.

License

This project is licensed under the MIT License - see the LICENSE file for details.