# Documentation

- [Overview](/docs): Build and run Blitflow workflows from code — HTTP API, TypeScript SDK, and MCP server.
- [Quickstart](/docs/quickstart): Create a token, explore the node palette, and run your first workflow.
- [Authentication](/docs/authentication): Bearer tokens, personal access tokens, device login, and scopes.

- **Concepts**
- Concepts
  - [Workflow definitions](/docs/concepts/workflows): The JSON shape of a workflow — nodes, uses refs, and the derived interface.
  - [Nodes & specs](/docs/concepts/nodes): The node palette, node specs, connectors, and why you should never guess inputs.
  - [Artifacts](/docs/concepts/artifacts): The value envelope for run inputs and outputs — ref vs inline.
  - [Runs & streaming](/docs/concepts/runs): Run lifecycle, streamed events, and cost control.
  - [Versioning](/docs/concepts/versioning): Immutable published versions, semver selectors, and the @latest pointer.

- **Guides**
- Guides
  - [Browse the node palette](/docs/guides/browse-nodes): List and search available nodes — the same task on every surface.
  - [Run a single node](/docs/guides/run-a-node): Execute one node by id with inputs — no workflow needed.
  - [Run a workflow & stream events](/docs/guides/run-a-workflow): Execute a multi-node graph and follow its progress — on every surface.

- **Reference**
- HTTP API
  - [API overview](/docs/api): Base URL, authentication, conventions, and errors for the /v1 HTTP API.
  - [Nodes](/docs/api/nodes): List, search, and inspect the node palette.
  - [Workflows](/docs/api/workflows): Fetch published workflow versions and their definitions.
  - [Runs](/docs/api/runs): Start workflow runs (SSE) and single-node runs; retrieve a run's persisted outputs.
- TypeScript SDK
  - [SDK setup](/docs/sdk): Install the TypeScript SDK and create a client.
  - [Running workflows](/docs/sdk/running-workflows): run(), startRun(), streamed events, and fetching published definitions.
  - [Building workflows](/docs/sdk/building-workflows): Author workflow definitions dynamically — the draft builder and graph conversion.
  - [Nodes & single runs](/docs/sdk/nodes): Discover node specs and run single nodes from the SDK.
- MCP server
  - [MCP server](/docs/mcp): Connect AI agents to Blitflow via the Model Context Protocol.
  - [Tools](/docs/mcp/tools): The five Blitflow MCP tools and their parameters.
- [CLI](/docs/cli): Author and run workflows from the terminal.