Val Town MCP Server

A Model Context Protocol (MCP) server for integrating with the Val Town API.

Features

• Get user profile data from Val Town
• Create new vals programmatically
• Secure API token handling via environment variables

Installation

npm install -g @muhammad_owais_warsi/val-town-mcp

Setup

1. Get your Val Town API token from: https://www.val.town/settings/api
2. Set the environment variable:

export VAL_TOWN_TOKEN="your_token_here"

Usage with Cursor/Claude

Add to your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "val-town-mcp": {
      "command": "npx",
      "args": ["val-town-mcp"],
      "env": {
        "VAL_TOWN_TOKEN": "your_token_here"
      }
    }
  }
}

Available Tools

get-user-data

Retrieves your Val Town profile information including username, bio, and profile URL.

create-val

Creates a new val with specified name, description, and privacy settings.

License

MIT