Throughline Approvals

FreeMaintained

Conversational approval workflow server for Throughline. Provides the approval resolver the publishing server consumes plus MCP tools for requesting and respond

by GitHub Actions

GitHub Embed

About

Conversational approval workflow server for Throughline. Provides the approval resolver the publishing server consumes plus MCP tools for requesting and responding to approvals.

README

A conversational content management framework. Exposes Payload CMS as a set of MCP servers so marketers can operate websites through Claude rather than a traditional admin UI.

Documentation

Full documentation lives at docs/ — getting-started tutorials, conceptual explanations of the architecture, how-to guides, per-package reference, and operations docs. Start at docs/README.md.

Status

Pre-1.0. APIs will change. See docs/roadmap.md for phase status and docs/spec/ for the original build plan.

Packages

Published packages live in packages/. Each has its own README.

Plugins:

@forumone/throughline-core — audit log, MCP auth + handler, Inngest client, env helpers
@forumone/throughline-components — components MCP server (manifest-driven content drafting)
@forumone/throughline-publishing — publishing MCP server (publish + scheduled publish, with policy gates)
@forumone/throughline-approvals — approvals MCP server + tokenized email decisions
@forumone/throughline-audit — read-only MCP query tools over the audit log
@forumone/throughline-integrations — pluggable third-party integrations (webhook included)
@forumone/throughline-email — Resend-backed transactional email + React Email templates
@forumone/throughline-forms — Form Builder wrapper with allowlisted destinations + spam/rate-limit hardening
@forumone/throughline-workflows — Inngest workflow factories (revalidate, scheduled publish, expire approvals, healthchecks)

Design system:

@forumone/throughline-design-contract — manifest schema + lint rules
@forumone/throughline-reference-ds — brand-neutral 12-component reference design system

Tooling:

@forumone/create-throughline — interactive scaffolder (pnpm create @forumone/throughline my-site)

Internal, non-published config packages:

@forumone/throughline-tsconfig — shared TypeScript configs
@forumone/throughline-eslint-config — shared ESLint flat config
@forumone/throughline-prettier-config — shared Prettier config

Using in a client project

The fastest path is the scaffolder:

pnpm create @forumone/throughline my-client-site

It asks a small set of questions and produces a pnpm monorepo with Payload, every Throughline plugin, and an Inngest endpoint already wired. The full walkthrough is at docs/getting-started/scaffolding-a-project.md.

Or consume the published packages directly:

pnpm add @forumone/throughline-core @forumone/throughline-publishing

See docs/reference/ for per-package reference.

Development

Requirements: Node.js 20.9+ and pnpm 10+.

pnpm install
pnpm build
pnpm test

Author changes and add a changeset:

pnpm changeset

Open a PR. CI runs build, typecheck, lint, and test. On merge to main, Changesets opens a release PR that publishes to npm on merge.

See CONTRIBUTING.md for details.

from github.com/forumone/throughline

Install Throughline Approvals in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE

unyly install throughline-approvals

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add throughline-approvals --env APPROVAL_TOKEN_SECRET="" -- npx -y @forumone/throughline-approvals

Step-by-step: how to install Throughline Approvals

Install Throughline Approvals in Claude Desktop Install Throughline Approvals in Claude Code Install Throughline Approvals in Cursor Install Throughline Approvals in VS Code

FAQ

Is Throughline Approvals MCP free?

Yes, Throughline Approvals MCP is free — one-click install via Unyly at no cost.

Does Throughline Approvals need an API key?

Yes, it requires environment variables: APPROVAL_TOKEN_SECRET. Unyly injects them into the config during install.

Is Throughline Approvals hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Throughline Approvals in Claude Desktop, Claude Code or Cursor?

Open Throughline Approvals on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.