BAMF.ai MCP server

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

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

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

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

Persist complete agent-authored HTML as an immutable client project artifact version. Requires sites:write. params needs project_id,title,artifact_format=html,content,provenance {artifact_schema:bamf-visual-artifact/v1,revision,optional provider/source_session_url},idempotency_key. Updates require artifact_id and expected_updated_at. Returns real artifact/version IDs; does not publish.

List hosted sites in an authorized managed client workspace. Requires sites:read; creator-scoped keys and unbound native workspaces are unsupported.

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

Read site sessions, previews, version source/diffs and access. Requires sites:read. Existing authorized managed client workspace required.

Create or revise custom site sessions, context, template or preview versions. Requires sites:write; does not publish. Existing authorized managed client workspace required.

Request or resolve exact publish approval, change access, or execute an approved version operation. Requires sites:publish; preserve approval and version bindings. Existing authorized managed client workspace required.

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.

Search the authenticated creator's indexed media, bookmarks, and documents. Returns source-linked evidence and citations; only reads existing intelligence projections.

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

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

Deterministically route a natural-language BAMF request to the recommended app workflow, BAMF Stack skill, REST endpoints, MCP tools, scopes, and approval policy.

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.

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.

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.

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

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

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

List creator profiles followed by a workspace.

Follow a creator profile in a workspace.

Unfollow a creator profile in 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.

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.

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

Return a rich preview for one post, including media and first comment.

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.

Relay a message to a client through the agency communication gateway (their WhatsApp / iMessage and email). Agency staff keys only. TWO-STEP: confirm=false (default) returns the plan only (client, channels, live or dry-run, exact preview text, warnings) and sends nothing; call again with confirm=true only after the user approves the exact preview. Live delivery is still governed by the gateway's transport allowlist.

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.

Update a client's contact info (phone, email, company) in all three places at once: their BAMF client record, their Notion client page property, and the agency's GoHighLevel contact (updated by email/name match, created when missing). Agency staff keys only. TWO-STEP: confirm=false (default) returns the plan only (what each of the three writes will do, or why one is skipped); call again with confirm=true only after the user approves that plan. Returns a per-target result. Never treat an earlier approval as standing permission.

Send a client a one-tap LinkedIn reconnect link over their preferred channels (BAMF delivers to EVERY resolved channel, not just the first). With no channels given, uses the user's saved preference, defaulting to Slack (posted in the client channel so the team sees it) + SMS + email. The team gets a '✅ reconnected by <name> at <time>' confirmation in Slack once both reconnect steps verify. Agency staff keys only. TWO-STEP: confirm=false (default) returns the plan only (client, channels) and sends nothing; call again with confirm=true only after the user approves. The link itself is never returned.

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

Start a cloud-browser LinkedIn reconnect for a client: opens the client's own scoped BAMF Cloud browser on the LinkedIn sign-in so THEY log in themselves. Credentials are never typed, stored, or returned by BAMF. Client-scoped: the client (or their agent), or the client's agency owner/admin/manager; client may be omitted when you have exactly one client space. TWO-STEP: confirm=false (default) returns the plan only and opens nothing; call again with confirm=true only after the user approves. Returns a session reference; follow progress with bamf.check_linkedin_session. Reports 'not available yet' until the cloud browser engine supports it.

Open a page on the user's own BAMF Cloud computer (a persistent cloud desktop with a full-screen browser) so they can watch the agent use it, live, in their BAMF chat. Runs inside BAMF chat: returns the exact chat message that opens it there. https pages only. LinkedIn opens in the dedicated BAMF Cloud LinkedIn profile.

Ask the user to sign in to a site on their BAMF Cloud computer. The user types their own password and two-step code in the live view; BAMF never types credentials. Returns the exact BAMF chat message that opens the sign-in; the chat waits for the signed-in page, then continues.

Make an infographic PNG (1080x1350) or a 15s motion clip MP4 (1080x1920, Remotion) from a post, built by the user's OWN connected Claude Code (or Codex) on their BAMF Cloud computer. Runs inside BAMF chat: returns the exact chat message that starts it there. BAMF never uses its own Claude/Codex access; if the user has not connected one, the chat asks them to. The file lands in the media library as a draft; nothing is published.

List the plugins the user connected in BAMF for a workspace (GitHub, Gmail, Google Calendar, and remote MCP providers such as Fireflies), each with its status (connected, needs_reauth, not_connected) and the exact tools you can call through bamf.plugins.call: name, short description, access (read or write) and argument hints. Remote MCP tools are listed live. Never returns tokens or secrets. Requires plugins:read. workspace_id is optional: defaults to the key's pinned workspace, else your first workspace.

Run a tool on one of the user's connected plugins, as the user, server-side: GitHub (github.list_repos, github.read_repo), Gmail (gmail.search), Google Calendar (calendar.upcoming, calendar.free_slots), or any remote MCP provider tool (e.g. plugin fireflies, tool fireflies_get_transcripts; tool tools/list lists them). Call bamf.plugins.list first to see what is connected. Read tools need plugins:read; every other remote MCP tool is a write and needs plugins:write. The workspace must be inside the key's pin and the user must be a member. Errors are structured: not_connected (ask the user to connect it at bamf.ai/plugins), needs_reauth, unknown_plugin, unknown_tool, forbidden_scope, forbidden_workspace.

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.

Raw cloud-proxy operations for a client's cloud-browser profile: rotate (fresh IP, same region), relocate (new country/region), or disable. BAMF platform admin only; never agency-scoped. These change the client's apparent location to LinkedIn, so prefer bamf.ensure_proxy. TWO-STEP: confirm=false (default) returns the plan and risk warning only; call again with confirm=true only after the operator approves. Reports 'not available yet' until the cloud browser engine supports it.

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.

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 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.

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

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.

Delete a normal BAMF content post.

Schedule a post for a future time. Creator-scoped API keys may use this. Optionally arm engagement boost so authentic first-hour engagement fires automatically when the post goes live.

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

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

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.

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

Unschedule a post. Creator-scoped API keys may use this.

Pause auto-publishing while keeping the scheduled time visible in BAMF.

Resume a paused scheduled post using its stored scheduled time.

Publish a post immediately. User-scoped keys only; creator-scoped keys receive a helpful 403.

List content ideas for a creator space.

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.

Create a content idea for a creator space.

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.

Read the latest messages (default 20, max 50) from the shared Slack channel pinned in your own client space, as plain text with author and time. Requires creator_spaces:read and membership in that client space; the channel always comes from the space's pin.

Post a message to your agency team in the shared Slack channel pinned in your own client space, sent by the BAMF Slack bot and attributed to you (e.g. "Jonathan (via Muse)"). Requires team_channel:write. TWO-STEP: confirm=false (default) returns the plan and exact preview text and sends nothing; call again with confirm=true only after the user approves the exact preview. Replaying the same idempotency_key never posts twice.

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.

Post a message into the client's own shared Slack channel, attributed to the calling agent. Requires channels:write. Only client channels attached to this creator's workspace are allowed; agency-internal channels are refused. dry_run=true returns the exact text without posting. Replaying the same idempotency_key never posts twice.

Refresh an agency status visual (client content pipeline, approval queue, or client interview progress) inside a Notion page. The snapshot is refreshed in place from BAMF data, it never publishes posts, and it is for agency staff only (platform admin or owner/admin/manager). dry_run=true returns the HTML without calling Notion. Requires client_approvals:write (client_approvals:read for dry_run).

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

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

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.

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

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

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.

Run an async BAMF research brief job over a topic, source URLs, and/or notes. Use it when current/recent facts, benchmark data, trends, or source-backed visual claims would strengthen a post. BAMF uses live web search (treg) when available and returns copy-fit facts, post angles, and a knowledge-doc handoff instead of a raw data dump.

Search creator knowledge documents.

Process a knowledge document or raw content into summaries, durable facts, post ideas, and interview insights. This creates an async job and does not create ideas automatically.

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

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

Save an approved Markdown report, analysis, research result, or dashboard summary as durable BAMF creator knowledge with Claude, ChatGPT, Codex, or BAMF session provenance. Show the exact destination, title, content summary, and provenance to the user before calling this write tool.

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

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.

Propose a change to a brain; the owner approves it in BAMF. This only queues a proposal and never edits the brain.

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

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

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.

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.

Update a saved Profile Studio package after exact approval. The tool first fetches the exact ETag, saves with a stable idempotency key, and validates the returned receipt. This reversible package write does not modify a live LinkedIn profile.

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

Mark a saved Profile Studio package selected after exact approval. Selection is reversible BAMF metadata, not live LinkedIn application or publishing.

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

List media assets for a creator space.

List Media Library folders for a creator space.

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

List creator brand packs and generated brand kit projects/pages.

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.

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.

Attach approved HTTPS style references to a creator-scoped BAMF brand kit. Use append to preserve current references or replace only when the user explicitly asks to replace that asset role. This updates durable brand context; it does not generate or publish media.

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

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

Move selected media assets into a Media Library folder, or clear the folder with folder_id null.

Create a BAMF image generation job. Supports quote cards, creator portraits, infographics, 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 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.

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.

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

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.

Read one server-authorized native people list with explicit master_contacts or crm_leads domain. Master-contact IDs are verified by the scoped native reader; CRM system-segment and receipt-verified reviewed-lead IDs must appear in the current bounded catalog. Unmarked manual CRM lists and company/unknown domains are unsupported. JWT session and CRM read access required; page is bounded and no provider calls or sends occur.

Read people in your authorized client workspace by activity signals, ICP fit, channels, stage, lane, tags, and recency. Requires a signed-in BAMF user session and CRM read access; never calls a provider or sends messages.

Search existing CRM leads in your authorized client workspace by name, company, title, headline, campaign, or connection status. Requires a signed-in BAMF user session and CRM read access; never calls a provider or sends messages.

Start a tenant- and principal-scoped, provider-read-only outreach discovery session. This discovers candidates only; it never creates or sends a campaign.

Resume a scoped outreach discovery session from server-owned coverage. Caller-supplied provider cursors or organization IDs are not accepted as authority.

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

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

Explicitly save the current non-excluded candidates from a completed or partial discovery as a durable list snapshot. This does not create, enroll, or send a campaign.

Prepare a reviewable outreach draft from an owned native master-contact or CRM-lead saved list, or prepare discovery campaign copy against an exact durable list revision and connector account. Native saved lists require a signed-in BAMF user session, CRM read and outreach write access; they create only a local draft and never call a provider, activate, queue or send.

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

Queue an approved exact campaign after its list, connector, fingerprint, and approval remain current. This state transition does not send.

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

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.

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.

Evaluate and persist a reply or follow-up against an exact provider thread/message receipt, current approval, suppression state, and evidence-backed identity. Returns prepared or stopped only and never calls or sends through a provider.

Persist a preparation-only resource giveaway, newsletter, and booking handoff for one exact eligible comment, recipient, account, thread, approval, and artifact revisions. Never calls, sends, or claims delivery through a provider.

List recent BAMF async jobs for a creator space.

Read one BAMF async job status and output.

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.

Cancel a queued or running BAMF async job.

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

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.

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.

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.

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.

Related keywords with monthly search volume, CPC, and competition for a topic, to pick ad targeting. Cached 14 days; a fresh lookup costs about one cent and is capped per workspace per day. Read-only.

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

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

List saved X post analytics rows for a creator, including impressions, likes, replies, reposts, quotes, bookmarks, clicks, engagement rate, and post URLs when available.

List synced private X bookmarks and folders for a creator so agents can generate ideas, bookmark remixes, quote drafts, replies, and resource posts from saved inspiration.

Start an explicit X analytics sync for a creator after user approval. Cron normally keeps this fresh, so use only when the user asks to refresh X analytics now.

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

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

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

Narrate a video project with the creator's own ElevenLabs voice. Requires an authenticated BAMF user session.

Produce or persist word-level burned-in captions for a video project via Whisper. Requires an authenticated BAMF user session when transcribing.

Schedule or publish an exported video project to LinkedIn, X, Instagram Reels, YouTube Shorts, and TikTok. Requires exact user approval of the video, copy, and platform plan.

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

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