BAMF.ai

Add a knowledge or memory document to a creator space. API documentation: https://bamf.ai/docs/mcp/overview

Register an external media URL as a BAMF media asset. API documentation: https://bamf.ai/docs/mcp/overview

Add a short durable memory to the creator's knowledge base.

Admit the exact queued campaign into executing state after rechecking current list, connector, fingerprint, and approval, returning canonical binding and admission evidence. This is admission only: it never calls a provider and is not proof of send or delivery.

Finish or skip one BAMF Bot setup step and save it on the same record as the web onboarding, so the person can continue on bamf.ai or here. Optionally saves their answer for the step and their profile basics (name, website, LinkedIn, role, industry, bio). Returns the updated onboarding status, including any credit rewards BAMF verified.

Approve the exact prepared campaign fingerprint until an explicit expiry. Approval alone never queues or sends.

Archive a saved Profile Studio package after exact approval. Archive is reversible through update_profile_package and never changes LinkedIn.

Apply engagement boost to a post. Published posts boost immediately; scheduled posts are armed for publish time. Requires the posts:boost scope.

Cancel a queued or running BAMF async job.

Cancel a prepared, approved, or queued campaign without invoking a provider.

Request cancellation of one scoped outreach discovery session. This cancels discovery only and never mutates a provider campaign.

Check a client's LinkedIn login status in BAMF Connect and Multilogin. Agency staff keys only. Read-only.

Create a content idea for a creator space.

Create a secure hosted content-interview link for a creator. It returns ready-to-share copy for BAMF.ai, Slack, WhatsApp, or another connected conversation, but never starts an in-channel interview or sends through a provider.

Save an interview transcript as a BAMF knowledge document and optionally queue interview-specific knowledge processing.

Create an async BAMF generation/research job. Prefer typed tools such as generate_post, run_research, generate_image, and generate_carousel_pdf.

Create a Media Library folder for a creator space after user approval.

Create a draft post for a creator space after the user approves exact content. Defaults to LinkedIn; pass platform=x for X drafts. Supports first comments and media fields.

Create a client post request: the BAMF team drafts it into the client's Notion content approval board (status "Post request") and is pinged in the client's Slack channel per agency rules. Use for managed (agency client) creators; it does not publish.

Save a new versioned Profile Studio package after exact user approval. This reversible BAMF record write does not apply changes or publish anything to LinkedIn.

Create a client project destination for site artifacts. Requires sites:write; supply title and agent_lanes in params.

Create a Video Studio project (viral_repurpose or talking_head) and return the artifact the BAMF work pane opens.

Create an X-native draft after exact approval. Use for single X posts, threads, image posts, long-form X drafts, and resource/DM campaign drafts; this does not publish.

Record a client decision on an approval request: approved, changes_requested (comment required) or rejected; team members may only resubmit as pending. Requires client_approvals:write. Approving never schedules or publishes.

Delete a normal BAMF content post.

Duplicate a saved Profile Studio package as a draft variation after exact approval. This is reversible and never applies the variation to LinkedIn.

Edit ONE slide of an existing carousel post in place, the same as asking the in-app BAMF Bot to change one slide. Pass title/body/cta/content to change the slide copy, image_instruction to edit that slide's current image (everything else kept), or rerender=true to re-render a prompt-carousel page from its stored spec (hand-built prompt carousels re-render their cover and close; the spec is derived from the slides, caption keyword and author headshot). The prior slide copy/image is saved in carousel_slides[].text_versions/image_versions/versions. Always updates post_id; never creates a post. Slides are 1-based over the displayed (image) slides, the same numbering as the in-app BAMF Bot. Image edits return an async job; rebuild the PDF afterwards if the post has one.

Patch an existing draft or scheduled post after the user approves exact edits. Supports first comments and media fields.

Edit the post's CURRENT image in place (same path as the in-app chat image edit). Default keeps everything else the same; brand marks are left out unless the instruction asks for them. The replaced image is appended to generation_metadata.image_history so bamf.revert_post_version can restore it. Pass reference_version (an image_history index) to also give the editor an earlier version. Always updates post_id; never creates a post. Returns an async job.

Ensure a client's cloud-browser profile has a residential proxy (attaches one when missing, no-op when healthy). BAMF platform admin only. TWO-STEP: confirm=false (default) returns the plan only; call again with confirm=true only after the operator approves. Optional country/region/city set the initial location. Proxy host and credentials are never returned. Reports 'not available yet' until the cloud browser engine supports it.

Estimate the projected first-wave reach (people, reactions, comments) for boosting a creator's post.

List the longest-running competitor ads (Meta, LinkedIn, TikTok) already tracked in the creator's workspace: advertiser, headline, copy, format, days running. Longest-running is the performance proxy. Optional platform and text filter. Read-only.

Find top AI-tagged example posts for a funnel stage (and optional format) to model a draft on: inspiration library (by likes), post templates, or the creator's own posts (by impressions). Returns excerpt, stage, format, media type, and metrics. Read-only.

Finish a draft before it is shown for approval: review the whole draft end to end (every platform version, tweet, slide and image) for coherence, flow, completeness, brand and foreign logos, then fix what is unfinished (split or tighten tweets, write missing tweets or slides, align the set's facts, regenerate a failed visual, clean a source's branding). Returns ready (Top pick eligible) or finishing with the open defects. Never schedules or publishes.

Follow a creator profile in a workspace.

STYLE CARDS FIRST: before the first visual of a request, call bamf.list_style_options and show the user the 4 options as a labelled 2x2 of images; ask them to pick (or say 'show 4 more' or 'try another format'), then pass the chosen style_id. Never generate a visual blind. Generate carousel slide images, package them as a LinkedIn-ready PDF, and optionally attach it to a post. Pass reference_bindings to preserve official identity/product/brand truth separately from inspiration used only for style/layout. Slide copy should follow the source post structure when relevant while rephrasing for clearer, more emotional visual impact instead of repeating the post verbatim. For data-backed decks, pass source_urls/research_notes or run bamf.run_research first; visible data must be source-backed. If likenessReferenceImageUrls is omitted, BAMF uses the creator avatar/LinkedIn profile image as the default likeness reference.

Convert existing slide image URLs into a LinkedIn-ready carousel PDF and optionally attach it to a post.

Generate evidence-backed creator post ideas with source labels, why-now context, creator fit, and confidence. External research is adaptive by default; private X bookmarks are opt-in and can be limited to selected folder ids.

STYLE CARDS FIRST: before the first visual of a request, call bamf.list_style_options and show the user the 4 options as a labelled 2x2 of images; ask them to pick (or say 'show 4 more' or 'try another format'), then pass the chosen style_id. Never generate a visual blind. Create a BAMF image generation job. Supports quote cards, creator portraits, infographics, animated infographics (GIF + MP4 via format=motion_infographic), and package-bound LinkedIn profile banners/Featured images. Pass reference_bindings to preserve official identity/product/brand truth separately from inspiration used only for style/layout. For profile_banner/profile_featured, profile_package_id and profile_asset_kind are required; BAMF enforces one output and deterministic LinkedIn crop dimensions, then returns a durable profile_package_asset from bamf.get_job. For image_quote, create an original standalone visual quote from the post takeaway instead of asking the user to choose a pull quote or copying source text. Poll with bamf.get_job before attaching or scheduling.

Generate post concepts and a reviewable draft candidate from BAMF unified creator context. Defaults to LinkedIn; pass platform=x for X-native hooks, threads, and growth-focused drafts. If the brief involves recent news, trends, benchmarks, or exact numbers, pass research_policy/source_urls/research_notes or run bamf.run_research first. If the brief needs creator POV, pass mini_interview_answers or ask up to three focused questions. post_type and media_plan formats are textual recommendations only; this tool does not generate image, video, audio, or other media assets. This creates an async job only and does not create, schedule, or publish a post.

Generate a reviewable edit proposal, quality audit, deterministic quality comparison, and PATCH payload for a draft, scheduled post, or rough pasted draft. Use edit_mode=full_rewrite for weak/generic/third-person drafts. If the edit needs current facts or data, pass research_policy/source_urls/research_notes or run research first; if it needs authentic POV, pass mini_interview_answers or ask up to three focused questions. This creates an async job only; it does not patch the post.

STYLE CARDS FIRST: before the first visual of a request, call bamf.list_style_options and show the user the 4 options as a labelled 2x2 of images; ask them to pick (or say 'show 4 more' or 'try another format'), then pass the chosen style_id. Never generate a visual blind. Create a paid Higgsfield Seedance 2.5 video job. Pass image_url or an official likeness reference binding to use image-to-video and preserve the creator shown in the approved source image; otherwise BAMF uses text-to-video. Poll with bamf.get_job; success returns a BAMF-hosted MP4 media asset plus the provider request receipt.

Read the video script brief for a project, or save the approved script, burned-in caption, and post copy back onto it.

Generate X-native single posts, threads, image posts, resource/auto-DM posts, long-form X posts, replies, quotes, or bookmark remixes from creator context, X bookmarks, and saved X analytics. This creates an async review job only.

Return the current BAMF app/Stack/API/MCP workflow capability map, safety contract, skill routing, and preferred tools. Use this before planning a BAMF Bot workflow.

Return a versioned, positive-projection creator context for the server-authorized creator space.

Return the authenticated BAMF actor identity through the canonical server-resolved authority path.

Get LinkedIn Late-authoritative analytics totals for a creator space. Pass platform=x or use bamf.get_x_analytics_summary for X metrics.

Read your personal or company brain as Brain format v1 files. Returns the manifest plus BRAIN.md and the brain markdown files, with secrets redacted. Company brain requires an owner, admin, manager or client role.

Read a client's LinkedIn access checklist: authenticator key in BAMF Vault, LinkedIn login on BAMF Cloud, Multilogin profile, BAMF Connect, LinkedIn posting OAuth, and the detected LinkedIn plan (Sales Navigator green, other plans amber with the upgrade link). Agency owner/admin only; API keys need the client_access:read scope. Never returns secrets.

Read one content approval request with its post and comments. Requires client_approvals:read.

Get the current 6-digit LinkedIn authenticator code for a client from their BAMF Vault key, so nobody relays PINs. Agency owner/admin only; API keys need the client_access:totp scope (posts:read is not enough). Rate-limited. A reason is required and every code is logged (who, when, why). Never returns the setup key.

Build a native, interactive LinkedIn analytics report across every creator space the signed-in BAMF account can access. Use for creator portfolios, leaderboards, 30/60/90-day comparisons, charts, profile links, and BAMF drill-down links instead of manually calling analytics once per creator.

Return the comprehensive creator context bundle for one creator space: knowledge docs, voice profile, AI analyses, integrations, interviews, LinkedIn profile/posts/analytics, website, website screenshot, brand kits, media, and REST/MCP availability notes. Sections are scope-gated and report omitted sections when the key lacks a read scope.

Get a creator's TOF/MOF/BOF funnel mix from tagged LinkedIn posts: per-stage counts and performance, per-format stats, the resolved goal target (audience_growth 60/30/10, balanced 45/35/20, pipeline 30/45/25, launch 30/30/40, or the creator override), gaps vs target, neglected stages, best formats per stage, and a quotable gap line. Read-only.

Read recent intelligence processing jobs for the authenticated creator, optionally limited to one resource.

Get source-linked evidence, facts, and relationships for one intelligence resource the authenticated creator can access.

Read one BAMF async job status and output.

Start or resume BAMF Bot setup for the signed-in person: the same ordered steps, progress and rewards as onboarding on bamf.ai. Returns each step with its status, how to run it here (ask, call a listed BAMF tool, or share web_url), the next step and time saved. Creates the person's creator space on first use if they just signed up from this app.

Read redacted state, canonical workspace/list-version/connector bindings, readiness evidence, admission evidence, and any matching provider-confirmation receipt for one tenant- and principal-scoped campaign.

Read the status of one tenant- and principal-scoped outreach discovery session. This never mutates a provider.

Return the profile represented by this request's authenticated credentials. The opaque id is unique within this app and remains unchanged across token refresh, reconnection, and display-metadata changes.

Read safe Original/current profile capture status for a creator. It returns timestamps and verification state, never capture provenance, browser runs, or raw provider payloads.

Read one saved Profile Studio package. This is BAMF package data only, not a live LinkedIn profile read or application.

Live named status of an agent run or API job: the run, its sub-agents, tool calls, status, partial result, cost, and timing. Poll with after_sequence set to the last seen sequence to fetch only new events. Same events as the chat stream and the REST SSE stream.

Read site sessions, previews, version source/diffs, access, Site tool capabilities, merch reviews, print templates, and connection history. For get_site_builds, params may include the optional positive integer before_version returned as versions_page.next_before_version to load the next 20 metadata-only history rows. Requires sites:read. Existing authorized managed client workspace required.

Read exact persisted client project HTML artifact/version including content and provenance. Requires sites:read; params needs artifact_id and optional version_id.

Read the video analytics rollup (Reels/Shorts/TikTok views, watch-through, saves) that sync-video-analytics maintains.

Get saved X analytics totals, top posts, and latest follower/profile snapshot for a creator space.

Replies posted from BAMF on X vs the safety caps (today, this hour, spacing, per-author, link share, near-duplicates) with any flags. Check before proposing more replies.

Hand a working session between this agent and bamf.ai. direction=to_bamf stores a context packet (goal, decisions, open_steps, recent_turns, notes) into the linked bamf.ai chat (pass external_session_id, or agent_session_id) and returns its URL so the user can continue there. direction=from_bamf returns the packet and recent turns for a bamf.ai chat (agent_session_id) so you can continue it here. Never sends messages or posts.

Return a design reference's template markdown with BAMF slots (name, logo, palette, fonts) filled from the creator's brand kit. Read-only; provide reference_id or slug plus brand_kit_project_id or creator_id.

Text a client an invite to their BAMF space from the BAMF line (+1 213-853-2189). Agency staff keys only. Finds the client's mobile from their Notion space, then GoHighLevel; asks when neither has it (pass phone). The invite is client role with client view locked (only the agency owner can change it). TWO-STEP: confirm=false (default) returns the plan only (number source, masked number, SMS draft with {invite_link}); call again with confirm=true only after the user approves that exact text. Never treat an earlier approval as standing permission.

Register this Claude Code / Claude / ChatGPT session with BAMF so it shows in the user's bamf.ai Recent chats (with the client's logo) and can be continued there or resumed locally. Creates or updates one linked bamf.ai chat and returns its URL plus, for Claude Code, the documented resume command (claude --resume <id>). Safe to call repeatedly; it only bumps last activity. Send the same external_session_id each time.

Return versioned, positive-projection brand packs and brand-kit projects for server-authorized creator spaces.

Return versioned, positive-projection media assets for server-authorized creator spaces.

List saved AI analysis reports for a creator profile and LinkedIn analytics performance.

List the BAMF-labeled engagement groups (LinkedIn) a post can be boosted into, with name, category, region, language, industry tags, and member count. Optionally filter to a creator's matched groups.

List available engagement boost tiers (basic/power/mega) with reach and token cost.

List creator brand packs, generated brand kit projects/pages, and github_site_brand: the palette, fonts, theme, logos and DESIGN.md/BRAND.md guidelines read (read-only) from the creator's own site repo, kept current on every push.

List content approval requests for the workspaces this connection can reach. Requires client_approvals:read.

List the client's shared Slack channels this creator space can post into (client channels only; agency-internal channels are never listed). Requires creator_spaces:read.

List creator profiles followed by a workspace.

List creator spaces available to the authenticated BAMF API key. Defaults to a compact paginated discovery projection; request detail=full only when the complete public creator record is required.

List curated design references (non-rejected) with name, category, tags, fonts, palette, and source attribution. Never returns raw HTML. Use the id or slug with bamf.instantiate_design_reference. Pass platform (linkedin|x|instagram) and/or post_type to get the built-in brand-free default post references (category post_reference: aspect ratio, copy skeleton, do/don't notes); brand kits always win over them. include_guide=true also returns the official repurposing guide.

List content ideas for a creator space.

List connected creator integrations and per-author integration settings without exposing tokens, cookies, or secrets.

List creator interviews from transcript knowledge documents and app-native chat interview sessions.

List recent BAMF async jobs for a creator space.

List discovered LinkedIn-native posts for a creator with Late-authoritative official_* performance fields when available.

List media assets for a creator space.

List Media Library folders for a creator space.

List a client creator's recent post requests with their pipeline state and Notion link.

List every saved version of a post: copy versions (post history), the post image_history, and each carousel slide's image and text versions. Use the ids/indexes with bamf.revert_post_version.

List a creator's posts by lifecycle status (draft, in_review, approved, scheduled, published, failed, archived, idea), newest first, with preview-ready content, media and first comments. Use status=draft to review drafts, then bamf.preview_post or bamf.edit_post by id.

List saved Profile Studio packages for a creator. Returns safe package content and selection state, never raw capture provenance or provider credentials.

List the current bounded catalog of saved master-contact lists, supported CRM system segments, and receipt-verified reviewed CRM lead lists in your signed-in workspace. Unmarked manual CRM lists and company/unknown domains are not included. The first 100 combined entries are returned and completeness is false. JWT session and CRM read access required; no provider calls.

List upcoming scheduled posts with preview-ready content, media, carousel slides, and first comments.

List client projects available as destinations for site HTML artifacts. Requires sites:read.

Discover authorized managed client workspaces for hosted site operations. Requires sites:read. Returns IDs and names only.