OnBrand by SlideSpeak

OnBrand by SlideSpeak is an MCP service and dashboard that gives AI agents access to governed brand knowledge: Brand Guides, Brand Kit assets, color tokens, logo guidance, and presentation design prompts.

The repository is a standalone service. It can run in any environment where you provide a compatible OAuth provider, Postgres database, and S3 bucket.

Quick Start

Prerequisites:

• Bun

• Docker and Docker Compose

• An OAuth provider that can issue JWT access tokens for the OnBrand MCP resource

• An S3-compatible AWS bucket for Brand Kit asset storage

Create local configuration from the public example:

cp .env.example .env

Edit .env with your local OAuth provider and S3 credentials. The default example assumes:

• OnBrand runs at http://localhost:8080.

• The OAuth browser endpoints run at http://localhost:3000.

• Container-to-provider token and JWKS calls use http://host.docker.internal:3000.

• Access tokens include the onbrand:read and onbrand:write scopes as needed.

• The token audience/resource is http://localhost:8080/mcp.

Start the service:

docker compose up --build

OnBrand exposes:

http://localhost:8080/health
http://localhost:8080/mcp
http://localhost:8080/dashboard
http://localhost:8080/.well-known/oauth-protected-resource/mcp

deploy/docker-compose.yml also exposes its bundled Postgres container on host port 5433, so host-side database clients can connect with a URL like postgresql://USER:PASSWORD@HOST:5433/onbrand?schema=public.

Connect an MCP client:

Third-party product names and marks in these examples identify compatible MCP clients only. See NOTICE.md for asset and trademark provenance.

codex mcp add onbrand --url http://localhost:8080/mcp
codex mcp login onbrand

claude mcp add --transport http onbrand http://localhost:8080/mcp

Related MCP server: agent-reader

Configuration

See the auth and runtime configuration guide for the full environment variable table, OAuth provider contract, dashboard session secret guidance, S3 setup notes, and production checklist.

Required environment variables for a real deployment:

Optional environment variables:

Available Tools

• get_onbrand_skill - Get the OnBrand skill for what OnBrand can do and how to use its tools.

• list_brand_guides - List Brand Guides available to the current user.

• get_brand_guide - Get Brand Guide metadata, Brand Kit tokens, asset handles, and Presentation Kit guidance.

• materialize_brand_kit_assets - Get S3 download commands for Brand Kit assets such as logos and decorative files.

• get_brand_guide_writer_skill - Get the skill for authoring a new Brand Guide.

• prepare_brand_guide_asset_uploads - Get S3 upload commands for new logo and decorative asset files.

• write_brand_guide - Create or replace a Brand Guide using uploaded asset references and design guidance.

Development

Useful checks:

bun run format:check
bun run lint
bun run typecheck
bun run test
bun run build
bun run react-doctor:check