FeaturesTemplatesShowcaseTownie
AI
BlogDocsPricing
Log inSign up
c15r
c15rMCP
Public
Like
MCP
Home
Code
4
backend
3
frontend
3
shared
1
README.md
Branches
1
Pull requests
Remixes
History
Environment variables
Val Town is a collaborative website to build and scale JavaScript apps.
Deploy APIs, crons, & store data – all from the browser, and deployed in milliseconds.
Sign up now
Code
/
backend
/
README.md
Code
/
backend
/
README.md
Search
5/28/2025
Viewing readonly version of main branch: v32
View latest version
README.md

Backend - MCP Server

This directory contains the MCP (Model Context Protocol) server implementation that exposes Val Town's native capabilities.

Structure

  • index.ts - Main HTTP server entry point
  • mcp/ - MCP protocol implementation
    • server.ts - Core MCP request/response handling
    • tools.ts - Tool definitions and execution handlers
    • resources.ts - Resource discovery and reading
    • types.ts - TypeScript type definitions for MCP protocol

MCP Protocol Methods

Core Methods

  • initialize - Initialize the MCP session
  • ping - Health check

Tools

  • tools/list - List available tools
  • tools/call - Execute a tool

Resources

  • resources/list - List available resources
  • resources/read - Read a resource

Available Tools

  1. Blob Storage

    • blob_get - Retrieve blob data
    • blob_set - Store blob data
    • blob_list - List blob keys
    • blob_delete - Delete blob
  2. SQLite Database

    • sqlite_execute - Execute SQL queries
  3. Email

    • email_send - Send emails
  4. OpenAI

    • openai_chat - Generate text with OpenAI
  5. File Operations

    • file_read - Read project files
    • file_list - List project files
  6. Environment

    • env_get - Get environment variables (names only for security)

Available Resources

  • blob://[key] - Blob storage items
  • file://[path] - Project files
  • sqlite://schema - Database schema
  • env://info - Environment variable info
Go to top
X (Twitter)
Discord community
GitHub discussions
YouTube channel
Bluesky
Product
FeaturesPricing
Developers
DocsStatusAPI ExamplesNPM Package Examples
Explore
ShowcaseTemplatesNewest ValsTrending ValsNewsletter
Company
AboutBlogCareersBrandhi@val.town
Terms of usePrivacy policyAbuse contact
© 2025 Val Town, Inc.