🏔️ Val Town MCP Server

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

Demo

\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",[],[151,224],[151],{"_103":236,"_95":237,"_152":238,"_154":-5,"_155":137,"_156":239,"_158":159,"_105":240,"_100":32,"_161":162,"_163":-5,"_164":22,"_165":-5,"_166":241,"_98":301},"902fd9fa-3c0b-11f0-8e65-9e149126039e","frontend","fd0ed52a-80e3-4bad-bfab-b43c1d460782",12,["D",1748468080979],[242,284,292],{"_103":243,"_95":244,"_152":245,"_154":238,"_155":137,"_156":246,"_158":159,"_105":247,"_100":32,"_161":162,"_163":-5,"_164":22,"_165":-5,"_166":248,"_98":283},"a81201b0-3c0b-11f0-a66f-9e149126039e","components","e95b85d1-4cb0-43d5-86c9-1fe92c0d6881",14,["D",1748468121047],[249,258,266,274],{"_103":250,"_95":251,"_152":252,"_154":245,"_155":137,"_156":136,"_158":159,"_105":253,"_100":254,"_161":181,"_163":255,"_164":22,"_165":-5,"_166":256,"_98":257},"406e9f82-3cd8-11f0-8bd2-9e149126039e","ApiKeyInput.tsx","b0d8fa42-3c0b-11f0-af64-9e149126039e",["D",1748555993999],2,"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport React, { useState } from \"https://esm.sh/react@18.2.0?deps=react@18.2.0\";\n\ninterface ApiKeyInputProps {\n apiKey: string;\n onApiKeyChange: (key: string) => void;\n}\n\nexport function ApiKeyInput({ apiKey, onApiKeyChange }: ApiKeyInputProps) {\n const [isVisible, setIsVisible] = useState(false);\n const [tempKey, setTempKey] = useState(apiKey);\n\n const handleSave = () => {\n onApiKeyChange(tempKey);\n };\n\n const handleClear = () => {\n setTempKey('');\n onApiKeyChange('');\n localStorage.removeItem('anthropic_api_key');\n };\n\n return (\n

🔑 Anthropic API Key

\n \n

\n \n Enter your Anthropic API Key\n \n

\n setTempKey(e.target.value)}\n placeholder=\"sk-ant-api03-...\"\n className=\"w-full px-3 py-2 border border-gray-300 rounded-md focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent\"\n />\n setIsVisible(!isVisible)}\n className=\"absolute right-3 top-1/2 transform -translate-y-1/2 text-gray-500 hover:text-gray-700\"\n >\n {isVisible ? '🙈' : '👁️'}\n \n

\n \n Save\n \n \n Clear\n \n

\n\n

\n Status:{' '}\n \n {apiKey ? '✅ API key configured' : '❌ No API key set'}\n \n

\n Your API key is stored locally in your browser and sent directly to Anthropic's API.\n

\n Get your API key from{' '}\n \n Anthropic Console\n \n

\n );\n}",[],[237,244,251],{"_103":259,"_95":260,"_152":261,"_154":245,"_155":137,"_156":136,"_158":159,"_105":262,"_100":228,"_161":181,"_163":263,"_164":22,"_165":-5,"_166":264,"_98":265},"406ea978-3cd8-11f0-8bd2-9e149126039e","App.tsx","a811d0a0-3c0b-11f0-a66f-9e149126039e",["D",1748555993999],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport React, { useEffect, useRef, useState } from \"https://esm.sh/react@18.2.0?deps=react@18.2.0\";\nimport { ApiKeyInput } from \"./ApiKeyInput.tsx\";\nimport { ChatInterface } from \"./ChatInterface.tsx\";\nimport { MCPClient } from \"./MCPClient.tsx\";\n\nexport interface Message {\n id: string;\n role: \"user\" | \"assistant\" | \"system\";\n content: string;\n timestamp: Date;\n toolCalls?: ToolCall[];\n mcpResponses?: any[];\n}\n\nexport interface ToolCall {\n id: string;\n name: string;\n arguments: any;\n result?: any;\n error?: string;\n}\n\nexport function App() {\n const [apiKey, setApiKey] = useState(\"\");\n const [messages, setMessages] = useState([]);\n const [isLoading, setIsLoading] = useState(false);\n const [mcpClient, setMcpClient] = useState(null);\n const [availableTools, setAvailableTools] = useState([]);\n\n // Initialize MCP client and load API key from localStorage\n useEffect(() => {\n const savedApiKey = localStorage.getItem(\"anthropic_api_key\");\n if (savedApiKey) {\n setApiKey(savedApiKey);\n }\n\n // Initialize MCP client\n const client = new MCPClient(\"/mcp\");\n setMcpClient(client);\n\n // Load available tools\n client.listTools().then(tools => {\n setAvailableTools(tools);\n console.log(\"Available MCP tools:\", tools);\n }).catch(err => {\n console.error(\"Failed to load MCP tools:\", err);\n });\n\n // Add welcome message\n setMessages([{\n id: \"1\",\n role: \"system\",\n content:\n \"Welcome to the Val Town MCP Client Demo! This chat interface connects to Claude via the Anthropic API and uses the Val Town MCP server to execute tools. Enter your Anthropic API key to get started.\",\n timestamp: new Date(),\n }]);\n }, []);\n\n const handleApiKeyChange = (key: string) => {\n setApiKey(key);\n localStorage.setItem(\"anthropic_api_key\", key);\n };\n\n const sendMessage = async (content: string) => {\n if (!apiKey.trim()) {\n alert(\"Please enter your Anthropic API key first\");\n return;\n }\n\n if (!mcpClient) {\n alert(\"MCP client not initialized\");\n return;\n }\n\n const userMessage: Message = {\n id: Date.now().toString(),\n role: \"user\",\n content,\n timestamp: new Date(),\n };\n\n setMessages(prev => [...prev, userMessage]);\n setIsLoading(true);\n\n try {\n // Prepare system message with MCP tools\n const systemMessage = `You are an AI assistant with access to Val Town's capabilities through MCP tools. \n\nAvailable tools:\n${availableTools.map(tool => `- ${tool.name}: ${tool.description}`).join(\"\\n\")}\n\nWhen you need to use these tools, I will execute them for you and provide the results. Be helpful and use the tools when appropriate to assist the user.`;\n\n // Call Anthropic API\n const response = await fetch(\"https://api.anthropic.com/v1/messages\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"x-api-key\": apiKey,\n \"anthropic-version\": \"2023-06-01\",\n \"anthropic-dangerous-direct-browser-access\": \"true\",\n \"anthropic-beta\": \"mcp-client-2025-04-04\",\n },\n body: JSON.stringify({\n model: \"claude-3-5-sonnet-20241022\",\n max_tokens: 1024,\n system: systemMessage,\n messages: messages\n .filter(m => m.role !== \"system\")\n .map(m => ({\n role: m.role,\n content: m.content,\n }))\n .concat([{ role: \"user\", content }]),\n mcp_servers: [{\n \"type\": \"url\",\n \"url\": \"https://c15r--81c497c63c0a11f081e29e149126039e.web.val.run/mcp\",\n \"name\": \"val-town-mcp\",\n \"authorization_token\": \"YOUR_TOKEN\",\n }],\n }),\n });\n\n if (!response.ok) {\n const errorData = await response.json();\n throw new Error(`Anthropic API error: ${errorData.error?.message || response.statusText}`);\n }\n\n const data = await response.json();\n\n // Handle tool calls\n let toolCalls: ToolCall[] = [];\n let mcpResponses: any[] = [];\n\n if (data.content) {\n for (const contentBlock of data.content) {\n if (contentBlock.type === \"tool_use\") {\n const toolCall: ToolCall = {\n id: contentBlock.id,\n name: contentBlock.name,\n arguments: contentBlock.input,\n };\n\n try {\n // Execute tool via MCP\n const result = await mcpClient.callTool(contentBlock.name, contentBlock.input);\n toolCall.result = result;\n mcpResponses.push(result);\n } catch (error) {\n toolCall.error = error.message;\n mcpResponses.push({ error: error.message });\n }\n\n toolCalls.push(toolCall);\n }\n }\n }\n\n // Create assistant message\n const assistantMessage: Message = {\n id: (Date.now() + 1).toString(),\n role: \"assistant\",\n content: data.content\n ?.filter((block: any) => block.type === \"text\")\n ?.map((block: any) => block.text)\n ?.join(\"\\n\") || \"No response content\",\n timestamp: new Date(),\n toolCalls: toolCalls.length > 0 ? toolCalls : undefined,\n mcpResponses: mcpResponses.length > 0 ? mcpResponses : undefined,\n };\n\n setMessages(prev => [...prev, assistantMessage]);\n } catch (error) {\n console.error(\"Error sending message:\", error);\n const errorMessage: Message = {\n id: (Date.now() + 2).toString(),\n role: \"system\",\n content: `Error: ${error.message}`,\n timestamp: new Date(),\n };\n setMessages(prev => [...prev, errorMessage]);\n } finally {\n setIsLoading(false);\n }\n };\n\n const clearChat = () => {\n setMessages([{\n id: \"1\",\n role: \"system\",\n content: \"Chat cleared. You can start a new conversation.\",\n timestamp: new Date(),\n }]);\n };\n\n return (\n

\n 🏔️ Val Town MCP Client Demo\n

\n Chat with Claude using Val Town's MCP server capabilities\n

\n\n

\n \n\n

Chat Interface

\n \n Clear Chat\n \n

\n\n \n

\n\n {availableTools.length > 0 && (\n

\n Available MCP Tools ({availableTools.length})\n

\n {availableTools.map((tool, index) => (\n

{tool.name}

{tool.description}

\n ))}\n

\n )}\n

\n\n \n

\n );\n}",[],[237,244,260],{"_103":267,"_95":268,"_152":269,"_154":245,"_155":137,"_156":136,"_158":159,"_105":270,"_100":157,"_161":181,"_163":271,"_164":22,"_165":-5,"_166":272,"_98":273},"406eb4f4-3cd8-11f0-8bd2-9e149126039e","ChatInterface.tsx","c29dafca-3c0b-11f0-99d2-9e149126039e",["D",1748555993999],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport React, { useState, useRef, useEffect } from \"https://esm.sh/react@18.2.0?deps=react@18.2.0\";\nimport { Message } from \"./App.tsx\";\n\ninterface ChatInterfaceProps {\n messages: Message[];\n onSendMessage: (content: string) => void;\n isLoading: boolean;\n availableTools: any[];\n}\n\nexport function ChatInterface({ messages, onSendMessage, isLoading, availableTools }: ChatInterfaceProps) {\n const [input, setInput] = useState('');\n const messagesEndRef = useRef(null);\n\n const scrollToBottom = () => {\n messagesEndRef.current?.scrollIntoView({ behavior: \"smooth\" });\n };\n\n useEffect(() => {\n scrollToBottom();\n }, [messages]);\n\n const handleSubmit = (e: React.FormEvent) => {\n e.preventDefault();\n if (input.trim() && !isLoading) {\n onSendMessage(input.trim());\n setInput('');\n }\n };\n\n const formatTimestamp = (date: Date) => {\n return date.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });\n };\n\n const renderMessageContent = (message: Message) => {\n if (message.role === 'assistant' && message.toolCalls) {\n return (\n

\n {/* Regular content */}\n {message.content && (\n

\n {message.content.split('\\n').map((line, i) => (\n

{line}

\n ))}\n

\n )}\n \n {/* Tool calls */}\n {message.toolCalls.map((toolCall, index) => (\n

\n 🔧 Tool Call: {toolCall.name}\n

\n \n

\n Arguments:\n

\n                    {JSON.stringify(toolCall.arguments, null, 2)}\n

\n \n {toolCall.result && (\n

\n Result:\n

\n                      {JSON.stringify(toolCall.result, null, 2)}\n

\n )}\n \n {toolCall.error && (\n

\n Error:\n

\n                      {toolCall.error}\n

\n )}\n

\n ))}\n

\n );\n }\n\n return (\n

\n {message.content.split('\\n').map((line, i) => (\n

{line}

\n ))}\n

\n );\n };\n\n const getMessageIcon = (role: string) => {\n switch (role) {\n case 'user': return '👤';\n case 'assistant': return '🤖';\n case 'system': return 'ℹ️';\n default: return '💬';\n }\n };\n\n const getMessageBgColor = (role: string) => {\n switch (role) {\n case 'user': return 'bg-blue-50 border-blue-200';\n case 'assistant': return 'bg-green-50 border-green-200';\n case 'system': return 'bg-yellow-50 border-yellow-200';\n default: return 'bg-gray-50 border-gray-200';\n }\n };\n\n return (\n

\n {/* Messages */}\n

\n {messages.map((message) => (\n \n

\n {getMessageIcon(message.role)}\n {message.role}\n

\n \n {formatTimestamp(message.timestamp)}\n \n

\n {renderMessageContent(message)}\n

\n ))}\n \n {isLoading && (\n

\n 🤖\n Assistant\n

\n Thinking...\n

\n )}\n \n

\n\n {/* Input form */}\n

\n setInput(e.target.value)}\n placeholder=\"Ask me anything about Val Town or request tool usage...\"\n disabled={isLoading}\n className=\"flex-1 px-3 py-2 border border-gray-300 rounded-md focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent disabled:bg-gray-100\"\n />\n \n {isLoading ? '⏳' : 'Send'}\n \n \n\n {/* Example prompts */}\n

Try these example prompts:

\n {[\n \"List all available tools\",\n \"Store some data in blob storage\",\n \"Query the SQLite database\",\n \"Send a test email\",\n \"Read a project file\",\n \"Get an environment variable\"\n ].map((prompt, index) => (\n !isLoading && setInput(prompt)}\n disabled={isLoading}\n className=\"px-3 py-1 text-xs bg-gray-200 text-gray-700 rounded hover:bg-gray-300 disabled:opacity-50 disabled:cursor-not-allowed transition-colors\"\n >\n {prompt}\n \n ))}\n

\n );\n}",[],[237,244,268],{"_103":275,"_95":276,"_152":277,"_154":245,"_155":137,"_156":278,"_158":159,"_105":279,"_100":32,"_161":181,"_163":280,"_164":22,"_165":-5,"_166":281,"_98":282},"c93d9f84-3c0b-11f0-a847-9e149126039e","MCPClient.tsx","c93da01a-3c0b-11f0-a847-9e149126039e",17,["D",1748468176700],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\n/**\n * MCP Client for communicating with the Val Town MCP Server\n */\nexport class MCPClient {\n private baseUrl: string;\n private requestId: number = 1;\n\n constructor(baseUrl: string) {\n this.baseUrl = baseUrl;\n }\n\n private async makeRequest(method: string, params?: any): Promise {\n const request = {\n jsonrpc: \"2.0\",\n id: this.requestId++,\n method,\n ...(params && { params })\n };\n\n const response = await fetch(this.baseUrl, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify(request)\n });\n\n if (!response.ok) {\n throw new Error(`HTTP error! status: ${response.status}`);\n }\n\n const data = await response.json();\n \n if (data.error) {\n throw new Error(`MCP Error: ${data.error.message}`);\n }\n\n return data.result;\n }\n\n async initialize(): Promise {\n return this.makeRequest('initialize', {});\n }\n\n async listTools(): Promise {\n const result = await this.makeRequest('tools/list');\n return result.tools || [];\n }\n\n async callTool(name: string, arguments_: any): Promise {\n return this.makeRequest('tools/call', {\n name,\n arguments: arguments_\n });\n }\n\n async listResources(): Promise {\n const result = await this.makeRequest('resources/list');\n return result.resources || [];\n }\n\n async readResource(uri: string): Promise {\n return this.makeRequest('resources/read', { uri });\n }\n\n async ping(): Promise {\n return this.makeRequest('ping');\n }\n}",[],[237,244,276],[237,244],{"_103":285,"_95":286,"_152":287,"_154":238,"_155":137,"_156":136,"_158":159,"_105":288,"_100":254,"_161":218,"_163":289,"_164":22,"_165":-5,"_166":290,"_98":291},"406ebdc8-3cd8-11f0-8bd2-9e149126039e","index.html","902fd09a-3c0b-11f0-8e65-9e149126039e",["D",1748555993999],"\n\n\n \n \n Val Town MCP Client Demo\n \n \n\n\n

\n \n\n",[],[237,286],{"_103":293,"_95":294,"_152":295,"_154":238,"_155":137,"_156":296,"_158":159,"_105":297,"_100":32,"_161":181,"_163":298,"_164":22,"_165":-5,"_166":299,"_98":300},"92c8ed32-3c0b-11f0-8e65-9e149126039e","index.tsx","92c8edfa-3c0b-11f0-8e65-9e149126039e",13,["D",1748468085338],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport React from \"https://esm.sh/react@18.2.0?deps=react@18.2.0\";\nimport { createRoot } from \"https://esm.sh/react-dom@18.2.0/client?deps=react@18.2.0,react-dom@18.2.0\";\nimport { App } from \"./components/App.tsx\";\n\nconst root = createRoot(document.getElementById(\"root\")!);\nroot.render();",[],[237,294],[237],{"_103":303,"_95":304,"_152":305,"_154":-5,"_155":137,"_156":254,"_158":159,"_105":306,"_100":32,"_161":162,"_163":-5,"_164":22,"_165":-5,"_166":307,"_98":316},"cd9d2b82-3c09-11f0-8c8b-9e149126039e","shared","a0461c89-f398-426b-afac-535542e9505b",["D",1748467325043],[308],{"_103":309,"_95":310,"_152":311,"_154":305,"_155":137,"_156":254,"_158":159,"_105":312,"_100":32,"_161":181,"_163":313,"_164":22,"_165":-5,"_166":314,"_98":315},"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}",[],[304,310],[304],{"_103":318,"_95":214,"_152":319,"_154":-5,"_155":137,"_156":320,"_158":159,"_105":321,"_100":180,"_161":218,"_163":322,"_164":22,"_165":-5,"_166":323,"_98":324},"aa44d602-3c0a-11f0-8162-9e149126039e","c9000cca-3c09-11f0-a57a-9e149126039e",11,["D",1748467695240],"# 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### Endpoints\n\n- **Main Interface**: `GET /` - Web interface with documentation\n- **MCP Protocol**: `POST /mcp` - JSON-RPC 2.0 endpoint for MCP requests\n- **Health Check**: `GET /health` - Server health status\n- **API Documentation**: `GET /api/docs` - Complete API documentation in JSON format\n\n### Example MCP Requests\n\n```json\n// Initialize connection\n{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"initialize\",\n \"params\": {}\n}\n\n// List available tools\n{\n \"jsonrpc\": \"2.0\",\n \"id\": 2,\n \"method\": \"tools/list\"\n}\n\n// Call a tool\n{\n \"jsonrpc\": \"2.0\",\n \"id\": 3,\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"blob_set\",\n \"arguments\": {\n \"key\": \"my-data\",\n \"value\": {\"hello\": \"world\"}\n }\n }\n}\n\n// List resources\n{\n \"jsonrpc\": \"2.0\",\n \"id\": 4,\n \"method\": \"resources/list\"\n}\n```\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",[149,168,174,185,194,203,212,222,235,242,249,258,266,274,284,292,302,308,317],"counts",{"_329":32,"_330":180,"_331":32,"_332":32},"pulls","branches","forks","envVars","contents",[],{"_103":223,"_95":224,"_152":225,"_154":153,"_155":137,"_156":226,"_158":159,"_105":336,"_100":228,"_161":229,"_163":230,"_164":22,"_165":231,"_98":337},["D",1748555963084],[151,224],"upstreamProject","upstreamBranch","emptyEnvVars","isNew","flags",[],"routes/_app.x.$handle.$name.branch.$branch.history_.$",{"_93":94,"_95":96,"_97":43,"_98":99,"_101":346,"_218":351,"_354":355,"_401":402,"_414":-7,"_415":32,"_416":22},{"_103":104,"_95":96,"_105":347,"_107":-5,"_108":22,"_109":110,"_111":-5,"_112":-5,"_14":113,"_114":-5,"_115":22,"_116":-5,"_117":32,"_16":118,"_119":120,"_121":120,"_122":123,"_124":123,"_125":123,"_126":120,"_127":120,"_23":348,"_131":349,"_134":350,"_146":22},["D",1748420544100],{"_93":94,"_129":130},{"_93":94,"_133":130},{"_100":136,"_95":43,"_103":137,"_138":104,"_139":-5,"_140":-5,"_141":-5,"_142":-5,"_143":-5,"_144":96,"_145":94},{"_103":223,"_95":224,"_152":225,"_154":153,"_155":137,"_156":226,"_158":159,"_105":352,"_100":228,"_161":229,"_163":230,"_164":22,"_165":231,"_98":353},["D",1748555963084],[151,224],"history",[356,358,364,368,373,379,384,389,394,398],{"_103":223,"_155":137,"_152":225,"_95":224,"_163":230,"_161":229,"_100":228,"_154":153,"_105":357,"_156":226,"_165":231},["D",1748555963084],{"_103":359,"_155":137,"_152":225,"_95":224,"_163":360,"_161":229,"_100":361,"_154":153,"_105":362,"_156":363,"_165":231},"dbb5c6a6-3cd7-11f0-885c-9e149126039e","/**\n * Val Town MCP Server - Main HTTP Entry Point\n */\n\nimport { Hono } from \"https://esm.sh/hono@3.11.7\";\nimport { readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\nimport { getServerInfo, handleMCPRequest } from \"./mcp/server.ts\";\nimport { MCPRequest } from \"./mcp/types.ts\";\n\nconst app = new Hono();\n\n// Unwrap Hono errors to see original error details\napp.onError((err, c) => {\n throw err;\n});\n\n// Serve frontend files\napp.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\napp.get(\"/shared/*\", c => serveFile(c.req.path, import.meta.url));\n\n// Main MCP endpoint\napp.post(\"/mcp\", async (c) => {\n try {\n const request: MCPRequest = await c.req.json();\n const response = await handleMCPRequest(request);\n\n return c.json(response);\n } catch (error) {\n return c.json({\n jsonrpc: \"2.0\",\n error: {\n code: -32700,\n message: \"Parse error\",\n data: error.message,\n },\n }, 400);\n }\n});\n\n// Main page - Mobile-optimized MCP client demo\napp.get(\"/\", async (c) => {\n const html = await readFile(\"/frontend/index.html\", import.meta.url);\n return c.html(html);\n});\n\n// Server information endpoint (moved to /info)\napp.get(\"/info\", (c) => {\n const serverInfo = getServerInfo();\n\n const html = `\n\n\n\n \n \n Val Town MCP Server\n \n\n\n

🏔️ Val Town MCP Server

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

Demo

\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// Demo/Test page with MCP client (legacy route)\napp.get(\"/demo\", async (c) => {\n const html = await readFile(\"/frontend/index.html\", import.meta.url);\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;",8,["D",1748555825016],36,{"_103":365,"_155":137,"_152":225,"_95":224,"_163":230,"_161":229,"_100":216,"_154":153,"_105":366,"_156":367,"_165":231},"31c32a58-3c7d-11f0-8325-9e149126039e",["D",1748516885187],28,{"_103":369,"_155":137,"_152":225,"_95":224,"_163":370,"_161":229,"_100":189,"_154":153,"_105":371,"_156":372,"_165":231},"2ba38a82-3c7d-11f0-b954-9e149126039e","/**\n * Val Town MCP Server - Main HTTP Entry Point\n */\n\nimport { Hono } from \"https://esm.sh/hono@3.11.7\";\nimport { readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\nimport { getServerInfo, handleMCPRequest } from \"./mcp/server.ts\";\nimport { MCPRequest } from \"./mcp/types.ts\";\n\nconst app = new Hono();\n\n// Unwrap Hono errors to see original error details\napp.onError((err, c) => {\n throw err;\n});\n\n// Serve frontend files\napp.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\napp.get(\"/shared/*\", c => serveFile(c.req.path, import.meta.url));\n\n// Main MCP endpoint\napp.post(\"/mcp\", async (c) => {\n try {\n const request: MCPRequest = await c.req.json();\n const response = await handleMCPRequest(request);\n\n return c.json(response);\n } catch (error) {\n return c.json({\n jsonrpc: \"2.0\",\n error: {\n code: -32700,\n message: \"Parse error\",\n data: error.message,\n },\n }, 400);\n }\n});\n\n// Demo/Test page with MCP client\napp.get(\"/demo\", async (c) => {\n const html = await readFile(\"/frontend/index.html\", import.meta.url);\n return c.html(html);\n});\n\n// Server information endpoint\napp.get(\"/\", (c) => {\n const serverInfo = getServerInfo();\n\n const html = `\n\n\n\n \n \n Val Town MCP Server\n \n\n\n

🏔️ Val Town MCP Server

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

\n Demo\n

\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;",["D",1748516874914],27,{"_103":374,"_155":137,"_152":225,"_95":224,"_163":375,"_161":229,"_100":376,"_154":153,"_105":377,"_156":378,"_165":231},"f4781c12-3c7c-11f0-b954-9e149126039e","/**\n * Val Town MCP Server - Main HTTP Entry Point\n */\n\nimport { Hono } from \"https://esm.sh/hono@3.11.7\";\nimport { readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\nimport { getServerInfo, handleMCPRequest } from \"./mcp/server.ts\";\nimport { MCPRequest } from \"./mcp/types.ts\";\n\nconst app = new Hono();\n\n// Unwrap Hono errors to see original error details\napp.onError((err, c) => {\n throw err;\n});\n\n// Serve frontend files\napp.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\napp.get(\"/shared/*\", c => serveFile(c.req.path, import.meta.url));\n\n// Main MCP endpoint\napp.post(\"/mcp\", async (c) => {\n try {\n const request: MCPRequest = await c.req.json();\n const response = await handleMCPRequest(request);\n\n return c.json(response);\n } catch (error) {\n return c.json({\n jsonrpc: \"2.0\",\n error: {\n code: -32700,\n message: \"Parse error\",\n data: error.message,\n },\n }, 400);\n }\n});\n\n// Demo/Test page with MCP client\napp.get(\"/demo\", async (c) => {\n const html = await readFile(\"/frontend/index.html\", import.meta.url);\n return c.html(html);\n});\n\n// Server information endpoint\napp.get(\"/\", (c) => {\n const serverInfo = getServerInfo();\n\n const html = `\n\n\n\n \n \n Val Town MCP Server\n \n\n\n

🏔️ Val Town MCP Server

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

\n Demo\n

\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;",5,["D",1748516782354],26,{"_103":380,"_155":137,"_152":225,"_95":224,"_163":381,"_161":229,"_100":198,"_154":153,"_105":382,"_156":383,"_165":231},"d375620c-3c0b-11f0-ae1e-9e149126039e","/**\n * Val Town MCP Server - Main HTTP Entry Point\n */\n\nimport { Hono } from \"https://esm.sh/hono@3.11.7\";\nimport { handleMCPRequest, getServerInfo } from \"./mcp/server.ts\";\nimport { MCPRequest } from \"./mcp/types.ts\";\nimport { readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n\nconst app = new Hono();\n\n// Unwrap Hono errors to see original error details\napp.onError((err, c) => {\n throw err;\n});\n\n// Serve frontend files\napp.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\napp.get(\"/shared/*\", c => serveFile(c.req.path, import.meta.url));\n\n// Main MCP endpoint\napp.post(\"/mcp\", async (c) => {\n try {\n const request: MCPRequest = await c.req.json();\n const response = await handleMCPRequest(request);\n \n return c.json(response);\n } catch (error) {\n return c.json({\n jsonrpc: \"2.0\",\n error: {\n code: -32700,\n message: \"Parse error\",\n data: error.message\n }\n }, 400);\n }\n});\n\n// Demo/Test page with MCP client\napp.get(\"/demo\", async (c) => {\n const html = await readFile(\"/frontend/index.html\", import.meta.url);\n return c.html(html);\n});\n\n// Server information endpoint\napp.get(\"/\", (c) => {\n const serverInfo = getServerInfo();\n \n const html = `\n\n\n\n \n \n Val Town MCP Server\n \n\n\n

🏔️ 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;",["D",1748468193842],20,{"_103":385,"_155":137,"_152":225,"_95":224,"_163":386,"_161":229,"_100":157,"_154":153,"_105":387,"_156":388,"_165":231},"d03b930e-3c0b-11f0-92b5-9e149126039e","/**\n * Val Town MCP Server - Main HTTP Entry Point\n */\n\nimport { Hono } from \"https://esm.sh/hono@3.11.7\";\nimport { handleMCPRequest, getServerInfo } from \"./mcp/server.ts\";\nimport { MCPRequest } from \"./mcp/types.ts\";\nimport { readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n\nconst app = new Hono();\n\n// Unwrap Hono errors to see original error details\napp.onError((err, c) => {\n throw err;\n});\n\n// Serve frontend files\napp.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\napp.get(\"/shared/*\", c => serveFile(c.req.path, import.meta.url));\n\n// Main MCP endpoint\napp.post(\"/mcp\", async (c) => {\n try {\n const request: MCPRequest = await c.req.json();\n const response = await handleMCPRequest(request);\n \n return c.json(response);\n } catch (error) {\n return c.json({\n jsonrpc: \"2.0\",\n error: {\n code: -32700,\n message: \"Parse error\",\n data: error.message\n }\n }, 400);\n }\n});\n\n// Server information endpoint\napp.get(\"/\", (c) => {\n const serverInfo = getServerInfo();\n \n const html = `\n\n\n\n \n \n Val Town MCP Server\n \n\n\n

🏔️ 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;",["D",1748468188425],19,{"_103":390,"_155":137,"_152":225,"_95":224,"_163":391,"_161":229,"_100":254,"_154":153,"_105":392,"_156":393,"_165":231},"cd5d87a0-3c0b-11f0-99d2-9e149126039e","/**\n * Val Town MCP Server - Main HTTP Entry Point\n */\n\nimport { Hono } from \"https://esm.sh/hono@3.11.7\";\nimport { handleMCPRequest, getServerInfo } from \"./mcp/server.ts\";\nimport { MCPRequest } from \"./mcp/types.ts\";\nimport { readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n\nconst app = new Hono();\n\n// Unwrap Hono errors to see original error details\napp.onError((err, c) => {\n throw err;\n});\n\n// Main MCP endpoint\napp.post(\"/mcp\", async (c) => {\n try {\n const request: MCPRequest = await c.req.json();\n const response = await handleMCPRequest(request);\n \n return c.json(response);\n } catch (error) {\n return c.json({\n jsonrpc: \"2.0\",\n error: {\n code: -32700,\n message: \"Parse error\",\n data: error.message\n }\n }, 400);\n }\n});\n\n// Server information endpoint\napp.get(\"/\", (c) => {\n const serverInfo = getServerInfo();\n \n const html = `\n\n\n\n \n \n Val Town MCP Server\n \n\n\n

🏔️ 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;",["D",1748468183618],18,{"_103":395,"_155":137,"_152":225,"_95":224,"_163":396,"_161":229,"_100":180,"_154":153,"_105":397,"_156":228,"_165":231},"851a1798-3c0a-11f0-8265-9e149126039e","/**\n * Val Town MCP Server - Main HTTP Entry Point\n */\n\nimport { Hono } from \"https://esm.sh/hono@3.11.7\";\nimport { handleMCPRequest, getServerInfo } from \"./mcp/server.ts\";\nimport { MCPRequest } from \"./mcp/types.ts\";\n\nconst app = new Hono();\n\n// Unwrap Hono errors to see original error details\napp.onError((err, c) => {\n throw err;\n});\n\n// Main MCP endpoint\napp.post(\"/mcp\", async (c) => {\n try {\n const request: MCPRequest = await c.req.json();\n const response = await handleMCPRequest(request);\n \n return c.json(response);\n } catch (error) {\n return c.json({\n jsonrpc: \"2.0\",\n error: {\n code: -32700,\n message: \"Parse error\",\n data: error.message\n }\n }, 400);\n }\n});\n\n// Server information endpoint\napp.get(\"/\", (c) => {\n const serverInfo = getServerInfo();\n \n const html = `\n\n\n\n \n \n Val Town MCP Server\n \n\n\n

🏔️ 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

History for index.ts