What is Valtown Mcp Server

Valtown MCP Server is a Model Context Protocol (MCP) server designed for ValTown, enabling AI assistants to execute functions within the ValTown environment.

Use cases

Use cases include enhancing AI assistants with ValTown functionalities, automating tasks through AI, and integrating ValTown services into existing applications.

How to use

To use Valtown MCP Server, install it via pre-built binaries or build from source using Deno. Configure your MCP client (like Claude Desktop or Claude Code) to point to the server and set the ValTown API token as an environment variable.

Key features

Key features include the ability to execute ValTown functions from AI assistants, compatibility with all MCP clients, and cross-platform support for Windows, macOS, and Linux.

Where to use

Valtown MCP Server can be used in various fields such as AI development, automation, and any application requiring integration with the ValTown environment.

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

Online Connection (Hosted on ValTown)

The easiest way to use this MCP server is to connect to the hosted version running on ValTown:

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

macOS Configuration

Add the following to your Claude Desktop configuration:

Linux Configuration

Add the following to your Claude Desktop configuration:

Running with Deno (all platforms)

If you have Deno installed, you can run the server directly:

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.