# bitmcp

> bitmcp is a TypeScript framework for building MCP Apps on the 2026-07-28 stateless core. A tool is a server function. A View is a predeclared, hashed HTML resource. Confirmations use MRTR. State uses handles, not sessions.

## Docs

- [Introduction](/docs): TypeScript framework for MCP Apps on the 2026-07-28 stateless core.

## core-concepts

- [Actions](/docs/core-concepts/actions): defineAction, app-only visibility, and namespaced backing tools.
- [Confirmations](/docs/core-concepts/confirmations): confirm(), MRTR input_required, ctx.ask, and execute after accept.
- [Handles](/docs/core-concepts/handles): ctx.handle(), HandleStore, and no sessions.
- [Tools](/docs/core-concepts/tools): defineTool, schemas, return data, result(), and CSP allowlists.
- [Transports](/docs/core-concepts/transports): stdio for dev, Streamable HTTP for production, and capability stripping.
- [Views](/docs/core-concepts/views): Hashed ui:// HTML, the compiler shell, useApp(), and callTool().

## getting-started

- [Connecting to your server](/docs/getting-started/connecting): stdio, Streamable HTTP, preview host, and MCP client setup.
- [Installation](/docs/getting-started/installation): Create a bitmcp app with create-bitmcp and run the dev server.
- [Project structure](/docs/getting-started/project-structure): File-based tool folders, discovery rules, and compiler boundaries.

## guides

- [Deploy](/docs/guides/deploy): Run bitmcp on Node, Vercel, or Cloudflare from one server artifact.
- [Hosts](/docs/guides/hosts): Cursor, Claude, VS Code, ChatGPT, and text-only degradation.

## examples

- [Confirm](/docs/examples/confirm): confirm() maps to MRTR and execute runs after accept.
- [Dashboard](/docs/examples/dashboard): Hashed View, structured result, and forecast.refresh action.
- [Task](/docs/examples/task): Handle returned immediately and View polls job status.

## reference

- [CLI](/docs/reference/cli): bitmcp dev, start, preview, and build commands.
- [Configuration](/docs/reference/config): bitmcp.config.ts, HTTP options, and environment variables.
- [createApp](/docs/reference/create-app): Library escape hatch for tests and custom servers.
- [defineTool and defineAction](/docs/reference/define-tool): Tool options, ToolContext, and Result types.
- [useApp](/docs/reference/use-app): bitmcp/react View runtime and official hook re-exports.