Val Town

---
aid: val-town
name: Val Town
description: >-
  Val Town is a social coding platform where JavaScript and TypeScript programs
  called "vals" run instantly as HTTP endpoints, scheduled cron jobs, or email
  handlers without any infrastructure setup. It targets developers who want to
  write and deploy small server-side scripts and APIs directly in the browser.
  Val Town exposes a versioned REST API (v1, v2, v3) at api.val.town covering
  vals management, blob storage, SQLite databases, email sending, telemetry,
  and OAuth connections to third-party services. A TypeScript SDK (@valtown/sdk)
  is autogenerated from the published OpenAPI spec, and a hosted MCP server
  enables LLM-native integrations.
type: Index
image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
tags:
  - Developer Tools
  - Serverless
  - JavaScript
  - TypeScript
  - Social Coding
  - HTTP Endpoints
  - Cron Jobs
  - Email
  - SQLite
  - Blob Storage
url: https://raw.githubusercontent.com/api-evangelist/val-town/refs/heads/main/apis.yml
created: '2026-06-12'
modified: '2026-06-12'
specificationVersion: '0.19'
apis:
  - aid: val-town:rest-api
    name: Val Town REST API
    description: >-
      The primary Val Town REST API providing programmatic management of vals,
      blob storage, SQLite databases, email sending, telemetry logs and traces,
      user accounts, organizations, and OAuth connections to Slack and Google
      Docs. Available in v1, v2, and v3 versions with an OpenAPI 3.x spec
      published at api.val.town/openapi.json.
    humanURL: https://docs.val.town/reference/api/
    baseURL: https://api.val.town
    tags:
      - Vals
      - Blob Storage
      - SQLite
      - Email
      - Telemetry
      - Organizations
    properties:
      - type: Documentation
        url: https://docs.val.town/reference/api/
      - type: OpenAPI
        url: https://api.val.town/openapi.json
  - aid: val-town:typescript-sdk
    name: Val Town TypeScript SDK
    description: >-
      Official TypeScript and JavaScript client library for the Val Town REST
      API, autogenerated from the OpenAPI spec via Stainless. Published as
      @valtown/sdk on npm and supports Node.js 20+, Deno, Bun, and Cloudflare
      Workers runtimes.
    humanURL: https://docs.val.town/sdk/
    tags:
      - SDK
      - TypeScript
      - JavaScript
      - npm
    properties:
      - type: Documentation
        url: https://docs.val.town/sdk/
      - type: GitHubRepository
        url: https://github.com/val-town/sdk
  - aid: val-town:mcp-server
    name: Val Town MCP Server
    description: >-
      Model Context Protocol server hosted by Val Town at
      api.val.town/v3/mcp enabling LLMs and AI agents to interact with Val Town
      resources and run vals programmatically via HTTP transport.
    humanURL: https://docs.val.town/
    baseURL: https://api.val.town/v3/mcp
    tags:
      - MCP
      - AI
      - LLM
      - Model Context Protocol
    properties:
      - type: Documentation
        url: https://docs.val.town/
common:
  - type: Website
    url: https://www.val.town/
  - type: Documentation
    url: https://docs.val.town/
  - type: GitHubOrganization
    url: https://github.com/val-town
  - type: LinkedIn
    url: https://www.linkedin.com/company/val-town
  - type: X
    url: https://x.com/ValDotTown
  - type: Blog
    url: https://blog.val.town/
  - type: Pricing
    url: https://www.val.town/pricing
  - type: StatusPage
    url: https://status.val.town/
  - type: RateLimits
    url: https://www.val.town/limits
  - type: Plans
    url: plans/val-town-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/val-town-rate-limits.yml
  - type: FinOps
    url: finops/val-town-finops.yml
maintainers:
  - FN: Kin Lane
    email: [email protected]