🏔️ Val Town MCP Server

Model Context Protocol server exposing Val Town's native tools and resources

\n\n

📋 Server Info

Name:: ${serverInfo.name}
Version:: ${serverInfo.version}
Protocol Version:: ${serverInfo.protocolVersion}

\n\n

🔧 Capabilities

\n \n Tools (10 available)\n
\n \n Resources (Dynamic discovery)\n
\n \n Logging\n

\n\n

🛠️ Available Tools

💾 Blob Storage

• blob_get
• blob_set
• blob_list
• blob_delete

🗄️ SQLite Database

• sqlite_execute

📧 Email

• email_send

🤖 OpenAI

• openai_chat

📁 File Operations

• file_read
• file_list

🌍 Environment

• env_get

\n\n

🔗 Usage

MCP Endpoint

\n POST /mcp\n

Send JSON-RPC 2.0 requests to interact with the MCP server

\n \n

Example Request

{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"method\": \"tools/list\"\n}

\n\n

Health Check

{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"method\": \"ping\"\n}

\n\n \n

\n\n`;\n\n return c.html(html);\n});\n\n// Health check endpoint\napp.get(\"/health\", (c) => {\n return c.json({ \n status: \"healthy\", \n timestamp: new Date().toISOString(),\n server: getServerInfo().name\n });\n});\n\n// API documentation endpoint\napp.get(\"/api/docs\", async (c) => {\n const { TOOLS } = await import(\"./mcp/tools.ts\");\n \n return c.json({\n server: getServerInfo(),\n tools: TOOLS,\n endpoints: {\n mcp: \"POST /mcp - Main MCP protocol endpoint\",\n health: \"GET /health - Health check\",\n docs: \"GET /api/docs - This documentation\"\n },\n examples: {\n initialize: {\n jsonrpc: \"2.0\",\n id: 1,\n method: \"initialize\",\n params: {}\n },\n listTools: {\n jsonrpc: \"2.0\",\n id: 2,\n method: \"tools/list\"\n },\n callTool: {\n jsonrpc: \"2.0\",\n id: 3,\n method: \"tools/call\",\n params: {\n name: \"blob_get\",\n arguments: { key: \"example-key\" }\n }\n }\n }\n });\n});\n\n// This is the entry point for HTTP vals\nexport default app.fetch;","val-mcp",[],[152,224],[152],{"_104":235,"_95":236,"_153":237,"_155":-5,"_156":138,"_157":238,"_159":160,"_106":239,"_100":32,"_162":163,"_164":-5,"_165":22,"_166":-5,"_167":240,"_98":249},"cd9d2b82-3c09-11f0-8c8b-9e149126039e","shared","a0461c89-f398-426b-afac-535542e9505b",2,["D",1748467325043],[241],{"_104":242,"_95":243,"_153":244,"_155":237,"_156":138,"_157":238,"_159":160,"_106":245,"_100":32,"_162":181,"_164":246,"_165":22,"_166":-5,"_167":247,"_98":248},"cd9d0fc6-3c09-11f0-8c8b-9e149126039e","utils.ts","cd9d1098-3c09-11f0-8c8b-9e149126039e",["D",1748467325043],"/**\n * Shared utilities for the MCP server\n */\n\nexport interface MCPError {\n code: number;\n message: string;\n data?: any;\n}\n\nexport class MCPException extends Error {\n code: number;\n data?: any;\n\n constructor(code: number, message: string, data?: any) {\n super(message);\n this.code = code;\n this.data = data;\n this.name = 'MCPException';\n }\n}\n\n// MCP Error Codes\nexport const MCP_ERRORS = {\n PARSE_ERROR: -32700,\n INVALID_REQUEST: -32600,\n METHOD_NOT_FOUND: -32601,\n INVALID_PARAMS: -32602,\n INTERNAL_ERROR: -32603,\n TOOL_NOT_FOUND: -32000,\n RESOURCE_NOT_FOUND: -32001,\n PERMISSION_DENIED: -32002,\n} as const;\n\nexport function validateRequired(params: any, required: string[]): void {\n for (const field of required) {\n if (params[field] === undefined || params[field] === null) {\n throw new MCPException(\n MCP_ERRORS.INVALID_PARAMS,\n `Missing required parameter: ${field}`\n );\n }\n }\n}\n\nexport function sanitizeKey(key: string): string {\n // Ensure blob keys are safe\n return key.replace(/[^a-zA-Z0-9_\\-\\.\\/]/g, '_');\n}",[],[236,243],[236],{"_104":251,"_95":214,"_153":252,"_155":-5,"_156":138,"_157":180,"_159":22,"_106":253,"_100":32,"_162":218,"_164":254,"_165":22,"_166":-5,"_167":255,"_98":256},"c9000c16-3c09-11f0-a57a-9e149126039e","c9000cca-3c09-11f0-a57a-9e149126039e",["D",1748467317303],"# Val Town MCP Server\n\nA Model Context Protocol (MCP) server that exposes Val Town's native tools and resources, allowing AI models to interact with Val Town's capabilities through a standardized protocol.\n\n## Features\n\n- **Blob Storage**: Read, write, list, and delete blob data\n- **SQLite Database**: Execute queries and manage database operations\n- **Email**: Send emails through Val Town's email service\n- **OpenAI Integration**: Access OpenAI API through Val Town's service\n- **File Operations**: Read and list project files\n- **Environment Variables**: Access environment configuration\n\n## MCP Protocol Support\n\nThis server implements the Model Context Protocol specification, providing:\n- Tool discovery and execution\n- Resource listing and reading\n- Proper error handling and validation\n- JSON-RPC 2.0 compliant messaging\n\n## API Endpoints\n\n- `POST /mcp` - Main MCP protocol endpoint\n- `GET /` - Server information and documentation\n\n## Usage\n\nThe server exposes Val Town capabilities as MCP tools that can be called by compatible AI models and clients.\n\n## Project Structure\n\n```\n├── backend/\n│ ├── index.ts # Main HTTP server\n│ ├── mcp/\n│ │ ├── server.ts # MCP protocol handler\n│ │ ├── tools.ts # Tool definitions and handlers\n│ │ ├── resources.ts # Resource definitions and handlers\n│ │ └── types.ts # MCP type definitions\n│ └── README.md\n├── shared/\n│ └── utils.ts # Shared utilities\n└── README.md\n```",[],[214],"files",[150,169,175,185,194,203,212,222,234,241,250],"counts",{"_261":32,"_262":180,"_263":32,"_264":32},"pulls","branches","forks","envVars","contents",[],{"_104":176,"_95":177,"_153":178,"_155":172,"_156":138,"_157":101,"_159":160,"_106":268,"_100":180,"_162":181,"_164":182,"_165":22,"_166":-5,"_98":269},["D",1748467679130],[152,171,177],"upstreamProject","upstreamBranch","emptyEnvVars","isNew","flags",[],"routes/_app.x.$handle.$name.branch.$branch.version.$version.code.$",{"_93":94,"_95":96,"_97":43,"_100":101,"_98":99,"_102":278,"_148":283,"_257":317,"_218":318,"_265":320,"_321":-5,"_322":22,"_323":-5,"_324":-5,"_325":-5,"_326":327},{"_104":105,"_95":96,"_106":279,"_108":-5,"_109":22,"_110":111,"_112":-5,"_113":-5,"_14":114,"_115":-5,"_116":22,"_117":-5,"_118":32,"_16":119,"_120":121,"_122":121,"_123":124,"_125":124,"_126":124,"_127":121,"_128":121,"_23":280,"_132":281,"_135":282,"_147":22},["D",1748420544100],{"_93":94,"_130":131},{"_93":94,"_134":131},{"_100":137,"_95":43,"_104":138,"_139":105,"_140":-5,"_141":-5,"_142":-5,"_143":-5,"_144":-5,"_145":96,"_146":94},[284,308,314],{"_104":151,"_95":152,"_153":154,"_155":-5,"_156":138,"_157":158,"_159":160,"_106":161,"_100":32,"_162":163,"_164":-5,"_165":22,"_166":-5,"_167":285,"_98":307},[286,301,304],{"_104":170,"_95":171,"_153":172,"_155":154,"_156":138,"_157":158,"_159":160,"_106":173,"_100":32,"_162":163,"_164":-5,"_165":22,"_166":-5,"_167":287,"_98":300},[288,291,294,297],{"_104":176,"_95":177,"_153":178,"_155":172,"_156":138,"_157":101,"_159":160,"_106":179,"_100":180,"_162":181,"_164":182,"_165":22,"_166":-5,"_167":289,"_98":290},[],[152,171,177],{"_104":186,"_95":187,"_153":188,"_155":172,"_156":138,"_157":189,"_159":160,"_106":190,"_100":32,"_162":181,"_164":191,"_165":22,"_166":-5,"_167":292,"_98":293},[],[152,171,187],{"_104":195,"_95":196,"_153":197,"_155":172,"_156":138,"_157":198,"_159":160,"_106":199,"_100":32,"_162":181,"_164":200,"_165":22,"_166":-5,"_167":295,"_98":296},[],[152,171,196],{"_104":204,"_95":205,"_153":206,"_155":172,"_156":138,"_157":158,"_159":160,"_106":207,"_100":32,"_162":181,"_164":208,"_165":22,"_166":-5,"_167":298,"_98":299},[],[152,171,205],[152,171],{"_104":213,"_95":214,"_153":215,"_155":154,"_156":138,"_157":216,"_159":160,"_106":217,"_100":32,"_162":218,"_164":219,"_165":22,"_166":-5,"_167":302,"_98":303},[],[152,214],{"_104":223,"_95":224,"_153":225,"_155":154,"_156":138,"_157":226,"_159":22,"_106":227,"_100":180,"_162":228,"_164":229,"_165":22,"_166":230,"_167":305,"_98":306},[],[152,224],[152],{"_104":235,"_95":236,"_153":237,"_155":-5,"_156":138,"_157":238,"_159":160,"_106":239,"_100":32,"_162":163,"_164":-5,"_165":22,"_166":-5,"_167":309,"_98":313},[310],{"_104":242,"_95":243,"_153":244,"_155":237,"_156":138,"_157":238,"_159":160,"_106":245,"_100":32,"_162":181,"_164":246,"_165":22,"_166":-5,"_167":311,"_98":312},[],[236,243],[236],{"_104":251,"_95":214,"_153":252,"_155":-5,"_156":138,"_157":180,"_159":22,"_106":253,"_100":32,"_162":218,"_164":254,"_165":22,"_166":-5,"_167":315,"_98":316},[],[214],[284,286,288,291,294,297,301,304,308,310,314],{"_104":176,"_95":177,"_153":178,"_155":172,"_156":138,"_157":101,"_159":160,"_106":268,"_100":180,"_162":181,"_164":182,"_165":22,"_166":-5,"_98":319},[152,171,177],[],"upstream","showCompareCallout","pull","ahead","behind","templates",[],"actionData","errors"]