OnBrand by SlideSpeak MCP Server

An MCP server that feeds AI agents your brand's real logos, colors, fonts, and approved slide layouts, so every deck and document comes out on brand the first time.

GitHub
6

Documentation

OnBrand

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

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

Claude Code

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

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:

VariablePurpose
DATABASE_URLPostgres connection string.
BASE_URLPublic OnBrand origin; derives dashboard social metadata and ${BASE_URL}/mcp.
OAUTH_ISSUERExpected JWT issuer.
OAUTH_AUTHORIZATION_ENDPOINTBrowser authorization endpoint.
OAUTH_TOKEN_ENDPOINTToken exchange endpoint.
OAUTH_JWKS_URLJWKS endpoint used to verify access token signatures.
OAUTH_DASHBOARD_CLIENT_IDStatic dashboard OAuth client ID.
OAUTH_REQUIRED_READ_SCOPERead scope required by read-only MCP tools.
OAUTH_REQUIRED_WRITE_SCOPEWrite scope required by mutating MCP tools.
DASHBOARD_SESSION_SECRETSecret used to sign dashboard session cookies.
AWS_S3_BUCKET_BRAND_KIT_ASSETSBucket for uploaded Brand Kit assets.
AWS_REGIONAWS region for the Brand Kit asset bucket.
AWS_ACCESS_KEY_IDAWS access key for S3 operations.
AWS_SECRET_ACCESS_KEYAWS secret access key for S3 operations.

Optional environment variables:

VariablePurpose
OAUTH_REGISTRATION_ENDPOINTDynamic client registration endpoint advertised to MCP clients.
OAUTH_REQUIRED_READ_SCOPERead scope required by read-only MCP tools. Defaults to onbrand:read.
OAUTH_REQUIRED_WRITE_SCOPEWrite scope required by mutating MCP tools. Defaults to onbrand:write.
OAUTH_OWNER_ID_CLAIMJWT claim used as the OnBrand owner identifier. Defaults to sub.
ASSET_DOWNLOAD_EXPIRES_IN_SECONDSPresigned S3 URL lifetime. Defaults to 900.
DASHBOARD_DEV_SERVER_URLDevelopment-only dashboard Vite proxy URL used by docker-compose.yml.

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