ValTown

You run a ValTown MCP Server to let AI assistants execute ValTown functions inside your environment. It bridges your ValTown capabilities with MCP clients so you can issue actions and receive results in a familiar, scalable way across platforms.

How to use

You connect an MCP client to the ValTown MCP Server to enable execution of ValTown functions from AI assistants. Start the server using one of the supported methods, then configure your client to point to the server. The server handles authentication via your ValTown API token and exposes a stable MCP endpoint that clients can reach for commands and responses.

Once connected, you can issue valid MCP tasks that map to ValTown functions. The server supports both hosted (remote) access and local setups. For hosted access, you point your client to the remote MCP URL and pass your API token. For local setups, you run the server locally and configure your client to communicate with the local process. Ensure the API token you use is active and has permissions to invoke ValTown operations.

How to install

Choose an installation method that fits your workflow. You can install a pre-built binary, build from source, or run directly with Deno.

# Option 1: Use pre-built binaries
# Linux
# Download valtown-mcp-linux

# Windows
# Download valtown-mcp-windows.exe

# macOS
# Download valtown-mcp-macos

# Option 2: Build from source
# Prerequisite: Deno is installed on your system

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

Additional configuration and usage notes

The server requires a ValTown API token to operate. Set the following environment variable in your environment where the server runs:

VAL_TOWN_API_TOKEN: Your ValTown API token (starts with vtwn_)

Local configuration for MCP clients

Online connection (hosted on ValTown) is the easiest way to get started. Point your MCP client to the hosted endpoint and provide your API token in the headers.

Local installation lets you run the server on your machine and connect clients to http://localhost:PORT/mcp or your locally chosen URL.