Snake MCP

\n Classic Nokia Snake as an MCP App, with SQLite high scores and a leaderboard.\n

MCP endpoint

\n \n

\n Connect this URL in Claude, Cursor, or any MCP Apps-capable client, then ask to\n play snake or show the leaderboard.\n

\n view source\n ·\n preview app html\n

\n \n\n\n","label",[18],"pulls","branches","forks","envVars",{"_175":26,"_177":26},"connections",{"_175":26,"_176":26},"count","unfilledCount","emptyCount",{"_32":219,"_13":220,"_65":221,"_42":-5,"_34":35,"_161":111,"_162":85,"_36":222,"_38":39,"_67":21,"_164":223,"_68":24,"_166":-5,"_189":224,"_17":225},{"_32":212,"_13":213,"_65":214,"_42":-5,"_34":35,"_161":39,"_162":85,"_36":215,"_38":26,"_67":197,"_164":216,"_68":24,"_166":-5,"_189":217,"_17":218},{"_32":160,"_13":18,"_65":66,"_42":-5,"_34":35,"_161":39,"_162":85,"_36":209,"_38":26,"_67":21,"_164":165,"_68":24,"_166":-5,"_189":210,"_17":211},{"_32":201,"_13":202,"_65":83,"_42":-5,"_34":35,"_161":203,"_162":85,"_36":204,"_38":39,"_67":205,"_164":206,"_68":24,"_166":-5,"_189":207,"_17":208},{"_32":192,"_13":193,"_65":194,"_42":-5,"_34":35,"_161":195,"_162":85,"_36":196,"_38":39,"_67":197,"_164":198,"_68":24,"_166":-5,"_189":199,"_17":200},{"_32":184,"_13":185,"_65":186,"_42":-5,"_34":35,"_161":39,"_162":85,"_36":187,"_38":26,"_67":21,"_164":188,"_68":24,"_166":-5,"_189":190,"_17":191},"d4789307-4623-4e0a-8e11-2ca97f0918e4","snake-app.html","01a0912b-84e6-74a0-a575-d6549a8fc7a3",["D",1789141943407],"\n\n\n \n \n \n Snake\n \n\n\n

NOKIA · SNAKE

\n SCORE 0\n SNAKE\n

GAME OVER

Enter your name for the leaderboard

\n \n \n \n

\n \n \n \n \n \n \n

Arrow keys or D-pad · eat food · don't hit walls or yourself

\n\n \n \n\n \n\n\n","children",[],[185],"ebfd8e53-cd3c-49ef-a587-9d908ea8e1ab","mcp.ts","01a0912b-84e6-74a0-a575-d016c6595844",2,["D",1789142094905],"script","import { McpServer } from \"npm:@modelcontextprotocol/sdk@1.29.0/server/mcp.js\";\nimport {\n registerAppResource,\n registerAppTool,\n RESOURCE_MIME_TYPE,\n} from \"https://esm.sh/@modelcontextprotocol/ext-apps@1.7.4/server?target=deno\";\n\nimport { httpEndpoint, readFile } from \"https://esm.town/v/std/utils/index.ts\";\nimport { z } from \"npm:zod@3.25.76\";\nimport { formatLeaderboard, getLeaderboard, submitScore } from \"./db.ts\";\n\nconst SNAKE_RESOURCE_URI = \"ui://snake/mcp-app.html\";\nconst LEADERBOARD_RESOURCE_URI = \"ui://leaderboard/mcp-app.html\";\n\nexport function createServer(): McpServer {\n const server = new McpServer({\n name: \"snake-mcp\",\n version: \"1.0.0\",\n });\n\n registerAppTool(\n server,\n \"play_snake\",\n {\n title: \"Play Snake\",\n description:\n \"Open the classic Nokia-style Snake game. When the snake crashes, the player enters their name and the score is saved to the leaderboard.\",\n inputSchema: {},\n _meta: {\n ui: { resourceUri: SNAKE_RESOURCE_URI },\n },\n },\n async () => {\n const board = await getLeaderboard(5);\n const preview = formatLeaderboard(board);\n return {\n content: [\n {\n type: \"text\",\n text:\n \"Snake is ready! Use arrow keys (or on-screen controls) to play. \" +\n \"When you crash, enter your name to save your score.\\n\\n\" +\n `Top scores:\\n${preview}`,\n },\n ],\n structuredContent: {\n kind: \"snake\",\n topScores: board,\n },\n };\n },\n );\n\n registerAppTool(\n server,\n \"get_leaderboard\",\n {\n title: \"Snake Leaderboard\",\n description: \"Show the top Snake high scores from SQLite.\",\n inputSchema: {\n limit: z\n .number()\n .int()\n .min(1)\n .max(50)\n .optional()\n .describe(\"How many scores to return (default 10)\"),\n },\n _meta: {\n ui: { resourceUri: LEADERBOARD_RESOURCE_URI },\n },\n },\n async ({ limit }) => {\n const board = await getLeaderboard(limit ?? 10);\n return {\n content: [\n {\n type: \"text\",\n text: `Snake leaderboard:\\n${formatLeaderboard(board)}`,\n },\n ],\n structuredContent: {\n kind: \"leaderboard\",\n scores: board,\n },\n };\n },\n );\n\n registerAppTool(\n server,\n \"submit_score\",\n {\n title: \"Submit Snake Score\",\n description:\n \"Save a Snake high score with the player's name. Called by the Snake MCP App after a crash.\",\n inputSchema: {\n name: z.string().min(1).max(20).describe(\"Player name\"),\n score: z.number().int().min(0).describe(\"Final score\"),\n },\n _meta: {\n ui: {\n resourceUri: SNAKE_RESOURCE_URI,\n visibility: [\"app\"],\n },\n },\n },\n async ({ name, score }) => {\n const saved = await submitScore(name, score);\n const board = await getLeaderboard(10);\n return {\n content: [\n {\n type: \"text\",\n text: `Saved ${saved.name} with score ${saved.score}.\\n\\n` +\n `Leaderboard:\\n${formatLeaderboard(board)}`,\n },\n ],\n structuredContent: {\n kind: \"score_saved\",\n saved,\n scores: board,\n },\n };\n },\n );\n\n async function readAppHtml(): Promise {\n const apiBase = new URL(await httpEndpoint()).origin;\n const html = await readFile(\"./snake-app.html\");\n return html.replaceAll(\"__API_BASE__\", apiBase);\n }\n\n registerAppResource(\n server,\n SNAKE_RESOURCE_URI,\n SNAKE_RESOURCE_URI,\n { mimeType: RESOURCE_MIME_TYPE },\n async () => {\n const apiOrigin = new URL(await httpEndpoint()).origin;\n return {\n contents: [\n {\n uri: SNAKE_RESOURCE_URI,\n mimeType: RESOURCE_MIME_TYPE,\n text: await readAppHtml(),\n _meta: {\n ui: {\n csp: {\n resourceDomains: [\n \"https://esm.sh\",\n \"https://cdn.esm.sh\",\n \"https://cdn.jsdelivr.net\",\n ],\n connectDomains: [apiOrigin],\n },\n },\n },\n },\n ],\n };\n },\n );\n\n registerAppResource(\n server,\n LEADERBOARD_RESOURCE_URI,\n LEADERBOARD_RESOURCE_URI,\n { mimeType: RESOURCE_MIME_TYPE },\n async () => {\n const apiOrigin = new URL(await httpEndpoint()).origin;\n return {\n contents: [\n {\n uri: LEADERBOARD_RESOURCE_URI,\n mimeType: RESOURCE_MIME_TYPE,\n text: await readAppHtml(),\n _meta: {\n ui: {\n csp: {\n resourceDomains: [\n \"https://esm.sh\",\n \"https://cdn.esm.sh\",\n \"https://cdn.jsdelivr.net\",\n ],\n connectDomains: [apiOrigin],\n },\n },\n },\n },\n ],\n };\n },\n );\n\n return server;\n}",[],[193],"e54fc2c7-a182-402e-a6be-e3eac5ace119","main.ts",3,["D",1789422431446],"http","import { Hono } from \"npm:hono@4\";\nimport { WebStandardStreamableHTTPServerTransport } from \"npm:@modelcontextprotocol/sdk@1.29.0/server/webStandardStreamableHttp.js\";\nimport { parseVal, serveFile } from \"https://esm.town/v/std/utils/index.ts\";\nimport { createServer } from \"./mcp.ts\";\nimport { getLeaderboard, submitScore } from \"./db.ts\";\n\nconst app = new Hono();\n\n// ----- Dummy OAuth 2.0 endpoints (for Hootsuite Wisdom custom connector) -----\napp.get(\"/authorize\", (c) => {\n const redirectUri = c.req.query(\"redirect_uri\");\n if (!redirectUri) {\n return c.text(\"missing redirect_uri\", 400);\n }\n const state = c.req.query(\"state\") ?? \"\";\n const url = new URL(redirectUri);\n url.searchParams.set(\"code\", \"snake-code\");\n url.searchParams.set(\"state\", state);\n return c.redirect(url.toString(), 302);\n});\n\napp.post(\"/token\", async (c) => {\n const contentType = c.req.header(\"content-type\") ?? \"\";\n let parsed: Record = {};\n if (contentType.includes(\"application/json\")) {\n parsed = (await c.req.json().catch(() => ({}))) as Record;\n } else {\n const text = await c.req.text();\n for (const [key, value] of new URLSearchParams(text)) {\n parsed[key] = value;\n }\n }\n // grant_type, code, redirect_uri, client_id, client_secret, code_verifier are ignored.\n return c.json(\n { access_token: \"snake-dummy-token\", token_type: \"Bearer\" },\n 200,\n {\n \"cache-control\": \"no-store\",\n \"content-type\": \"application/json\",\n },\n );\n});\n\n// ----- /mcp -----\napp.all(\"/mcp\", async (c) => {\n const server = createServer();\n const transport = new WebStandardStreamableHTTPServerTransport({\n sessionIdGenerator: undefined,\n enableJsonResponse: true,\n });\n\n try {\n await server.connect(transport);\n const options =\n c.req.method === \"POST\"\n ? { parsedBody: await c.req.json() }\n : undefined;\n return await transport.handleRequest(c.req.raw, options);\n } catch (error) {\n console.error(\"MCP handler error:\", error);\n return c.json(\n {\n error: \"Internal server error\",\n details: String(error),\n },\n 500,\n );\n }\n});\n\napp.get(\"/api/leaderboard\", async (c) => {\n const limit = Number(c.req.query(\"limit\") ?? 10);\n const scores = await getLeaderboard(\n Number.isFinite(limit) ? Math.min(Math.max(limit, 1), 50) : 10,\n );\n return c.json({ scores });\n});\n\napp.post(\"/api/scores\", async (c) => {\n try {\n const body = await c.req.json();\n const saved = await submitScore(String(body.name ?? \"\"), Number(body.score));\n const scores = await getLeaderboard(10);\n return c.json({ saved, scores });\n } catch (error) {\n return c.json({ error: String(error) }, 400);\n }\n});\n\napp.get(\"/snake-app.html\", async (c) => {\n const { readFile } = await import(\"https://esm.town/v/std/utils/index.ts\");\n const apiBase = new URL(c.req.url).origin;\n const html = (await readFile(\"./snake-app.html\")).replaceAll(\n \"__API_BASE__\",\n apiBase,\n );\n return new Response(html, {\n headers: { \"content-type\": \"text/html; charset=utf-8\" },\n });\n});\n\napp.get(\"/source\", (c) => c.redirect(parseVal().links.self.val));\n\napp.get(\"/\", (c) => serveFile(\"./index.html\"));\n\napp.onError((err) => Promise.reject(err));\n\nexport default app.fetch;\n",[],[202],["D",1789141943407],[],[18],"22b762d5-67ca-4843-94ba-ac4d098b7285","db.ts","01a0912b-84e6-74a0-a575-c41abbb65174",["D",1789141943407],"import { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\n\nexport type ScoreRow = {\n id: number;\n name: string;\n score: number;\n created_at: string;\n};\n\nexport async function ensureSchema() {\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS scores (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n name TEXT NOT NULL,\n score INTEGER NOT NULL,\n created_at TEXT NOT NULL DEFAULT (datetime('now'))\n )\n `);\n}\n\nexport async function submitScore(name: string, score: number): Promise {\n await ensureSchema();\n const trimmed = name.trim().slice(0, 20);\n if (!trimmed) {\n throw new Error(\"Name is required\");\n }\n if (!Number.isFinite(score) || score < 0) {\n throw new Error(\"Score must be a non-negative number\");\n }\n\n await sqlite.execute({\n sql: \"INSERT INTO scores (name, score) VALUES (?, ?)\",\n args: [trimmed, Math.floor(score)],\n });\n\n const result = await sqlite.execute({\n sql: \"SELECT id, name, score, created_at FROM scores ORDER BY id DESC LIMIT 1\",\n args: [],\n });\n return result.rows[0] as ScoreRow;\n}\n\nexport async function getLeaderboard(limit = 10): Promise {\n await ensureSchema();\n const result = await sqlite.execute({\n sql: `\n SELECT id, name, score, created_at\n FROM scores\n ORDER BY score DESC, created_at ASC\n LIMIT ?\n `,\n args: [limit],\n });\n return result.rows as ScoreRow[];\n}\n\nexport function formatLeaderboard(rows: ScoreRow[]): string {\n if (rows.length === 0) {\n return \"No scores yet — be the first on the board!\";\n }\n return rows\n .map((row, i) => `${i + 1}. ${row.name} — ${row.score}`)\n .join(\"\\n\");\n}\n",[],[213],"80d68f7e-84f6-41a7-a591-be225e75c87b","README.md","01a0912b-84e6-74a0-a575-c010a1c57c5d",["D",1789422480072],"# Snake MCP\n\nNokia-style Snake as an **MCP App**, with SQLite high scores and a leaderboard.\n\n## Live URLs\n\n- Val: \n- App home: \n- MCP endpoint: \n\n## Connect a client\n\n```json\n{\n \"mcpServers\": {\n \"snake\": {\n \"url\": \"https://alexmcroberts--28d29b367c8711f18ed61607ee4eb77e.web.val.run/mcp\"\n }\n }\n}\n```\n\nOr with Claude Code:\n\n```bash\nclaude mcp add --transport http snake https://alexmcroberts--28d29b367c8711f18ed61607ee4eb77e.web.val.run/mcp\n```\n\nThen ask: **play snake** or **show the leaderboard**.\n\n## Tools\n\n| Tool | Who | What |\n|------|-----|------|\n| `play_snake` | model | Opens the Snake MCP App |\n| `get_leaderboard` | model | Shows top scores (MCP App UI) |\n| `submit_score` | app only | Saves name + score after a crash |\n\n## How it works\n\n```mermaid\nflowchart LR\n Client[MCP client] -->|play_snake| Server[snake-mcp]\n Server -->|ui://snake/mcp-app.html| App[Snake MCP App]\n App -->|crash + name| Submit[submit_score]\n Submit --> DB[(SQLite scores)]\n Client -->|get_leaderboard| Server\n Server --> DB\n```\n\n1. The host calls `play_snake` and renders the MCP App from `ui://snake/mcp-app.html`.\n2. Play with arrow keys or the on-screen D-pad.\n3. On crash, enter a name — the app calls `submit_score`.\n4. Scores live in this val's SQLite database.\n\n## Files\n\n- `main.ts` — Hono HTTP + Streamable MCP transport\n- `mcp.ts` — tools + MCP App resources\n- `db.ts` — SQLite schema / leaderboard helpers\n- `snake-app.html` — Snake UI (`@modelcontextprotocol/ext-apps`)\n- `index.html` — landing page\nDummy OAuth: GET /authorize, POST /token, static Bearer snake-dummy-token.\n",[],[220],["D",1789141943407],["D",1789489912439],{"_11":12,"_128":71},{"_11":12,"_123":124,"_70":71,"_30":69,"_125":126,"_127":24},{"_38":111,"_13":16,"_32":35,"_112":73,"_113":62,"_114":115,"_116":77,"_117":118,"_119":120,"_121":14,"_122":12},"ctx",{"_51":-5,"_149":264,"_265":266,"_267":268,"_269":24,"_270":24,"_271":24,"_272":85,"_273":-5,"_274":-7,"_275":-7,"_276":26,"_277":24,"_278":24,"_279":-5,"_280":24,"_281":24,"_282":24,"_283":-5},"ENV",{"_235":236,"_237":238,"_239":16,"_240":241,"_242":243,"_244":245,"_246":247,"_248":249,"_250":251,"_252":253,"_254":255,"_256":257,"_258":259,"_260":261,"_262":263},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

History · index.html