documentation

docs

everything to get the most out of brandmint: from your first swipe to the api, plus legal and data terms.

introduction

brandmint learns how you write and turns your ideas into finished posts you approve with a swipe. it reads your public posts to build a voice profile, then drafts in that voice, getting sharper every time you keep or pass on a draft.

there are two ways in: give minty a topic, or let it suggest ideas. both end in the same place: a stack of drafts you swipe through and schedule.

quickstart

  • connect a source. paste your linkedin, site, or any public profile.
  • let minty read. it extracts your voice, angles, and signature phrases.
  • swipe. keep the drafts that sound like you, pass on the rest.
  • schedule. kept drafts land in your calendar. drag to a day and set a time.
no linkedin login is needed to start. brandmint only reads what's public until you connect an account to publish.

how voice learning works

every swipe is a signal. keeps reinforce patterns; passes (and the reason you give) tell minty what to avoid. over time your profile captures tone, structure, hooks, and topics, stored in memory, which you can view or wipe anytime.

swiping & preferences

the swipe deck is the heart of brandmint. drag right to keep, left to pass, or use the buttons. on a pass, minty asks a one-word reason so the next batch improves.

generating drafts

pick a platform; brandmint chooses the format and angle from your profile and returns five drafts. each carries informational label chips (tone, format) so you can see its reasoning.

calendar & scheduling

saved drafts appear as unscheduled in your calendar. drag one onto a day or open it to set a date and time. week and month views are available; scheduling wires to publishing via connectors.

connectors

connect linkedin, instagram, x, and more to publish directly and give minty more context. tokens are revocable at any time from settings.

api reference

authenticate with an api key from settings → api keys. pass it as Authorization: Bearer bm_... or X-API-Key: bm_.... all endpoints return json.

extract voice profile

analyzes your posts to extract tone, hooks, rhythm, formatting, vocabulary, themes, structures, and engagement patterns.

POST /api/v1/voice → { "voice_profile": "Tone: direct, contrarian ..." }

generate post

writes a linkedin post in your voice. if voice_profile is omitted, extracts it first.

POST /api/v1/posts/generate { "topic": "why ops pilots fail", "voice_profile": "..." // optional } → { "post": "...", "voice_profile": "..." }

check quality

scans a draft for ai tells, voice alignment, and factual accuracy. returns a cleaned version.

POST /api/v1/posts/check { "draft": "your post text here...", "voice_profile": "..." // optional } → { "cleaned_post": "..." }

generate ideas

turns a seed topic into 4-6 post ideas with hooks, angles, and subtopics.

POST /api/v1/posts/ideas { "seed": "remote work culture", "objective": "authority" // authority | engagement | dms | lead-magnet }

search posts

search your post history. supports semantic, keyword (bm25), hybrid, engagement, and recency ranking.

POST /api/v1/posts/search { "query": "leadership lessons", "rank_by": "hybrid", "limit": 5 }

content strategy

analyzes your content performance and produces data-backed strategy recommendations.

POST /api/v1/strategy { "timeframe": "30_days" } // 30_days | 60_days | 90_days

profile

read or update your creator profile, content themes, and positioning.

GET /api/v1/profile PATCH /api/v1/profile { "positioning": "ai-native ops for startups" }

save draft

save a finished post with an auto-generated share link.

POST /api/v1/drafts { "post_text": "your final post...", "topic": "ops pilots", "platform": "linkedin" }

rate limits

default: 1,000 requests per day per key. the rate limit resets at midnight utc. if exceeded, the api returns 429.

mcp server

brandmint exposes a hosted mcp endpoint that works with claude code, cursor, windsurf, and any mcp-compatible client. one line of config, all tools appear.

claude code

add to your .claude/settings.json or project config:

{ "mcpServers": { "brandmint": { "type": "url", "url": "https://brandmint.app/api/mcp", "headers": { "Authorization": "Bearer bm_your_key" } } } }

available tools

  • extract_voice — analyze posts, return 8-dimension voice profile
  • generate_post — write a post in your voice (auto-extracts voice if needed)
  • check_quality — scan for ai tells and voice alignment
  • generate_ideas — 4-6 ideas from a seed topic
  • content_strategy — data-backed content performance analysis
  • search_posts — search post history (semantic, keyword, hybrid)
  • get_profile — creator profile, stats, preferences
  • save_draft — save a draft with share link

webhooks

subscribe to events to keep your systems in sync.

  • draft.kept — a draft was swiped right
  • post.scheduled — a draft was placed on the calendar
  • post.published — a post went live via a connector