valtown

ValTown MCP Server exposes a bridge to the ValTown environment, allowing AI assistants to execute ValTown functions securely from MCP-compatible clients. You can run the server locally with Deno or deploy pre-built binaries for your platform. To connect, you have two main options: use the hosted ValTown MCP endpoint provided by ValTown, or run the server locally and point your MCP client at localhost. When running locally, provide your ValTown API token via VAL_TOWN_API_TOKEN to authorize requests. The server acts as a streamable MCP endpoint, so Claude’s or other MCP clients can send function calls which are executed inside ValTown and return results to the AI assistant.

Prerequisites:

• Node, Python, or Deno depending on the deployment method. This server is driven by Deno during development and local runs.
• ValTown API token created in your ValTown account settings.

Option A — Run with Deno (recommended for development):

1. Install Deno: follow https://deno.land/#installation
2. Clone the repository: git clone https://github.com/PrashamTrivedi/valtown-mcp-server.git
3. Navigate to the project directory: cd valtown-mcp-server
4. Start the server: deno task start (Or for development with watch mode: deno task dev)

Option B — Use pre-built binaries (for production):

1. Download the appropriate binary from the latest release:
   • Linux: valtown-mcp-linux
   • Windows: valtown-mcp-windows.exe
   • macOS: valtown-mcp-macos
2. Ensure the binary is executable (chmod +x on Unix-like systems).
3. Run the binary with the required environment variable: VAL_TOWN_API_TOKEN=vtwn_KEY ./valtown-mcp-linux

Option C — Build from source (advanced):

1. Install Deno (as above).
2. Clone repository and install any build tooling if required.
3. Build using the provided Deno tasks (as shown in Option A).

Note: Regardless of method, set VAL_TOWN_API_TOKEN to your ValTown API token before starting the server.

Environment variables and usage tips:

• VAL_TOWN_API_TOKEN is required and must start with vtwn_ as documented by ValTown.
• When running locally, ensure your machine has network access to ValTown services.
• If you encounter permission issues on Linux/macOS, make the binary executable (chmod +x).
• The hosted ValTown MCP endpoint option is available for clients that prefer a managed deployment; update your client configuration accordingly.
• For Claude Code or Claude Desktop, you’ll typically add a new MCP server entry pointing to either the hosted endpoint or your local server with the appropriate token, following the examples in the README.
• If you switch between local and hosted deployments, ensure the token usage and endpoint URL match the chosen deployment.