WorksMarketing and socialImages, video and design
BAMF.ai
LinkedIn and X content, scheduling, analytics and outreach agent for founders, via your BAMF login.
https://mcp.bamf.aiclaude mcp add --transport http bamf https://mcp.bamf.aiFor Cursor and other clients
{
"mcpServers": {
"bamf": {
"type": "http",
"url": "https://mcp.bamf.ai"
}
}
}Watch out
Has tools that change things: 18 of them
The server itself marks these tools as deleting or overwriting data (destructiveHint): have the agent ask you before it calls them.
- Test
- Works: Handshake succeeded
- Tools
- 159 tools
- Handshake
- 1.5 s
- Transport
- streamable-http · 2025-06-18
- Tested
- 6 November 2026
- Registry name
ai.bamf/bamfv1.1.0- Listed
- 8 October 2026
- Updated
- 8 October 2026
- Website
- bamf.ai
The last 1 tests
| When | Result | Time |
|---|---|---|
| 2026-11-06 12:09 UTC | Handshake succeeded | 1.5 s |
The 159 tools it listed
"Read only" and "Changes data" are the server's own marks. Underlined parameters are required.
bamf.add_knowledge_docAdd a knowledge or memory document to a creator space. API documentation: https://bamf.ai/docs/mcp/overview
creator_idpathtitlecontenttagsbamf.add_mediaRegister an external media URL as a BAMF media asset. API documentation: https://bamf.ai/docs/mcp/overview
creator_idurlvisual_typebamf.add_memoryAdd a short durable memory to the creator's knowledge base.
creator_idmemorytitlebamf.admit_outreach_campaign_executionAdmit 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.
campaign_idworkspace_idsession_idprincipal_context_ref_idaction_fingerprintidempotency_keybamf.advance_onboardingFinish 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.
creator_idstepoutcomeanswerprofilebamf.approve_outreach_campaignApprove the exact prepared campaign fingerprint until an explicit expiry. Approval alone never queues or sends.
campaign_idworkspace_idsession_idprincipal_context_ref_idapproval_refaction_fingerprintapproval_expires_atidempotency_keybamf.archive_profile_packageArchive a saved Profile Studio package after exact approval. Archive is reversible through update_profile_package and never changes LinkedIn.
profile_package_idbamf.boost_postChanges dataApply engagement boost to a post. Published posts boost immediately; scheduled posts are armed for publish time. Requires the posts:boost scope.
post_idapprovedtierengagement_typebamf.cancel_jobChanges dataCancel a queued or running BAMF async job.
job_idbamf.cancel_outreach_campaignChanges dataCancel a prepared, approved, or queued campaign without invoking a provider.
campaign_idworkspace_idsession_idprincipal_context_ref_ididempotency_keybamf.cancel_outreach_discoveryChanges dataRequest cancellation of one scoped outreach discovery session. This cancels discovery only and never mutates a provider campaign.
discovery_session_idworkspace_idsession_idprincipal_context_ref_idgateway_run_idproviderprovider_account_idcapability_receipt_refidempotency_keybamf.check_linkedin_sessionRead onlyCheck a client's LinkedIn login status in BAMF Connect and Multilogin. Agency staff keys only. Read-only.
clientbamf.create_ideaCreate a content idea for a creator space.
creator_idtitlecontenttagsbamf.create_interview_linkCreate 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.
creator_idlabelexpires_daysmax_usescontact_metadatabamf.create_interview_transcriptSave an interview transcript as a BAMF knowledge document and optionally queue interview-specific knowledge processing.
creator_idtitletranscriptintervieweeinterviewertagsprocessbamf.create_jobCreate an async BAMF generation/research job. Prefer typed tools such as generate_post, run_research, generate_image, and generate_carousel_pdf.
creator_idjob_typeinputbamf.create_media_folderCreate a Media Library folder for a creator space after user approval.
creator_idnameworkspace_idbamf.create_post_draftCreate 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.
creator_idcontenttopicplatformpost_typefirst_commentgenerated_image_urluploaded_image_urldocument_urlvideo_urlarticle_urlarticle_titlefunnel_plansourcesbamf.create_post_requestCreate 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.
creator_ididea_textbrieflinksbamf.create_profile_packageSave a new versioned Profile Studio package after exact user approval. This reversible BAMF record write does not apply changes or publish anything to LinkedIn.
creator_idtitlenotesthumbnail_urlsnapshotbamf.create_site_projectCreate a client project destination for site artifacts. Requires sites:write; supply title and agent_lanes in params.
workspace_idparamsidempotency_keybamf.create_video_projectCreate a Video Studio project (viral_repurpose or talking_head) and return the artifact the BAMF work pane opens.
creator_idtitletemplateaspect_ratiosource_urlsource_asset_idsource_clip_idcaptionbamf.create_x_post_draftCreate 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.
creator_idcontenttopicx_formatthread_itemsmedia_planauto_dm_campaignbamf.decide_client_approvalRecord 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.
approval_idstatuscommentidempotency_keybamf.delete_postChanges dataDelete a normal BAMF content post.
post_idbamf.duplicate_profile_packageDuplicate a saved Profile Studio package as a draft variation after exact approval. This is reversible and never applies the variation to LinkedIn.
profile_package_idtitlebamf.edit_carousel_slideEdit 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.
post_idslidetitlebodyctacontentimage_instructionrerenderbamf.edit_postChanges dataPatch an existing draft or scheduled post after the user approves exact edits. Supports first comments and media fields.
post_idcontentedit_instructiontopicpost_typefirst_commentgenerated_image_urluploaded_image_urlcarousel_slidesdocument_urlvideo_urlarticle_urlarticle_titlebamf.edit_post_imageEdit 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.
post_idinstructionkeep_everything_elsereference_versionbamf.ensure_proxyEnsure 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.
clientcountryregioncityconfirmbamf.estimate_boostRead onlyEstimate the projected first-wave reach (people, reactions, comments) for boosting a creator's post.
author_idtierbamf.find_competitor_adsRead onlyList 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.
platformqcreator_idlimitbamf.find_funnel_examplesRead onlyFind 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.
stageformatsourcecreator_idlimitbamf.finish_draftFinish 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.
post_idbamf.follow_creatorFollow a creator profile in a workspace.
workspace_idauthor_idprofileplatformidempotency_keybamf.generate_carouselSTYLE 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.
creator_idstyle_idtitleslidessizequalityreferenceImageUrlslikenessReferenceImageUrlsstyleReferenceImageUrlsreference_bindingspost_idresearch_policysource_urlsresearch_notesvisual_copy_strategybamf.generate_carousel_pdfConvert existing slide image URLs into a LinkedIn-ready carousel PDF and optionally attach it to a post.
creator_idtitleslide_image_urlspost_idbamf.generate_ideasGenerate 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.
creator_idqueryplatformsformatsinclude_x_bookmarksx_bookmark_folder_idsexternal_research_modeexternal_sourcesbamf.generate_imageSTYLE 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 tex
creator_idstyle_idpromptvisual_typeenginesize_presetformatoutput_formatsprofile_package_idprofile_asset_kindsizequalitynreferenceImageUrlslikenessReferenceImageUrlsstyleReferenceImageUrlsreference_bindingspost_idalt_textresearch_policysource_urlsresearch_notesvisual_copy_strategybamf.generate_postGenerate 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.
creator_idbrieftopicpost_typeplatformtoneinclude_first_commentmedia_planconstraintstemplate_categoryuse_template_inspirationresearch_policysource_urlsresearch_notesevidence_needsinterview_policymini_interview_answersbamf.generate_post_editGenerate 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.
creator_idpost_idcurrent_contentsource_materialcurrent_first_commentinstructionsedit_modetemplate_categoryuse_template_inspirationpreserve_pointsmust_preserveavoiddiagnostic_notespersonalization_notesquality_barmedia_notesresearch_policysource_urlsresearch_notesevidence_needsinterview_policymini_interview_answersbamf.generate_videoSTYLE 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.
creator_idstyle_idpromptimage_urlreference_bindingsdurationresolutionaspect_ratiogenerate_audiobamf.generate_video_scriptRead the video script brief for a project, or save the approved script, burned-in caption, and post copy back onto it.
video_project_idscriptcaptionpost_bodybamf.generate_x_postGenerate 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.
creator_idbriefx_formatengagement_goalthread_lengthsource_materialmedia_planconstraintsresearch_policysource_urlsresearch_notesmini_interview_answersbamf.get_agent_capabilitiesRead onlyReturn 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.
bamf.get_agent_creator_contextRead onlyReturn a versioned, positive-projection creator context for the server-authorized creator space.
creator_idsectionslimitbamf.get_agent_identityRead onlyReturn the authenticated BAMF actor identity through the canonical server-resolved authority path.
bamf.get_analytics_summaryRead onlyGet LinkedIn Late-authoritative analytics totals for a creator space. Pass platform=x or use bamf.get_x_analytics_summary for X metrics.
creator_idplatformbamf.get_brainRead onlyRead 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.
creator_idkindbamf.get_client_approvalRead onlyRead one content approval request with its post and comments. Requires client_approvals:read.
approval_idbamf.get_creator_analytics_reportRead onlyBuild 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.
daysbamf.get_creator_contextRead onlyReturn 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.
creator_idsectionslimitbamf.get_funnel_mixRead onlyGet 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.
creator_iddaysbamf.get_intelligence_processing_statusRead onlyRead recent intelligence processing jobs for the authenticated creator, optionally limited to one resource.
resource_idlimitbamf.get_intelligence_resource_contextRead onlyGet source-linked evidence, facts, and relationships for one intelligence resource the authenticated creator can access.
resource_idbamf.get_jobRead onlyRead one BAMF async job status and output.
job_idbamf.get_onboardingRead onlyStart 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.
creator_idbamf.get_outreach_campaign_statusRead onlyRead 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.
campaign_idworkspace_idsession_idprincipal_context_ref_idbamf.get_outreach_discovery_statusRead onlyRead the status of one tenant- and principal-scoped outreach discovery session. This never mutates a provider.
discovery_session_idworkspace_idsession_idprincipal_context_ref_idgateway_run_idproviderprovider_account_idcapability_receipt_refbamf.get_profileRead onlyReturn 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.
bamf.get_profile_capture_statusRead onlyRead safe Original/current profile capture status for a creator. It returns timestamps and verification state, never capture provenance, browser runs, or raw provider payloads.
creator_idbamf.get_profile_packageRead onlyRead one saved Profile Studio package. This is BAMF package data only, not a live LinkedIn profile read or application.
profile_package_idbamf.get_run_statusRead onlyLive 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.
run_idafter_sequencebamf.get_siteRead onlyRead 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.
workspace_idactionparamsbamf.get_site_artifactRead onlyRead exact persisted client project HTML artifact/version including content and provenance. Requires sites:read; params needs artifact_id and optional version_id.
workspace_idparamsbamf.get_video_analytics_summaryRead onlyRead the video analytics rollup (Reels/Shorts/TikTok views, watch-through, saves) that sync-video-analytics maintains.
creator_idplatformsbamf.get_x_analytics_summaryRead onlyGet saved X analytics totals, top posts, and latest follower/profile snapshot for a creator space.
creator_idbamf.get_x_safety_statusRead onlyReplies 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.
creator_idbamf.handoff_sessionHand 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.
directionagent_session_idexternal_session_idnamecwdmachinechannelpacketbamf.instantiate_design_referenceRead onlyReturn 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.
reference_idslugbrand_kit_project_idbrand_pack_idcreator_idbamf.invite_client_to_spaceText 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.
clientphonetextconfirmbamf.link_sessionRegister 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.
external_session_idnamecwdmachinechannelworkspace_idbamf.list_agent_brand_kitsRead onlyReturn versioned, positive-projection brand packs and brand-kit projects for server-authorized creator spaces.
creator_idlimitbamf.list_agent_mediaRead onlyReturn versioned, positive-projection media assets for server-authorized creator spaces.
creator_idlimitbamf.list_ai_analysesRead onlyList saved AI analysis reports for a creator profile and LinkedIn analytics performance.
creator_idlimitbamf.list_boost_groupsRead onlyList 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.
author_idbamf.list_boost_tiersRead onlyList available engagement boost tiers (basic/power/mega) with reach and token cost.
bamf.list_brand_kitsRead onlyList 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.
creator_idlimitbamf.list_client_approvalsRead onlyList content approval requests for the workspaces this connection can reach. Requires client_approvals:read.
creator_idworkspace_idstatuslimitbamf.list_client_channelsRead onlyList 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.
creator_idbamf.list_creator_followsRead onlyList creator profiles followed by a workspace.
workspace_idauthor_idbamf.list_creator_spacesRead onlyList 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.
detaillimitcursoroffsetbamf.list_design_referencesRead onlyList 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.
categoryqueryplatformpost_typeinclude_guidelimitbamf.list_ideasRead onlyList content ideas for a creator space.
creator_idstatussearchlimitbamf.list_integrationsRead onlyList connected creator integrations and per-author integration settings without exposing tokens, cookies, or secrets.
creator_idbamf.list_interviewsRead onlyList creator interviews from transcript knowledge documents and app-native chat interview sessions.
creator_idlimitbamf.list_jobsRead onlyList recent BAMF async jobs for a creator space.
creator_idstatusjob_typelimitbamf.list_linkedin_postsRead onlyList discovered LinkedIn-native posts for a creator with Late-authoritative official_* performance fields when available.
creator_idlimitbamf.list_mediaRead onlyList media assets for a creator space.
creator_idlimitbamf.list_media_foldersRead onlyList Media Library folders for a creator space.
creator_idbamf.list_post_requestsRead onlyList a client creator's recent post requests with their pipeline state and Notion link.
creator_idlimitbamf.list_post_versionsRead onlyList 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.
post_idbamf.list_postsRead onlyList 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.
creator_idstatuslimitbamf.list_profile_packagesRead onlyList saved Profile Studio packages for a creator. Returns safe package content and selection state, never raw capture provenance or provider credentials.
creator_idinclude_archivedlimitbamf.list_saved_people_listsRead onlyList 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.
workspace_idbamf.list_scheduled_postsRead onlyList upcoming scheduled posts with preview-ready content, media, carousel slides, and first comments.
creator_idlimitbamf.list_site_projectsRead onlyList client projects available as destinations for site HTML artifacts. Requires sites:read.
workspace_idparamsbamf.list_site_workspacesRead onlyDiscover authorized managed client workspaces for hosted site operations. Requires sites:read. Returns IDs and names only.
bamf.list_sitesRead onlyList hosted sites in an authorized managed client workspace. Requires sites:read; creator-scoped keys and unbound native workspaces are unsupported.
workspace_idbamf.list_style_optionsRead onlyReturn 4 style options (style_id, label, preview image_url, source library|yours|brand, source_label, description) for a visual format; the creator's swipe-liked looks (source_label "Your liked style") come first, then approved baselines. ALWAYS call this before the first visual of a request (infographic, carousel, image, quote card, motion, video). If the response has needs_tuning: true, the creator has fewer than 3 liked styles for the format: send them to style_swipe_url (opens in the built-in browser in Claude Code and the desktop app), wait for them to finish, then call this again. Never generate blind, and never render new designs to test taste: taste comes from real top-performer posts. Then show the 4 images as a labelled 2x2, and ask them to pick one, 'show 4 more' (page+1) or 'try another format' (other_formats). Pass the chosen style_id to the generate tool. Read-only; never returns other creators' names, avatars or original posts.
formatplatformpageauthor_idbamf.list_ui_componentsRead onlyList the BAMF UI component library so pages, artifacts, dashboards and in-chat cards you build look and behave like BAMF's own agent. Returns ui_cards components (in-chat and right-pane cards), GenUI nodes (composable panels and artifacts) and DSI page components, each with id, origin, surfaces, description, props JSON Schema, example spec and allowed actions, plus DSI design tokens and rules. Prefer these components over custom markup; check the spec with bamf.validate_ui_spec before showing or saving it. Read-only.
surfaceoriginqueryinclude_schemainclude_tokensbamf.list_x_bookmarksRead onlyList 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.
creator_idlimitstatusfolder_idfolder_namesearchsincebamf.list_x_postsRead onlyList saved X post analytics rows for a creator, including impressions, likes, replies, reposts, quotes, bookmarks, clicks, engagement rate, and post URLs when available.
creator_idlimitbamf.manage_funnel_emailsClient site funnel emails: list_sequences, preview_step, get_stats and form_wiring (sites:read); send_test to [email protected] or a qa+/qa- address only (sites:write); approve_step for exact previewed copy via copy_sha256 (sites:publish). Never emails real leads and never changes FUNNEL_EMAIL_LIVE. params: site_id?, funnel, step, name?, to, copy_sha256, note?.
workspace_idactionparamsidempotency_keybamf.manage_proxyChanges dataRaw 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.
clientactioncountryregioncityconfirmbamf.manage_siteChanges dataCreate or revise site sessions, context, templates and preview versions; save a site-scoped merch review; rename or archive a site; retry or cancel a build; or attach its analytics Pixel. Requires sites:write and an authorized managed client workspace. Archive and cancel affect existing site/build state; this tool does not publish.
workspace_idactionparamsidempotency_keybamf.message_clientRelay 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.
clientmessagelinkattributionconfirmbamf.message_team_channelPost 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.
workspace_idtextconfirmidempotency_keybamf.move_media_itemsMove selected media assets into a Media Library folder, or clear the folder with folder_id null.
item_idsfolder_idbamf.narrate_video_projectNarrate a video project with the creator's own ElevenLabs voice. Requires an authenticated BAMF user session.
video_project_idtextvoice_idbamf.open_cloud_computerRead onlyOpen 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.
urlbamf.open_style_swipeRead onlyReturn the authenticated Style Swipe deep link (bamf.ai/creators/<author_id>/style-swipe?format=...) where a creator likes or passes real top-performing posts to tune their visual taste, plus likes_by_format, rules_set (brand rules saved) and needs_tuning_formats (formats with fewer than 3 likes). Give the user the url; in Claude Code and the desktop app it opens in the built-in browser. Wait for them to finish before generating. Read-only; it never changes anything.
formatauthor_idbamf.pause_scheduled_postPause auto-publishing while keeping the scheduled time visible in BAMF.
post_idbamf.plugins.callChanges dataRun 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.
workspace_idplugintoolargsbamf.plugins.listRead onlyList 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.
workspace_idbamf.prepare_exact_thread_replyEvaluate 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.
workspace_ididempotency_keyintentbamf.prepare_outreach_campaignPrepare 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.
workspace_idsession_idprincipal_context_ref_ididempotency_keynative_saved_listbindingplanbamf.prepare_outreach_growth_deliveryPersist 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.
schema_versiontenant_idworkspace_idprincipal_context_ref_ididempotency_keyrecipienteligibilityartifactsapprovalsuppressiondeliverybamf.preview_postRead onlyReturn a rich preview for one post, including media and first comment.
post_idbamf.process_knowledgeProcess 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.
creator_iddocument_idtitlecontenttagstypemetadatabamf.propose_brain_updatePropose a change to a brain; the owner approves it in BAMF. This only queues a proposal and never edits the brain.
creator_idkindtargetsummarybodybamf.publish_notion_status_blockRefresh 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).
kindworkspace_idnotion_page_idblock_iddry_runbamf.publish_post_nowChanges dataPublish a post immediately. User-scoped keys only; creator-scoped keys receive a helpful 403.
post_idbamf.publish_siteChanges dataRequest 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.
workspace_idactionparamsidempotency_keybamf.publish_x_replyChanges dataPublish one reply on X now from the creator's connected X account, replying to in_reply_to (an X post id or status URL). Show the user the exact text and get their approval first. The server enforces safety caps (30 replies/day, 6/hour, 4 min spacing, 2 per author/day, <=10% links, no near-duplicates over 7 days) and writes an audit entry. Returns the published post id and URL. Pass original_text when the user edited a draft so BAMF learns from the edit.
creator_idin_reply_totexttarget_author_handleoriginal_textbamf.query_peopleRead onlyRead 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.
workspace_idparamsbamf.queue_outreach_campaignQueue an approved exact campaign after its list, connector, fingerprint, and approval remain current. This state transition does not send.
campaign_idworkspace_idsession_idprincipal_context_ref_ididempotency_keybamf.read_saved_people_listRead onlyRead 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.
workspace_idlist_idmember_kindlimitoffsetbamf.read_team_channelRead onlyRead 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.
workspace_idlimitbamf.reconnect_linkedinStart 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.
clientconfirmbamf.request_loginRead onlyAsk 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.
sitebamf.resume_outreach_discoveryResume a scoped outreach discovery session from server-owned coverage. Caller-supplied provider cursors or organization IDs are not accepted as authority.
discovery_session_idworkspace_idsession_idprincipal_context_ref_idgateway_run_idproviderprovider_account_idcapability_receipt_refsource_modetargetingidempotency_keybamf.resume_scheduled_postResume a paused scheduled post using its stored scheduled time.
post_idbamf.revert_post_versionRestore a saved version on the same post: kind=text (version_id), image (index into image_history), slide_image (slide + image_url; prompt carousels step back one version), or slide_text (slide + version_id). The current state is kept as a version, so a revert is itself reversible. Never creates a post.
post_idkindversion_idindexslideimage_urlbamf.route_agent_workflowRead onlyDeterministically route a natural-language BAMF request to the recommended app workflow, BAMF Stack skill, REST endpoints, MCP tools, scopes, and approval policy.
requestintentworkflow_idvisual_typepost_idcurrent_post_idhas_post_idwants_to_mutatecontextbamf.run_ai_roundupRun the AI roundup series for a creator: ingest curated source pages (source_posts), extract news stories, verify each against a primary source (official blog, GitHub repo, announcement), dedupe against past roundups, rank, and save drafts: an X thread, a branded LinkedIn document carousel, a companion video draft, and on weekly runs a deep-dive/hot-take post. Unverified stories are dropped. Drafts only; nothing is scheduled or published.
creator_idworkspace_idcadenceserieseval_rundry_runtarget_post_idnew_postbamf.run_design_sessionRead onlyMake 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.
kindbriefpost_idworkerbamf.run_researchRun 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.
creator_idquerytopicsource_urlsnotesdesired_outputsuse_web_researchuse_perplexitybamf.save_agent_artifactSave 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.
creator_idtitlecontentpathtagssource_providersource_session_urlsource_session_idsource_artifact_typecreated_by_agentbamf.save_outreach_discoveryExplicitly 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.
discovery_session_idworkspace_idsession_idprincipal_context_ref_idgateway_run_idproviderprovider_account_idcapability_receipt_refidempotency_keybamf.save_site_artifactPersist 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.
workspace_idparamsidempotency_keybamf.schedule_postChanges dataSchedule 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.
post_idscheduled_forboostbamf.schedule_video_postChanges dataSchedule 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.
video_project_idcontenttitleplatformsvideo_urlthumbnail_urlscheduled_forpublish_nowtimezoneapprovedidempotency_keybamf.search_crm_leadsRead onlySearch 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.
workspace_idparamsbamf.search_intelligenceRead onlySearch the authenticated creator's indexed media, bookmarks, and documents. Returns source-linked evidence and citations; only reads existing intelligence projections.
author_idquerylimitbamf.search_knowledgeRead onlySearch creator knowledge documents.
creator_idsearchlimitbamf.select_profile_packageMark a saved Profile Studio package selected after exact approval. Selection is reversible BAMF metadata, not live LinkedIn application or publishing.
profile_package_idbamf.send_linkedin_reauth_linkSend 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.
clientchannelsconfirmbamf.share_to_channelPost 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.
creator_idchannel_idtextlinkdry_runidempotency_keybamf.start_outreach_discoveryStart a tenant- and principal-scoped, provider-read-only outreach discovery session. This discovers candidates only; it never creates or sends a campaign.
workspace_idsession_idprincipal_context_ref_idgateway_run_idproviderprovider_account_idcapability_receipt_refsource_modetargetingsearch_criteriaapollo_enrichment_approvalapollo_preview_session_ididempotency_keybamf.suggest_ad_keywordsRead onlyRelated 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.
keywordcountrycreator_idbamf.sync_x_analyticsStart 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.
creator_idnative_pagesnative_limitbamf.transcribe_video_captionsProduce or persist word-level burned-in captions for a video project via Whisper. Requires an authenticated BAMF user session when transcribing.
video_project_idcaptionsbamf.unfollow_creatorChanges dataUnfollow a creator profile in a workspace.
workspace_idauthor_idcreator_profile_ididempotency_keybamf.unschedule_postChanges dataUnschedule a post. Creator-scoped API keys may use this.
post_idbamf.update_brand_kit_referencesChanges dataAttach 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.
creator_idbrand_pack_idpack_typemodeasset_rolereference_urlsinline_reference_data_urlsnamedescriptiontagspalettefontsvisual_style_promptbrand_rulesnegative_promptnotestrigger_keywordsreference_namereference_notesis_default_referencebamf.update_client_contactUpdate 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.
clientphoneemailcompanyconfirmbamf.update_profile_packageChanges dataUpdate 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.
profile_package_ididempotency_keytitlenotesthumbnail_urlis_archivedsnapshotbamf.validate_ui_specRead onlyValidate a ui_cards payload (version bamf.ui_cards.v1) or a GenUI spec (v 1) with the exact rules BAMF's renderer uses. Returns format, valid, normalized (what BAMF will render, with invalid cards or nodes dropped) and errors with a path and message. Read-only and side-effect free: nothing is stored. To keep a validated spec, save the normalized JSON with bamf.save_agent_artifact after the user approves.
specformat
Is this yours?
Claim it to hear the moment it breaks, correct this page and add your own ways to use it.
A test is the handshake and the tool list: no tool was called. Names and descriptions are as listed by whoever registered the server; we haven't checked them.