🏔️ 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;","deleted","label","val-mcp",[169,149],"backend","permalink","https://www.val.town/x/c15r/MCP/code/backend/index.ts","extension","actionData","errors"]