BAMF.ai is an MCP server published by ai.bamf, hosted at mcp.bamf.ai. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 180 tools, including bamf.list_site_projects, bamf.create_site_project, bamf.get_site_artifact, bamf.save_site_artifact, bamf.list_sites.
LinkedIn and X content, scheduling, analytics and outreach agent for founders, via your BAMF login.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
List client projects available as destinations for site HTML artifacts. Requires sites:read.
| Parameter | Type | Description |
|---|---|---|
| params | object | |
| workspace_id * | string |
{
"name": "bamf.list_site_projects",
"description": "List client projects available as destinations for site HTML artifacts. Requires sites:read.",
"inputSchema": {
"type": "object",
"required": [
"workspace_id"
],
"properties": {
"params": {
"type": "object"
},
"workspace_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "list_site_projects",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Create a client project destination for site artifacts. Requires sites:write; supply title and agent_lanes in params.
| Parameter | Type | Description |
|---|---|---|
| params * | object | |
| workspace_id * | string | |
| idempotency_key * | string |
{
"name": "bamf.create_site_project",
"description": "Create a client project destination for site artifacts. Requires sites:write; supply title and agent_lanes in params.",
"inputSchema": {
"type": "object",
"required": [
"workspace_id",
"params",
"idempotency_key"
],
"properties": {
"params": {
"type": "object"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"idempotency_key": {
"type": "string",
"maxLength": 200,
"minLength": 8
}
},
"additionalProperties": false
},
"annotations": {
"title": "create_site_project",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Read exact persisted client project HTML artifact/version including content and provenance. Requires sites:read; params needs artifact_id and optional version_id.
| Parameter | Type | Description |
|---|---|---|
| params * | object | |
| workspace_id * | string |
{
"name": "bamf.get_site_artifact",
"description": "Read exact persisted client project HTML artifact/version including content and provenance. Requires sites:read; params needs artifact_id and optional version_id.",
"inputSchema": {
"type": "object",
"required": [
"workspace_id",
"params"
],
"properties": {
"params": {
"type": "object"
},
"workspace_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "get_site_artifact",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| params * | object | |
| workspace_id * | string | |
| idempotency_key * | string |
{
"name": "bamf.save_site_artifact",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"workspace_id",
"params",
"idempotency_key"
],
"properties": {
"params": {
"type": "object"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"idempotency_key": {
"type": "string",
"maxLength": 200,
"minLength": 8
}
},
"additionalProperties": false
},
"annotations": {
"title": "save_site_artifact",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List hosted sites in an authorized managed client workspace. Requires sites:read; creator-scoped keys and unbound native workspaces are unsupported.
| Parameter | Type | Description |
|---|---|---|
| workspace_id * | string |
{
"name": "bamf.list_sites",
"description": "List hosted sites in an authorized managed client workspace. Requires sites:read; creator-scoped keys and unbound native workspaces are unsupported.",
"inputSchema": {
"type": "object",
"required": [
"workspace_id"
],
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "List Sites",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Discover authorized managed client workspaces for hosted site operations. Requires sites:read. Returns IDs and names only.
No parameters.
{
"name": "bamf.list_site_workspaces",
"description": "Discover authorized managed client workspaces for hosted site operations. Requires sites:read. Returns IDs and names only.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "List Site Workspaces",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| action * | string | one of ["get_site_builds","get_site_analytics","get_builder_session","recover_builder_revision","get_site_preview","get_site_domain_instructions","get_builder_version_diff","get_builder_version_source","get_… |
| params * | object | |
| workspace_id * | string |
{
"name": "bamf.get_site",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"workspace_id",
"action",
"params"
],
"properties": {
"action": {
"enum": [
"get_site_builds",
"get_site_analytics",
"get_builder_session",
"recover_builder_revision",
"get_site_preview",
"get_site_domain_instructions",
"get_builder_version_diff",
"get_builder_version_source",
"get_site_access",
"get_site_tool_capabilities",
"get_site_merch_reviews",
"get_site_printful_templates",
"get_site_connection_history"
],
"type": "string"
},
"params": {
"type": "object",
"properties": {
"site_id": {
"type": "string",
"format": "uuid"
},
"before_version": {
"type": "integer",
"minimum": 1
}
},
"additionalProperties": true
},
"workspace_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "get_site",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Create 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.
| Parameter | Type | Description |
|---|---|---|
| action * | string | one of ["create_builder_session","start_builder_revision","save_site_project_context","verify_client_site","duplicate_builder_version","create_visual_artifact_site_version","attach_code_site_files","pause_bu… |
| params * | object | |
| workspace_id * | string | |
| idempotency_key * | string |
{
"name": "bamf.manage_site",
"description": "Create 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.",
"inputSchema": {
"type": "object",
"required": [
"workspace_id",
"action",
"params",
"idempotency_key"
],
"properties": {
"action": {
"enum": [
"create_builder_session",
"start_builder_revision",
"save_site_project_context",
"verify_client_site",
"duplicate_builder_version",
"create_visual_artifact_site_version",
"attach_code_site_files",
"pause_builder_session",
"resume_builder_session",
"rename_builder_site",
"update_site_slug",
"create_site_from_template",
"attach_site_domain",
"check_site_domain",
"retry_site_build",
"cancel_site_build",
"set_site_archived",
"attach_site_pixel",
"save_site_merch_review"
],
"type": "string"
},
"params": {
"type": "object"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"idempotency_key": {
"type": "string",
"maxLength": 240,
"minLength": 8
}
},
"additionalProperties": false
},
"annotations": {
"title": "manage_site",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| action * | string | one of ["request_builder_publish_approval","resolve_builder_publish_approval","update_site_access","execute_builder_site_operation"] |
| params * | object | |
| workspace_id * | string | |
| idempotency_key * | string |
{
"name": "bamf.publish_site",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"workspace_id",
"action",
"params",
"idempotency_key"
],
"properties": {
"action": {
"enum": [
"request_builder_publish_approval",
"resolve_builder_publish_approval",
"update_site_access",
"execute_builder_site_operation"
],
"type": "string"
},
"params": {
"type": "object"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"idempotency_key": {
"type": "string",
"maxLength": 240,
"minLength": 8
}
},
"additionalProperties": false
},
"annotations": {
"title": "publish_site",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Client site funnel emails: list_sequences, preview_step, get_stats and form_wiring (sites:read); send_test to houston@bamf.ai 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?.
| Parameter | Type | Description |
|---|---|---|
| action * | string | one of ["list_sequences","preview_step","get_stats","form_wiring","send_test","approve_step"] |
| params | object | |
| workspace_id * | string | |
| idempotency_key | string |
{
"name": "bamf.manage_funnel_emails",
"description": "Client site funnel emails: list_sequences, preview_step, get_stats and form_wiring (sites:read); send_test to houston@bamf.ai 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?.",
"inputSchema": {
"type": "object",
"required": [
"workspace_id",
"action"
],
"properties": {
"action": {
"enum": [
"list_sequences",
"preview_step",
"get_stats",
"form_wiring",
"send_test",
"approve_step"
],
"type": "string"
},
"params": {
"type": "object",
"properties": {
"to": {
"type": "string"
},
"name": {
"type": "string"
},
"note": {
"type": "string"
},
"step": {
"type": "integer",
"minimum": 0
},
"funnel": {
"type": "string"
},
"site_id": {
"type": "string",
"format": "uuid"
},
"copy_sha256": {
"type": "string"
}
},
"additionalProperties": false
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"idempotency_key": {
"type": "string",
"maxLength": 240,
"minLength": 8
}
},
"additionalProperties": false
},
"annotations": {
"title": "manage_funnel_emails",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
No parameters.
{
"name": "bamf.get_agent_capabilities",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "Get Agent Capabilities",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Search the authenticated creator's indexed media, bookmarks, and documents. Returns source-linked evidence and citations; only reads existing intelligence projections.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| query * | string | |
| author_id * | string |
{
"name": "bamf.search_intelligence",
"description": "Search the authenticated creator's indexed media, bookmarks, and documents. Returns source-linked evidence and citations; only reads existing intelligence projections.",
"inputSchema": {
"type": "object",
"required": [
"author_id",
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 8,
"maximum": 8,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 400,
"minLength": 1
},
"author_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search Intelligence",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Get source-linked evidence, facts, and relationships for one intelligence resource the authenticated creator can access.
| Parameter | Type | Description |
|---|---|---|
| resource_id * | string |
{
"name": "bamf.get_intelligence_resource_context",
"description": "Get source-linked evidence, facts, and relationships for one intelligence resource the authenticated creator can access.",
"inputSchema": {
"type": "object",
"required": [
"resource_id"
],
"properties": {
"resource_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Intelligence Resource Context",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read recent intelligence processing jobs for the authenticated creator, optionally limited to one resource.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| resource_id | string |
{
"name": "bamf.get_intelligence_processing_status",
"description": "Read recent intelligence processing jobs for the authenticated creator, optionally limited to one resource.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1
},
"resource_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Intelligence Processing Status",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Deterministically route a natural-language BAMF request to the recommended app workflow, BAMF Stack skill, REST endpoints, MCP tools, scopes, and approval policy.
| Parameter | Type | Description |
|---|---|---|
| intent | string | Optional app or agent-detected intent. |
| context | ["string","object"] | Optional structured routing context. |
| post_id | string | |
| request | string | The user's natural-language BAMF workflow request. |
| has_post_id | boolean | |
| visual_type | string | Optional visual type hint such as image_quote, carousel, infographic, or freeimage. |
| workflow_id | string | Optional explicit workflow hint such as draft, edit, media, schedule, analytics, or context. |
| current_post_id | string | |
| wants_to_mutate | boolean |
{
"name": "bamf.route_agent_workflow",
"description": "Deterministically route a natural-language BAMF request to the recommended app workflow, BAMF Stack skill, REST endpoints, MCP tools, scopes, and approval policy.",
"inputSchema": {
"type": "object",
"properties": {
"intent": {
"type": "string",
"description": "Optional app or agent-detected intent."
},
"context": {
"type": [
"string",
"object"
],
"description": "Optional structured routing context."
},
"post_id": {
"type": "string"
},
"request": {
"type": "string",
"description": "The user's natural-language BAMF workflow request."
},
"has_post_id": {
"type": "boolean"
},
"visual_type": {
"type": "string",
"description": "Optional visual type hint such as image_quote, carousel, infographic, or freeimage."
},
"workflow_id": {
"type": "string",
"description": "Optional explicit workflow hint such as draft, edit, media, schedule, analytics, or context."
},
"current_post_id": {
"type": "string"
},
"wants_to_mutate": {
"type": "boolean"
}
}
},
"annotations": {
"title": "Route Agent Workflow",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Return the authenticated BAMF actor identity through the canonical server-resolved authority path.
No parameters.
{
"name": "bamf.get_agent_identity",
"description": "Return the authenticated BAMF actor identity through the canonical server-resolved authority path.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Get Agent Identity",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| creator_id | string | Creator space to onboard. Defaults to the person's own. |
{
"name": "bamf.get_onboarding",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"creator_id": {
"type": "string",
"description": "Creator space to onboard. Defaults to the person's own."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Onboarding",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| step * | string | Step id from bamf.get_onboarding (for example sources, first-posts, engagement). |
| answer | object | What the person said for this step (small JSON object, 8 KB max). |
| outcome | string | one of ["completed","skipped"] |
| profile | object | |
| creator_id | string | Creator space being onboarded. Defaults to the person's own. |
{
"name": "bamf.advance_onboarding",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"step"
],
"properties": {
"step": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Step id from bamf.get_onboarding (for example sources, first-posts, engagement)."
},
"answer": {
"type": "object",
"description": "What the person said for this step (small JSON object, 8 KB max)."
},
"outcome": {
"enum": [
"completed",
"skipped"
],
"type": "string",
"default": "completed"
},
"profile": {
"type": "object",
"properties": {
"bio": {
"type": "string"
},
"name": {
"type": "string"
},
"industry": {
"type": "string"
},
"website_url": {
"type": "string"
},
"job_description": {
"type": "string"
},
"linkedin_profile_url": {
"type": "string"
}
},
"additionalProperties": false
},
"creator_id": {
"type": "string",
"description": "Creator space being onboarded. Defaults to the person's own."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Advance Onboarding",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}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.
No parameters.
{
"name": "bamf.get_profile",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "\\S",
"minLength": 1,
"description": "Opaque profile identifier, unique within this app and unchanged across token refresh, reconnection, and display-metadata changes. Never reassigned to another profile."
},
"name": {
"type": "string",
"description": "Display name for the authenticated profile."
},
"email": {
"type": "string",
"description": "Email address for display; not used as the profile identity."
},
"nickname": {
"type": "string",
"description": "A useful label that helps users distinguish connected profiles."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Profile",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Return a versioned, positive-projection creator context for the server-authorized creator space.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| sections | array | |
| creator_id * | string |
{
"name": "bamf.get_agent_creator_context",
"description": "Return a versioned, positive-projection creator context for the server-authorized creator space.",
"inputSchema": {
"type": "object",
"required": [
"creator_id"
],
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 100,
"minimum": 1
},
"sections": {
"type": "array",
"items": {
"enum": [
"profile",
"context",
"voice_profile",
"linkedin_profile",
"website",
"brand_kits",
"media"
],
"type": "string"
},
"minItems": 1,
"uniqueItems": true
},
"creator_id": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Agent Creator Context",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Return versioned, positive-projection media assets for server-authorized creator spaces.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| creator_id | string |
{
"name": "bamf.list_agent_media",
"description": "Return versioned, positive-projection media assets for server-authorized creator spaces.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"creator_id": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
},
"annotations": {
"title": "List Agent Media",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Return versioned, positive-projection brand packs and brand-kit projects for server-authorized creator spaces.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| creator_id | string |
{
"name": "bamf.list_agent_brand_kits",
"description": "Return versioned, positive-projection brand packs and brand-kit projects for server-authorized creator spaces.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"creator_id": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
},
"annotations": {
"title": "List Agent Brand Kits",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List creator profiles followed by a workspace.
| Parameter | Type | Description |
|---|---|---|
| author_id * | string | |
| workspace_id * | string |
{
"name": "bamf.list_creator_follows",
"description": "List creator profiles followed by a workspace.",
"inputSchema": {
"type": "object",
"required": [
"workspace_id",
"author_id"
],
"properties": {
"author_id": {
"type": "string",
"format": "uuid"
},
"workspace_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "List Creator Follows",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Follow a creator profile in a workspace.
| Parameter | Type | Description |
|---|---|---|
| profile * | string | |
| platform | string | one of ["linkedin","x","instagram"] |
| author_id * | string | |
| workspace_id * | string | |
| idempotency_key * | string |
{
"name": "bamf.follow_creator",
"description": "Follow a creator profile in a workspace.",
"inputSchema": {
"type": "object",
"required": [
"workspace_id",
"author_id",
"profile",
"idempotency_key"
],
"properties": {
"profile": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"platform": {
"enum": [
"linkedin",
"x",
"instagram"
],
"type": "string"
},
"author_id": {
"type": "string",
"format": "uuid"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"idempotency_key": {
"type": "string",
"maxLength": 240,
"minLength": 8
}
},
"additionalProperties": false
},
"annotations": {
"title": "Follow Creator",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Unfollow a creator profile in a workspace.
| Parameter | Type | Description |
|---|---|---|
| author_id * | string | |
| workspace_id * | string | |
| idempotency_key * | string | |
| creator_profile_id * | string |
{
"name": "bamf.unfollow_creator",
"description": "Unfollow a creator profile in a workspace.",
"inputSchema": {
"type": "object",
"required": [
"workspace_id",
"author_id",
"creator_profile_id",
"idempotency_key"
],
"properties": {
"author_id": {
"type": "string",
"format": "uuid"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"idempotency_key": {
"type": "string",
"maxLength": 240,
"minLength": 8
},
"creator_profile_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Unfollow Creator",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| cursor | string | Opaque next_cursor from the previous page. |
| detail | string | one of ["summary","full"] |
| offset | integer | Legacy pagination input. Prefer cursor for new callers. |
{
"name": "bamf.list_creator_spaces",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Opaque next_cursor from the previous page."
},
"detail": {
"enum": [
"summary",
"full"
],
"type": "string",
"default": "summary"
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 100000,
"minimum": 0,
"description": "Legacy pagination input. Prefer cursor for new callers."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List Creator Spaces",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| sections | array | Optional subset. Omit to load all sections the key can read. |
| creator_id * | string |
{
"name": "bamf.get_creator_context",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id"
],
"properties": {
"limit": {
"type": "number",
"default": 25
},
"sections": {
"type": "array",
"items": {
"enum": [
"profile",
"context",
"voice_profile",
"ai_analysis",
"knowledge_docs",
"interviews",
"integrations",
"linkedin_profile",
"linkedin_posts",
"linkedin_analytics",
"x_profile",
"x_posts",
"x_analytics",
"website",
"website_screenshot",
"brand_kits",
"media"
],
"type": "string"
},
"description": "Optional subset. Omit to load all sections the key can read."
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Get Creator Context",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List upcoming scheduled posts with preview-ready content, media, carousel slides, and first comments.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| creator_id | string |
{
"name": "bamf.list_scheduled_posts",
"description": "List upcoming scheduled posts with preview-ready content, media, carousel slides, and first comments.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 20
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "List Scheduled Posts",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| status | string | one of ["draft","idea","in_review","approved","scheduled","published","failed","archived"] |
| creator_id | string |
{
"name": "bamf.list_posts",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 20
},
"status": {
"enum": [
"draft",
"idea",
"in_review",
"approved",
"scheduled",
"published",
"failed",
"archived"
],
"type": "string",
"default": "draft"
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "List Posts",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string |
{
"name": "bamf.finish_draft",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Finish Draft",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Return a rich preview for one post, including media and first comment.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string |
{
"name": "bamf.preview_post",
"description": "Return a rich preview for one post, including media and first comment.",
"inputSchema": {
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Preview Post",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| topic | string | |
| content * | string | |
| sources | array | Optional provenance for the draft: where this post idea came from (a research artifact, the agent session that produced it, or a URL). Shown in post review. |
| platform | string | Case-insensitive; aliases li, x/twitter, ig accepted. Stored as LinkedIn, Twitter, Instagram, Threads, TikTok, YouTube or Facebook. |
| post_type | string | one of ["text","image","carousel","video","article"] |
| video_url | string | |
| creator_id * | string | |
| article_url | string | |
| funnel_plan | object | Optional funnel intent from a funnel plan (bamf.get_funnel_mix). Stored as generation_metadata.funnel_plan. |
| document_url | string | LinkedIn carousel/document PDF URL. |
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.
| Parameter | Type | Description |
|---|---|---|
| link | string | Optional https URL appended to the message. |
| client * | string | Client workspace id, slug, or client name (must be a client of an agency you own, admin, or manage). |
| confirm | boolean | false returns the plan only; true sends. |
| message * | string | Write as the client should read it: second person, plain, no greeting. |
| attribution | string | agent = BAMF Bot's voice; from_me = signed with the sender's name and role. |
{
"name": "bamf.message_client",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"client",
"message"
],
"properties": {
"link": {
"type": "string",
"description": "Optional https URL appended to the message."
},
"client": {
"type": "string",
"description": "Client workspace id, slug, or client name (must be a client of an agency you own, admin, or manage)."
},
"confirm": {
"type": "boolean",
"default": false,
"description": "false returns the plan only; true sends."
},
"message": {
"type": "string",
"maxLength": 3000,
"description": "Write as the client should read it: second person, plain, no greeting."
},
"attribution": {
"enum": [
"agent",
"from_me"
],
"type": "string",
"default": "agent",
"description": "agent = BAMF Bot's voice; from_me = signed with the sender's name and role."
}
}
},
"annotations": {
"title": "Message Client",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| text | string | The approved SMS text; keep {invite_link} where the link goes. |
| phone | string | Client mobile, only when the plan says needs_phone. |
| client * | string | Client workspace id, slug, or client name (must be a client of an agency you own, admin, or manage). |
| confirm | boolean | false returns the plan only; true creates the invite and texts it. |
{
"name": "bamf.invite_client_to_space",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"client"
],
"properties": {
"text": {
"type": "string",
"maxLength": 1200,
"description": "The approved SMS text; keep {invite_link} where the link goes."
},
"phone": {
"type": "string",
"description": "Client mobile, only when the plan says needs_phone."
},
"client": {
"type": "string",
"description": "Client workspace id, slug, or client name (must be a client of an agency you own, admin, or manage)."
},
"confirm": {
"type": "boolean",
"default": false,
"description": "false returns the plan only; true creates the invite and texts it."
}
}
},
"annotations": {
"title": "Invite Client to Space",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| string | Client email. | |
| phone | string | Client phone, any format (US numbers default to +1). |
| client * | string | Client workspace id, slug, or client name (must be a client of an agency you own, admin, or manage). |
| company | string | Client company name. |
| confirm | boolean | false returns the plan only; true writes BAMF, Notion and GoHighLevel. |
{
"name": "bamf.update_client_contact",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"client"
],
"properties": {
"email": {
"type": "string",
"description": "Client email."
},
"phone": {
"type": "string",
"description": "Client phone, any format (US numbers default to +1)."
},
"client": {
"type": "string",
"description": "Client workspace id, slug, or client name (must be a client of an agency you own, admin, or manage)."
},
"company": {
"type": "string",
"description": "Client company name."
},
"confirm": {
"type": "boolean",
"default": false,
"description": "false returns the plan only; true writes BAMF, Notion and GoHighLevel."
}
}
},
"annotations": {
"title": "Update Client Contact",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| client * | string | Client workspace id, slug, or client name (must be a client of an agency you own, admin, or manage). |
| confirm | boolean | false returns the plan only; true sends. |
| channels | array | Optional delivery channels, each attempted. Omit to use the user's saved preference (default Slack + SMS + email). WhatsApp is gated behind the RECONNECT_WHATSAPP_ENABLED flag and provider credentials. |
{
"name": "bamf.send_linkedin_reauth_link",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"client"
],
"properties": {
"client": {
"type": "string",
"description": "Client workspace id, slug, or client name (must be a client of an agency you own, admin, or manage)."
},
"confirm": {
"type": "boolean",
"default": false,
"description": "false returns the plan only; true sends."
},
"channels": {
"type": "array",
"items": {
"enum": [
"slack",
"email",
"sms",
"whatsapp"
],
"type": "string"
},
"description": "Optional delivery channels, each attempted. Omit to use the user's saved preference (default Slack + SMS + email). WhatsApp is gated behind the RECONNECT_WHATSAPP_ENABLED flag and provider credentials."
}
}
},
"annotations": {
"title": "Send LinkedIn Re-auth Link",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Check a client's LinkedIn login status in BAMF Connect and Multilogin. Agency staff keys only. Read-only.
| Parameter | Type | Description |
|---|---|---|
| client * | string | Client workspace id, slug, or client name (must be a client of an agency you own, admin, or manage). |
{
"name": "bamf.check_linkedin_session",
"description": "Check a client's LinkedIn login status in BAMF Connect and Multilogin. Agency staff keys only. Read-only.",
"inputSchema": {
"type": "object",
"required": [
"client"
],
"properties": {
"client": {
"type": "string",
"description": "Client workspace id, slug, or client name (must be a client of an agency you own, admin, or manage)."
}
}
},
"annotations": {
"title": "Check LinkedIn Session",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| client * | string | Client workspace id, slug, or client name (a client of an agency you own or admin). |
{
"name": "bamf.get_client_access",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"client"
],
"properties": {
"client": {
"type": "string",
"description": "Client workspace id, slug, or client name (a client of an agency you own or admin)."
}
}
},
"annotations": {
"title": "Get Client Access",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Create a one-time client access link (7 days) plus a short ready-to-paste message for SMS, WhatsApp, email or Slack. The client opens it to consent and save their LinkedIn login and authenticator key to BAMF Vault. BAMF never sends it: give the message to the agency owner to send. Replaces any unused earlier link. Agency owner/admin only; API keys need the client_access:link scope.
| Parameter | Type | Description |
|---|---|---|
| client * | string | Client workspace id, slug, or client name. |
{
"name": "bamf.create_client_access_link",
"description": "Create a one-time client access link (7 days) plus a short ready-to-paste message for SMS, WhatsApp, email or Slack. The client opens it to consent and save their LinkedIn login and authenticator key to BAMF Vault. BAMF never sends it: give the message to the agency owner to send. Replaces any unused earlier link. Agency owner/admin only; API keys need the client_access:link scope.",
"inputSchema": {
"type": "object",
"required": [
"client"
],
"properties": {
"client": {
"type": "string",
"description": "Client workspace id, slug, or client name."
}
}
},
"annotations": {
"title": "Create Client Access Link",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| client * | string | Client workspace id, slug, or client name. |
| reason * | string | Why the code is needed, e.g. 'LinkedIn sign-in on BAMF Cloud for the client's Multilogin profile'. |
{
"name": "bamf.get_client_totp_code",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"client",
"reason"
],
"properties": {
"client": {
"type": "string",
"description": "Client workspace id, slug, or client name."
},
"reason": {
"type": "string",
"description": "Why the code is needed, e.g. 'LinkedIn sign-in on BAMF Cloud for the client's Multilogin profile'."
}
}
},
"annotations": {
"title": "Get Client Sign-in Code",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| client | string | Client workspace id, slug, or client name. Optional when you belong to exactly one client space. |
| confirm | boolean | false returns the plan only; true opens the cloud reconnect session. |
{
"name": "bamf.reconnect_linkedin",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"client": {
"type": "string",
"description": "Client workspace id, slug, or client name. Optional when you belong to exactly one client space."
},
"confirm": {
"type": "boolean",
"default": false,
"description": "false returns the plan only; true opens the cloud reconnect session."
}
}
},
"annotations": {
"title": "Reconnect LinkedIn",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| url * | string | The https page to open. |
{
"name": "bamf.open_cloud_computer",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "The https page to open."
}
}
},
"annotations": {
"title": "Open Cloud Computer",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| site * | string | Site or sign-in link, e.g. amazon.com or https://connect.bamf.com/login. |
{
"name": "bamf.request_login",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"site"
],
"properties": {
"site": {
"type": "string",
"description": "Site or sign-in link, e.g. amazon.com or https://connect.bamf.com/login."
}
}
},
"annotations": {
"title": "Request Login",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| kind * | string | infographic (PNG) or motion (15s MP4). |
| brief | string | What to make; optional extra direction. |
| worker | string | Default claude. |
| post_id | string | Source post id (optional; defaults to the post open in chat). |
{
"name": "bamf.run_design_session",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"infographic",
"motion"
],
"type": "string",
"description": "infographic (PNG) or motion (15s MP4)."
},
"brief": {
"type": "string",
"description": "What to make; optional extra direction."
},
"worker": {
"enum": [
"claude",
"codex"
],
"type": "string",
"description": "Default claude."
},
"post_id": {
"type": "string",
"description": "Source post id (optional; defaults to the post open in chat)."
}
}
},
"annotations": {
"title": "Run Design Session",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| cwd | string | Working directory, used in the resume command. |
| name | string | Short session title. |
| channel | string | Client surface. Detected from the client when omitted. |
| machine | string | Machine label, e.g. mini or pro. |
| workspace_id | string | Optional workspace UUID; defaults to the key's pin, else the user's most recent chat workspace. |
| external_session_id * | string | The client's own session id (Claude Code: the session UUID). |
{
"name": "bamf.link_session",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"external_session_id"
],
"properties": {
"cwd": {
"type": "string",
"description": "Working directory, used in the resume command."
},
"name": {
"type": "string",
"description": "Short session title."
},
"channel": {
"enum": [
"claude_code",
"claude_desktop",
"claude_ai",
"chatgpt",
"other"
],
"type": "string",
"description": "Client surface. Detected from the client when omitted."
},
"machine": {
"type": "string",
"description": "Machine label, e.g. mini or pro."
},
"workspace_id": {
"type": "string",
"description": "Optional workspace UUID; defaults to the key's pin, else the user's most recent chat workspace."
},
"external_session_id": {
"type": "string",
"description": "The client's own session id (Claude Code: the session UUID)."
}
}
},
"annotations": {
"title": "Link Session to bamf.ai",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| cwd | string | |
| name | string | |
| packet | object | |
| channel | string | one of ["claude_code","claude_desktop","claude_ai","chatgpt","other"] |
| machine | string | |
| direction * | string | one of ["to_bamf","from_bamf"] |
| agent_session_id | string | bamf.ai chat id (required for from_bamf). |
| external_session_id | string | This client's session id (to_bamf without agent_session_id). |
{
"name": "bamf.handoff_session",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"direction"
],
"properties": {
"cwd": {
"type": "string"
},
"name": {
"type": "string"
},
"packet": {
"type": "object",
"properties": {
"goal": {
"type": "string"
},
"notes": {
"type": "string"
},
"decisions": {
"type": "array",
"items": {
"type": "string"
}
},
"open_steps": {
"type": "array",
"items": {
"type": "string"
}
},
"recent_turns": {
"type": "array",
"items": {
"type": "object",
"properties": {
"role": {
"enum": [
"user",
"assistant"
],
"type": "string"
},
"text": {
"type": "string"
}
}
}
}
}
},
"channel": {
"enum": [
"claude_code",
"claude_desktop",
"claude_ai",
"chatgpt",
"other"
],
"type": "string"
},
"machine": {
"type": "string"
},
"direction": {
"enum": [
"to_bamf",
"from_bamf"
],
"type": "string"
},
"agent_session_id": {
"type": "string",
"description": "bamf.ai chat id (required for from_bamf)."
},
"external_session_id": {
"type": "string",
"description": "This client's session id (to_bamf without agent_session_id)."
}
}
},
"annotations": {
"title": "Hand Off Session",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| workspace_id | string | Workspace UUID (optional; defaults to the key's pinned workspace). |
{
"name": "bamf.plugins.list",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"description": "Workspace UUID (optional; defaults to the key's pinned workspace)."
}
}
},
"annotations": {
"title": "List Connected Plugins",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| args | object | Tool arguments (see the tool's args hint in bamf.plugins.list). |
| tool * | string | Tool name from bamf.plugins.list, e.g. github.read_repo, gmail.search, calendar.upcoming, fireflies_get_transcripts, or tools/list. |
| plugin * | string | Plugin id from bamf.plugins.list: github, gmail, google_calendar, or an MCP provider key such as fireflies. |
| workspace_id | string | Workspace UUID (optional; defaults to the key's pinned workspace). |
{
"name": "bamf.plugins.call",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"plugin",
"tool"
],
"properties": {
"args": {
"type": "object",
"description": "Tool arguments (see the tool's args hint in bamf.plugins.list)."
},
"tool": {
"type": "string",
"description": "Tool name from bamf.plugins.list, e.g. github.read_repo, gmail.search, calendar.upcoming, fireflies_get_transcripts, or tools/list."
},
"plugin": {
"type": "string",
"description": "Plugin id from bamf.plugins.list: github, gmail, google_calendar, or an MCP provider key such as fireflies."
},
"workspace_id": {
"type": "string",
"description": "Workspace UUID (optional; defaults to the key's pinned workspace)."
}
}
},
"annotations": {
"title": "Call Connected Plugin",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| city | string | Optional city. |
| client * | string | Client workspace id, slug, or client name. |
| region | string | Optional region/state. |
| confirm | boolean | false returns the plan only; true applies it. |
| country | string | Optional two-letter ISO country code for the initial proxy location. |
{
"name": "bamf.ensure_proxy",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"client"
],
"properties": {
"city": {
"type": "string",
"description": "Optional city."
},
"client": {
"type": "string",
"description": "Client workspace id, slug, or client name."
},
"region": {
"type": "string",
"description": "Optional region/state."
},
"confirm": {
"type": "boolean",
"default": false,
"description": "false returns the plan only; true applies it."
},
"country": {
"type": "string",
"description": "Optional two-letter ISO country code for the initial proxy location."
}
}
},
"annotations": {
"title": "Ensure Cloud Proxy",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| city | string | Optional city for relocate. |
| action * | string | one of ["rotate","relocate","disable"] |
| client * | string | Client workspace id, slug, or client name. |
| region | string | Optional region/state for relocate. |
| confirm | boolean | false returns the plan only; true applies it. |
| country | string | Two-letter ISO country code. Required for relocate. |
{
"name": "bamf.manage_proxy",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"client",
"action"
],
"properties": {
"city": {
"type": "string",
"description": "Optional city for relocate."
},
"action": {
"enum": [
"rotate",
"relocate",
"disable"
],
"type": "string"
},
"client": {
"type": "string",
"description": "Client workspace id, slug, or client name."
},
"region": {
"type": "string",
"description": "Optional region/state for relocate."
},
"confirm": {
"type": "boolean",
"default": false,
"description": "false returns the plan only; true applies it."
},
"country": {
"type": "string",
"description": "Two-letter ISO country code. Required for relocate."
}
}
},
"annotations": {
"title": "Manage Cloud Proxy",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| topic | string | |
| content * | string | |
| x_format | string | one of ["single","thread","long_form","article_candidate","image_post","resource_dm"] |
| creator_id * | string | |
| media_plan | object | |
| thread_items | array | Optional ordered thread items for the X editor/scheduler. |
| auto_dm_campaign | object | Optional reviewed resource-DM campaign config: keyword, message, require_follow, require_repost. |
{
"name": "bamf.create_x_post_draft",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id",
"content"
],
"properties": {
"topic": {
"type": "string"
},
"content": {
"type": "string"
},
"x_format": {
"enum": [
"single",
"thread",
"long_form",
"article_candidate",
"image_post",
"resource_dm"
],
"type": "string",
"default": "single"
},
"creator_id": {
"type": "string"
},
"media_plan": {
"type": "object"
},
"thread_items": {
"type": "array",
"items": {
"type": "object"
},
"description": "Optional ordered thread items for the X editor/scheduler."
},
"auto_dm_campaign": {
"type": "object",
"description": "Optional reviewed resource-DM campaign config: keyword, message, require_follow, require_repost."
}
}
},
"annotations": {
"title": "Create X Post Draft",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| tone | string | |
| brief * | string | |
| topic | string | |
| platform | string | one of ["linkedin","x","twitter"] |
| post_type | string | one of ["text","image","carousel","video","article"] |
| creator_id * | string | |
| media_plan | object | |
| constraints | array | |
| source_urls | array | Source URLs to synthesize and weave into the draft when useful. |
| evidence_needs |
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.
| Parameter | Type | Description |
|---|---|---|
| brief * | string | |
| x_format | string | one of ["auto","single","thread","long_form","reply","quote","bookmark_remix","image_post","resource_dm"] |
| creator_id * | string | |
| media_plan | object | |
| constraints | array | |
| source_urls | array | |
| thread_length | number | Preferred thread length. 5-10 is usually strongest. |
| research_notes | string | |
| engagement_goal | string | one of ["reply","repost","bookmark","profile_click","follow","dm","none"] |
| research_policy | string | one of ["auto","required","off"] |
| source_material | string |
Patch an existing draft or scheduled post after the user approves exact edits. Supports first comments and media fields.
| Parameter | Type | Description |
|---|---|---|
| topic | string | |
| content | string | |
| post_id * | string | |
| post_type | string | one of ["text","image","carousel","video","article"] |
| video_url | string | |
| article_url | string | |
| document_url | string | LinkedIn carousel/document PDF URL. |
| article_title | string | |
| first_comment | string | |
| carousel_slides | array | |
| edit_instruction | string | The user's instruction that produced this content edit; recorded as a learning signal. |
| uploaded_image_url |
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.
| Parameter | Type | Description |
|---|---|---|
| avoid | array | Phrases, claims, tones, CTAs, or angles the edit should avoid. |
| post_id | string | |
| edit_mode | string | one of ["auto","surgical","general","full_rewrite","regenerate_from_draft"] |
| creator_id * | string | |
| media_notes | string | |
| quality_bar | array | Review criteria the proposal should satisfy, such as first-person hook, second-line stakes, specific creator insight, mobile scannability, and strong close. |
| source_urls | array | Source URLs to synthesize and weave into the revision when useful. |
| instructions | string | |
| must_preserve | array | Facts, claims, wording, examples, or constraints that must survive the edit. |
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.
| Parameter | Type | Description |
|---|---|---|
| cta | string | |
| body | string | |
| slide * | number | 1-based slide number (see bamf.list_post_versions slides[]). |
| title | string | |
| content | string | Full slide copy; when omitted it is rebuilt from title/body/cta. |
| post_id * | string | |
| rerender | boolean | Prompt carousels only (including hand-built ones): re-render this page (cover or close on hand-built decks) and rebuild the PDF; the previous image stays in versions and errors are returned. |
| image_instruction | string | Edit this slide's current image. Requires images:generate. |
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. If the post's design is a Claude HTML design (Made with Claude), the edit runs Edit with Claude instead: a new design version the post shows (poll bamf.get_design); reference_version/source_image_url are refused there.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string | |
| instruction * | string | |
| source_image_url | string | Optional base image to edit instead of the image the post shows now. Must be this post's current image, an image_history entry or one of its design versions (bamf.list_post_versions). Use it right after choosing a new base so the edit cannot land on the older image. |
| reference_version | number | Index into image_history from bamf.list_post_versions. |
| keep_everything_else | boolean |
{
"name": "bamf.edit_post_image",
"description": "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. If the post's design is a Claude HTML design (Made with Claude), the edit runs Edit with Claude instead: a new design version the post shows (poll bamf.get_design); reference_version/source_image_url are refused there.",
"inputSchema": {
"type": "object",
"required": [
"post_id",
"instruction"
],
"properties": {
"post_id": {
"type": "string"
},
"instruction": {
"type": "string"
},
"source_image_url": {
"type": "string",
"description": "Optional base image to edit instead of the image the post shows now. Must be this post's current image, an image_history entry or one of its design versions (bamf.list_post_versions). Use it right after choosing a new base so the edit cannot land on the older image."
},
"reference_version": {
"type": "number",
"description": "Index into image_history from bamf.list_post_versions."
},
"keep_everything_else": {
"type": "boolean",
"default": true
}
}
},
"annotations": {
"title": "Edit Post Image",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string |
{
"name": "bamf.list_post_versions",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string"
}
}
},
"annotations": {
"title": "List Post Versions",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Restore 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.
| Parameter | Type | Description |
|---|---|---|
| kind * | string | one of ["text","image","slide_image","slide_text"] |
| index | number | |
| slide | number | |
| post_id * | string | |
| image_url | string | |
| version_id | string |
{
"name": "bamf.revert_post_version",
"description": "Restore 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.",
"inputSchema": {
"type": "object",
"required": [
"post_id",
"kind"
],
"properties": {
"kind": {
"enum": [
"text",
"image",
"slide_image",
"slide_text"
],
"type": "string"
},
"index": {
"type": "number"
},
"slide": {
"type": "number"
},
"post_id": {
"type": "string"
},
"image_url": {
"type": "string"
},
"version_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Revert Post Version",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Delete a normal BAMF content post.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string |
{
"name": "bamf.delete_post",
"description": "Delete a normal BAMF content post.",
"inputSchema": {
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Delete Post",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| boost | object | Optional per-post engagement boost. Requires posts:boost and approved=true after the user reviews the exact plan. |
| post_id * | string | |
| scheduled_for * | string | Future ISO timestamp. |
{
"name": "bamf.schedule_post",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"post_id",
"scheduled_for"
],
"properties": {
"boost": {
"type": "object",
"properties": {
"tier": {
"enum": [
"basic",
"power",
"mega"
],
"type": "string",
"description": "Reach tier: more engagement groups / larger communities."
},
"enabled": {
"type": "boolean"
},
"approved": {
"type": "boolean",
"description": "Must be true only after exact post, schedule, tier, and engagement mix review."
},
"engagement_type": {
"enum": [
"reactions",
"reactions_comments",
"any"
],
"type": "string"
}
},
"description": "Optional per-post engagement boost. Requires posts:boost and approved=true after the user reviews the exact plan."
},
"post_id": {
"type": "string"
},
"scheduled_for": {
"type": "string",
"description": "Future ISO timestamp."
}
}
},
"annotations": {
"title": "Schedule Post",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Apply engagement boost to a post. Published posts boost immediately; scheduled posts are armed for publish time. Requires the posts:boost scope.
| Parameter | Type | Description |
|---|---|---|
| tier | string | one of ["basic","power","mega"] |
| post_id * | string | |
| approved * | boolean | Must be true only after exact boost-plan review. |
| engagement_type | string | one of ["reactions","reactions_comments","any"] |
{
"name": "bamf.boost_post",
"description": "Apply engagement boost to a post. Published posts boost immediately; scheduled posts are armed for publish time. Requires the posts:boost scope.",
"inputSchema": {
"type": "object",
"required": [
"post_id",
"approved"
],
"properties": {
"tier": {
"enum": [
"basic",
"power",
"mega"
],
"type": "string"
},
"post_id": {
"type": "string"
},
"approved": {
"type": "boolean",
"description": "Must be true only after exact boost-plan review."
},
"engagement_type": {
"enum": [
"reactions",
"reactions_comments",
"any"
],
"type": "string"
}
}
},
"annotations": {
"title": "Boost Post",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}List available engagement boost tiers (basic/power/mega) with reach and token cost.
No parameters.
{
"name": "bamf.list_boost_tiers",
"description": "List available engagement boost tiers (basic/power/mega) with reach and token cost.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "List Boost Tiers",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| author_id | string | Optional: only groups matching this creator's region/industry. |
{
"name": "bamf.list_boost_groups",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"author_id": {
"type": "string",
"description": "Optional: only groups matching this creator's region/industry."
}
}
},
"annotations": {
"title": "List Boost Groups",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Estimate the projected first-wave reach (people, reactions, comments) for boosting a creator's post.
| Parameter | Type | Description |
|---|---|---|
| tier | string | one of ["basic","power","mega"] |
| author_id * | string |
{
"name": "bamf.estimate_boost",
"description": "Estimate the projected first-wave reach (people, reactions, comments) for boosting a creator's post.",
"inputSchema": {
"type": "object",
"required": [
"author_id"
],
"properties": {
"tier": {
"enum": [
"basic",
"power",
"mega"
],
"type": "string"
},
"author_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Estimate Boost",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Unschedule a post. Creator-scoped API keys may use this.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string |
{
"name": "bamf.unschedule_post",
"description": "Unschedule a post. Creator-scoped API keys may use this.",
"inputSchema": {
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Unschedule Post",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Pause auto-publishing while keeping the scheduled time visible in BAMF.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string |
{
"name": "bamf.pause_scheduled_post",
"description": "Pause auto-publishing while keeping the scheduled time visible in BAMF.",
"inputSchema": {
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Pause Scheduled Post",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Resume a paused scheduled post using its stored scheduled time.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string |
{
"name": "bamf.resume_scheduled_post",
"description": "Resume a paused scheduled post using its stored scheduled time.",
"inputSchema": {
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Resume Scheduled Post",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Publish a post immediately. User-scoped keys only; creator-scoped keys receive a helpful 403.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string |
{
"name": "bamf.publish_post_now",
"description": "Publish a post immediately. User-scoped keys only; creator-scoped keys receive a helpful 403.",
"inputSchema": {
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Publish Post Now",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}Publish 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.
| Parameter | Type | Description |
|---|---|---|
| text * | string | Exact reply text (<= 280 characters). |
| creator_id * | string | |
| in_reply_to * | string | X post id or https://x.com/<handle>/status/<id> URL being replied to. |
| original_text | string | The AI draft before the user's edits, if edited. |
| target_author_handle | string | Handle of the post's author (for the per-author cap); parsed from the URL when omitted. |
{
"name": "bamf.publish_x_reply",
"description": "Publish 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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id",
"in_reply_to",
"text"
],
"properties": {
"text": {
"type": "string",
"description": "Exact reply text (<= 280 characters)."
},
"creator_id": {
"type": "string"
},
"in_reply_to": {
"type": "string",
"description": "X post id or https://x.com/<handle>/status/<id> URL being replied to."
},
"original_text": {
"type": "string",
"description": "The AI draft before the user's edits, if edited."
},
"target_author_handle": {
"type": "string",
"description": "Handle of the post's author (for the per-author cap); parsed from the URL when omitted."
}
}
},
"annotations": {
"title": "Publish X Reply",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| creator_id * | string |
{
"name": "bamf.get_x_safety_status",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id"
],
"properties": {
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Get X Safety Status",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List content ideas for a creator space.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| search | string | |
| status | string | |
| creator_id | string |
{
"name": "bamf.list_ideas",
"description": "List content ideas for a creator space.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 20
},
"search": {
"type": "string"
},
"status": {
"type": "string"
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "List Ideas",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| query | string | Optional topic, brief, or constraint for this idea set. |
| formats | array | |
| platforms | array | |
| creator_id * | string | |
| external_sources | object | |
| include_x_bookmarks | boolean | |
| x_bookmark_folder_ids | array | |
| external_research_mode | string | one of ["adaptive","explicit","off"] |
{
"name": "bamf.generate_ideas",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id"
],
"properties": {
"query": {
"type": "string",
"description": "Optional topic, brief, or constraint for this idea set."
},
"formats": {
"type": "array",
"items": {
"enum": [
"post",
"carousel",
"thread",
"reply",
"quote",
"image",
"video",
"article"
],
"type": "string"
}
},
"platforms": {
"type": "array",
"items": {
"enum": [
"linkedin",
"x",
"both"
],
"type": "string"
}
},
"creator_id": {
"type": "string"
},
"external_sources": {
"type": "object",
"properties": {
"web": {
"type": "boolean"
},
"xai": {
"type": "boolean"
},
"reddit": {
"type": "boolean"
},
"perplexity": {
"type": "boolean",
"description": "Deprecated alias of web; removed after one release."
}
}
},
"include_x_bookmarks": {
"type": "boolean",
"default": false
},
"x_bookmark_folder_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"external_research_mode": {
"enum": [
"adaptive",
"explicit",
"off"
],
"type": "string",
"default": "adaptive"
}
}
},
"annotations": {
"title": "Generate Ideas",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Create a content idea for a creator space.
| Parameter | Type | Description |
|---|---|---|
| tags | array | |
| title * | string | |
| content * | string | |
| creator_id * | string |
{
"name": "bamf.create_idea",
"description": "Create a content idea for a creator space.",
"inputSchema": {
"type": "object",
"required": [
"creator_id",
"title",
"content"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"title": {
"type": "string"
},
"content": {
"type": "string"
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Create Idea",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| brief | string | One-line summary of the post. |
| links | array | |
| idea_text * | string | The request in the client's own words. |
| creator_id * | string |
{
"name": "bamf.create_post_request",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id",
"idea_text"
],
"properties": {
"brief": {
"type": "string",
"description": "One-line summary of the post."
},
"links": {
"type": "array",
"items": {
"type": "string"
}
},
"idea_text": {
"type": "string",
"description": "The request in the client's own words."
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Create Post Request",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| workspace_id | string | Client space workspace id from bamf.list_creator_spaces. Optional when you belong to exactly one space. |
{
"name": "bamf.read_team_channel",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1
},
"workspace_id": {
"type": "string",
"description": "Client space workspace id from bamf.list_creator_spaces. Optional when you belong to exactly one space."
}
}
},
"annotations": {
"title": "Read Team Channel",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| text * | string | The message as the team should read it. |
| confirm | boolean | false returns the plan only; true posts. |
| workspace_id | string | Client space workspace id from bamf.list_creator_spaces. Optional when you belong to exactly one space. |
| idempotency_key | string | Required with confirm=true. |
{
"name": "bamf.message_team_channel",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 3000,
"description": "The message as the team should read it."
},
"confirm": {
"type": "boolean",
"default": false,
"description": "false returns the plan only; true posts."
},
"workspace_id": {
"type": "string",
"description": "Client space workspace id from bamf.list_creator_spaces. Optional when you belong to exactly one space."
},
"idempotency_key": {
"type": "string",
"maxLength": 200,
"minLength": 8,
"description": "Required with confirm=true."
}
}
},
"annotations": {
"title": "Message Team Channel",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| creator_id * | string |
{
"name": "bamf.list_client_channels",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id"
],
"properties": {
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "List Client Channels",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| link | string | Optional https URL appended to the message. |
| text * | string | |
| dry_run | boolean | |
| channel_id * | string | Channel id (or #name) from bamf.list_client_channels. |
| creator_id * | string | |
| idempotency_key * | string |
{
"name": "bamf.share_to_channel",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id",
"channel_id",
"text",
"idempotency_key"
],
"properties": {
"link": {
"type": "string",
"description": "Optional https URL appended to the message."
},
"text": {
"type": "string",
"maxLength": 3000
},
"dry_run": {
"type": "boolean",
"default": false
},
"channel_id": {
"type": "string",
"description": "Channel id (or #name) from bamf.list_client_channels."
},
"creator_id": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"maxLength": 200,
"minLength": 8
}
}
},
"annotations": {
"title": "Share To Channel",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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).
| Parameter | Type | Description |
|---|---|---|
| kind * | string | one of ["pipeline","approval_queue","interview_progress"] |
| dry_run | boolean | |
| block_id | string | Existing block id to update in place (agency-wide kinds). |
| workspace_id * | string | Agency workspace (all its clients) or a single client workspace. interview_progress needs a client workspace. |
| notion_page_id | string | Target Notion page; defaults to the client binding's internal OS page. |
{
"name": "bamf.publish_notion_status_block",
"description": "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).",
"inputSchema": {
"type": "object",
"required": [
"kind",
"workspace_id"
],
"properties": {
"kind": {
"enum": [
"pipeline",
"approval_queue",
"interview_progress"
],
"type": "string"
},
"dry_run": {
"type": "boolean",
"default": false
},
"block_id": {
"type": "string",
"description": "Existing block id to update in place (agency-wide kinds)."
},
"workspace_id": {
"type": "string",
"description": "Agency workspace (all its clients) or a single client workspace. interview_progress needs a client workspace."
},
"notion_page_id": {
"type": "string",
"description": "Target Notion page; defaults to the client binding's internal OS page."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Publish Notion Status Block",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List content approval requests for the workspaces this connection can reach. Requires client_approvals:read.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| status | string | one of ["pending","approved","changes_requested","rejected"] |
| creator_id | string | |
| workspace_id | string |
{
"name": "bamf.list_client_approvals",
"description": "List content approval requests for the workspaces this connection can reach. Requires client_approvals:read.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 20
},
"status": {
"enum": [
"pending",
"approved",
"changes_requested",
"rejected"
],
"type": "string"
},
"creator_id": {
"type": "string"
},
"workspace_id": {
"type": "string"
}
}
},
"annotations": {
"title": "List Client Approvals",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read one content approval request with its post and comments. Requires client_approvals:read.
| Parameter | Type | Description |
|---|---|---|
| approval_id * | string |
{
"name": "bamf.get_client_approval",
"description": "Read one content approval request with its post and comments. Requires client_approvals:read.",
"inputSchema": {
"type": "object",
"required": [
"approval_id"
],
"properties": {
"approval_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Get Client Approval",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| status * | string | one of ["pending","approved","changes_requested","rejected"] |
| comment | string | |
| approval_id * | string | |
| idempotency_key * | string |
{
"name": "bamf.decide_client_approval",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"approval_id",
"status",
"idempotency_key"
],
"properties": {
"status": {
"enum": [
"pending",
"approved",
"changes_requested",
"rejected"
],
"type": "string"
},
"comment": {
"type": "string"
},
"approval_id": {
"type": "string"
},
"idempotency_key": {
"type": "string",
"maxLength": 200,
"minLength": 8
}
}
},
"annotations": {
"title": "Decide Client Approval",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List a client creator's recent post requests with their pipeline state and Notion link.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| creator_id * | string |
{
"name": "bamf.list_post_requests",
"description": "List a client creator's recent post requests with their pipeline state and Notion link.",
"inputSchema": {
"type": "object",
"required": [
"creator_id"
],
"properties": {
"limit": {
"type": "number",
"default": 20
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "List Post Requests",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List creator interviews from transcript knowledge documents and app-native chat interview sessions.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| creator_id | string |
{
"name": "bamf.list_interviews",
"description": "List creator interviews from transcript knowledge documents and app-native chat interview sessions.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 20
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "List Interviews",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| label | string | Short internal label for the interview. |
| max_uses | number | |
| creator_id * | string | |
| expires_days | number | |
| contact_metadata | object |
{
"name": "bamf.create_interview_link",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id"
],
"properties": {
"label": {
"type": "string",
"description": "Short internal label for the interview."
},
"max_uses": {
"type": "number",
"default": 1
},
"creator_id": {
"type": "string"
},
"expires_days": {
"type": "number",
"default": 14
},
"contact_metadata": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"email": {
"type": "string"
},
"company": {
"type": "string"
}
}
}
}
},
"annotations": {
"title": "Create Interview Link",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| notes | string | |
| query | string | |
| topic | string | |
| creator_id * | string | |
| source_urls | array | |
| use_perplexity | boolean | Deprecated alias of use_web_research; removed after one release. |
| desired_outputs | array | |
| use_web_research | boolean | Use BAMF's web current-research path when available. |
{
"name": "bamf.run_research",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id"
],
"properties": {
"notes": {
"type": "string"
},
"query": {
"type": "string"
},
"topic": {
"type": "string"
},
"creator_id": {
"type": "string"
},
"source_urls": {
"type": "array",
"items": {
"type": "string"
}
},
"use_perplexity": {
"type": "boolean",
"description": "Deprecated alias of use_web_research; removed after one release."
},
"desired_outputs": {
"type": "array",
"items": {
"type": "string"
}
},
"use_web_research": {
"type": "boolean",
"default": true,
"description": "Use BAMF's web current-research path when available."
}
}
},
"annotations": {
"title": "Run Research",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Run 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.
| Parameter | Type | Description |
|---|---|---|
| series | array | |
| cadence | string | one of ["daily","weekly"] |
| dry_run | boolean | Extract/verify/rank only, no drafts. |
| eval_run | boolean | QA runs: drafts are stamped eval_run and stay out of the review queue. |
| new_post | boolean | True only when the creator explicitly asked for a separate/new post. |
| creator_id * | string | |
| workspace_id | string | Optional; defaults to the creator's workspace. |
| target_post_id | string | The post open in the editor. The matching draft updates it in place (prior version kept) instead of creating a new post. Omit only when the creator explicitly asks for a new post. |
Remix a creator's open post requests from top performers: each client post request (or idea, with include_ideas) becomes 1-3 drafts modeled on a top-performing reference post (structure, hook, format) and a visual reference, written in the creator's voice and Brain, with a rendered visual that passed auto image QA. Drafts are agency-internal (Team review): the client never sees them until a manager marks them Ready for client. Old drafts for the same request are archived with a reason. Never schedules or publishes. Flow: list, then per request plan, piece for each piece_index, finalize.
| Parameter | Type | Description |
|---|---|---|
| action | string | list, then per request: plan, piece (each piece_index; returns when drafted, up to ~5 min), finalize. |
| visual | string | For action piece: override the planned visual format. |
| dry_run | boolean | |
| creator_id * | string | |
| piece_index | number | For action piece: which planned piece to draft. |
| request_ids | array | The request (from action list); the first id is used. |
| include_ideas | boolean | Also treat unused interview/manual ideas as requests. |
{
"name": "bamf.remix_post_requests",
"description": "Remix a creator's open post requests from top performers: each client post request (or idea, with include_ideas) becomes 1-3 drafts modeled on a top-performing reference post (structure, hook, format) and a visual reference, written in the creator's voice and Brain, with a rendered visual that passed auto image QA. Drafts are agency-internal (Team review): the client never sees them until a manager marks them Ready for client. Old drafts for the same request are archived with a reason. Never schedules or publishes. Flow: list, then per request plan, piece for each piece_index, finalize.",
"inputSchema": {
"type": "object",
"required": [
"creator_id"
],
"properties": {
"action": {
"enum": [
"list",
"plan",
"piece",
"status",
"finalize"
],
"type": "string",
"default": "list",
"description": "list, then per request: plan, piece (each piece_index; returns when drafted, up to ~5 min), finalize."
},
"visual": {
"enum": [
"infographic",
"image_quote",
"carousel",
"personal"
],
"type": "string",
"description": "For action piece: override the planned visual format."
},
"dry_run": {
"type": "boolean",
"default": false
},
"creator_id": {
"type": "string"
},
"piece_index": {
"type": "number",
"description": "For action piece: which planned piece to draft."
},
"request_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "The request (from action list); the first id is used."
},
"include_ideas": {
"type": "boolean",
"default": false,
"description": "Also treat unused interview/manual ideas as requests."
}
}
},
"annotations": {
"title": "Remix Post Requests",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Search creator knowledge documents.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| search | string | |
| creator_id | string |
{
"name": "bamf.search_knowledge",
"description": "Search creator knowledge documents.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 20
},
"search": {
"type": "string"
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Search Knowledge",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| tags | array | |
| type | string | Use interview_transcript for interview imports. |
| title | string | |
| content | string | |
| metadata | object | |
| creator_id * | string | |
| document_id | string |
{
"name": "bamf.process_knowledge",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"type": {
"type": "string",
"description": "Use interview_transcript for interview imports."
},
"title": {
"type": "string"
},
"content": {
"type": "string"
},
"metadata": {
"type": "object"
},
"creator_id": {
"type": "string"
},
"document_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Process Knowledge",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Save an interview transcript as a BAMF knowledge document and optionally queue interview-specific knowledge processing.
| Parameter | Type | Description |
|---|---|---|
| tags | array | |
| title * | string | |
| process | boolean | |
| creator_id * | string | |
| transcript * | string | |
| interviewee | string | |
| interviewer | string |
{
"name": "bamf.create_interview_transcript",
"description": "Save an interview transcript as a BAMF knowledge document and optionally queue interview-specific knowledge processing.",
"inputSchema": {
"type": "object",
"required": [
"creator_id",
"title",
"transcript"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"title": {
"type": "string"
},
"process": {
"type": "boolean",
"default": true
},
"creator_id": {
"type": "string"
},
"transcript": {
"type": "string"
},
"interviewee": {
"type": "string"
},
"interviewer": {
"type": "string"
}
}
},
"annotations": {
"title": "Create Interview Transcript",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Add a knowledge or memory document to a creator space. API documentation: https://bamf.ai/docs/mcp/overview
| Parameter | Type | Description |
|---|---|---|
| path | string | |
| tags | array | |
| title * | string | |
| content * | string | |
| creator_id * | string |
{
"name": "bamf.add_knowledge_doc",
"description": "Add a knowledge or memory document to a creator space. API documentation: https://bamf.ai/docs/mcp/overview",
"inputSchema": {
"type": "object",
"required": [
"creator_id",
"title",
"content"
],
"properties": {
"path": {
"type": "string"
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"title": {
"type": "string"
},
"content": {
"type": "string"
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Add Knowledge Doc",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| path | string | Optional lowercase .md, .json, or .txt path under the creator knowledge library. |
| tags | array | |
| title * | string | |
| content * | string | Durable Markdown or JSON-compatible text, maximum 200KB. |
| creator_id * | string | |
| source_provider * | string | one of ["claude","chatgpt","codex","bamf","other"] |
| created_by_agent | string | |
| source_session_id | string | |
| source_session_url | string | Optional visible Claude, ChatGPT, Codex, or BAMF session URL. Omit when the host does not expose it. |
| source_artifact_type |
List 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.
| Parameter | Type | Description |
|---|---|---|
| query | string | Case-insensitive match on id, name and description. |
| origin | string | one of ["ui_card","genui_node","dsi"] |
| surface | string | Only components that render on this surface. |
| include_schema | boolean | Include propsSchema, example and $defs. Set false for a compact list. |
| include_tokens | boolean | Include DSI tokens (color, type, radius, spacing, motion) and principles. |
{
"name": "bamf.list_ui_components",
"description": "List 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.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 120,
"description": "Case-insensitive match on id, name and description."
},
"origin": {
"enum": [
"ui_card",
"genui_node",
"dsi"
],
"type": "string"
},
"surface": {
"enum": [
"in-chat",
"right-pane",
"page",
"artifact"
],
"type": "string",
"description": "Only components that render on this surface."
},
"include_schema": {
"type": "boolean",
"default": true,
"description": "Include propsSchema, example and $defs. Set false for a compact list."
},
"include_tokens": {
"type": "boolean",
"default": true,
"description": "Include DSI tokens (color, type, radius, spacing, motion) and principles."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List UI Components",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Validate 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.
| Parameter | Type | Description |
|---|---|---|
| spec * | ["object","string"] | A ui_cards payload or GenUI spec, as an object or JSON string. |
| format | string | Optional; auto-detected when omitted. |
{
"name": "bamf.validate_ui_spec",
"description": "Validate 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.",
"inputSchema": {
"type": "object",
"required": [
"spec"
],
"properties": {
"spec": {
"type": [
"object",
"string"
],
"description": "A ui_cards payload or GenUI spec, as an object or JSON string."
},
"format": {
"enum": [
"ui_cards",
"genui"
],
"type": "string",
"description": "Optional; auto-detected when omitted."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Validate UI Spec",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Add a short durable memory to the creator's knowledge base.
| Parameter | Type | Description |
|---|---|---|
| title | string | |
| memory * | string | |
| creator_id * | string |
{
"name": "bamf.add_memory",
"description": "Add a short durable memory to the creator's knowledge base.",
"inputSchema": {
"type": "object",
"required": [
"creator_id",
"memory"
],
"properties": {
"title": {
"type": "string"
},
"memory": {
"type": "string"
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Add Memory",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| kind | string | one of ["personal","company"] |
| creator_id * | string |
{
"name": "bamf.get_brain",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id"
],
"properties": {
"kind": {
"enum": [
"personal",
"company"
],
"type": "string",
"default": "personal"
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Get Brain",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Propose a change to a brain; the owner approves it in BAMF. This only queues a proposal and never edits the brain.
| Parameter | Type | Description |
|---|---|---|
| body * | string | |
| kind * | string | one of ["personal","company"] |
| target * | string | Brain file or folder path, for example voice.md. |
| summary * | string | |
| creator_id * | string |
{
"name": "bamf.propose_brain_update",
"description": "Propose a change to a brain; the owner approves it in BAMF. This only queues a proposal and never edits the brain.",
"inputSchema": {
"type": "object",
"required": [
"creator_id",
"kind",
"target",
"summary",
"body"
],
"properties": {
"body": {
"type": "string",
"maxLength": 20000
},
"kind": {
"enum": [
"personal",
"company"
],
"type": "string"
},
"target": {
"type": "string",
"description": "Brain file or folder path, for example voice.md."
},
"summary": {
"type": "string",
"maxLength": 300
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Propose Brain Update",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}List saved Profile Studio packages for a creator. Returns safe package content and selection state, never raw capture provenance or provider credentials.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| creator_id | string | |
| include_archived | boolean |
{
"name": "bamf.list_profile_packages",
"description": "List saved Profile Studio packages for a creator. Returns safe package content and selection state, never raw capture provenance or provider credentials.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 50
},
"creator_id": {
"type": "string"
},
"include_archived": {
"type": "boolean",
"default": false
}
}
},
"annotations": {
"title": "List Profile Packages",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read one saved Profile Studio package. This is BAMF package data only, not a live LinkedIn profile read or application.
| Parameter | Type | Description |
|---|---|---|
| profile_package_id * | string |
{
"name": "bamf.get_profile_package",
"description": "Read one saved Profile Studio package. This is BAMF package data only, not a live LinkedIn profile read or application.",
"inputSchema": {
"type": "object",
"required": [
"profile_package_id"
],
"properties": {
"profile_package_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Get Profile Package",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| creator_id * | string |
{
"name": "bamf.get_profile_capture_status",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id"
],
"properties": {
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Get Profile Capture Status",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| notes | ["string","null"] | |
| title * | string | |
| snapshot * | object | |
| creator_id * | string | |
| thumbnail_url | ["string","null"] |
{
"name": "bamf.create_profile_package",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id",
"title",
"snapshot"
],
"properties": {
"notes": {
"type": [
"string",
"null"
]
},
"title": {
"type": "string"
},
"snapshot": {
"type": "object"
},
"creator_id": {
"type": "string"
},
"thumbnail_url": {
"type": [
"string",
"null"
]
}
}
},
"annotations": {
"title": "Create Profile Package",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| notes | ["string","null"] | |
| title | string | |
| snapshot | object | |
| is_archived | boolean | |
| thumbnail_url | ["string","null"] | |
| idempotency_key | string | Keep this value unchanged when retrying the same approved save. |
| profile_package_id * | string |
{
"name": "bamf.update_profile_package",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"profile_package_id"
],
"properties": {
"notes": {
"type": [
"string",
"null"
]
},
"title": {
"type": "string"
},
"snapshot": {
"type": "object"
},
"is_archived": {
"type": "boolean"
},
"thumbnail_url": {
"type": [
"string",
"null"
]
},
"idempotency_key": {
"type": "string",
"maxLength": 200,
"minLength": 8,
"description": "Keep this value unchanged when retrying the same approved save."
},
"profile_package_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Update Profile Package",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Duplicate a saved Profile Studio package as a draft variation after exact approval. This is reversible and never applies the variation to LinkedIn.
| Parameter | Type | Description |
|---|---|---|
| title | string | |
| profile_package_id * | string |
{
"name": "bamf.duplicate_profile_package",
"description": "Duplicate a saved Profile Studio package as a draft variation after exact approval. This is reversible and never applies the variation to LinkedIn.",
"inputSchema": {
"type": "object",
"required": [
"profile_package_id"
],
"properties": {
"title": {
"type": "string"
},
"profile_package_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Duplicate Profile Package",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Mark a saved Profile Studio package selected after exact approval. Selection is reversible BAMF metadata, not live LinkedIn application or publishing.
| Parameter | Type | Description |
|---|---|---|
| profile_package_id * | string |
{
"name": "bamf.select_profile_package",
"description": "Mark a saved Profile Studio package selected after exact approval. Selection is reversible BAMF metadata, not live LinkedIn application or publishing.",
"inputSchema": {
"type": "object",
"required": [
"profile_package_id"
],
"properties": {
"profile_package_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Select Profile Package",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Archive a saved Profile Studio package after exact approval. Archive is reversible through update_profile_package and never changes LinkedIn.
| Parameter | Type | Description |
|---|---|---|
| profile_package_id * | string |
{
"name": "bamf.archive_profile_package",
"description": "Archive a saved Profile Studio package after exact approval. Archive is reversible through update_profile_package and never changes LinkedIn.",
"inputSchema": {
"type": "object",
"required": [
"profile_package_id"
],
"properties": {
"profile_package_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Archive Profile Package",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List media assets for a creator space.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| creator_id | string |
{
"name": "bamf.list_media",
"description": "List media assets for a creator space.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 20
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "List Media",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List Media Library folders for a creator space.
| Parameter | Type | Description |
|---|---|---|
| creator_id | string |
{
"name": "bamf.list_media_folders",
"description": "List Media Library folders for a creator space.",
"inputSchema": {
"type": "object",
"properties": {
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "List Media Folders",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List connected creator integrations and per-author integration settings without exposing tokens, cookies, or secrets.
| Parameter | Type | Description |
|---|---|---|
| creator_id | string |
{
"name": "bamf.list_integrations",
"description": "List connected creator integrations and per-author integration settings without exposing tokens, cookies, or secrets.",
"inputSchema": {
"type": "object",
"properties": {
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "List Integrations",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| creator_id | string |
{
"name": "bamf.list_brand_kits",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 20
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "List Brand Kits",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| query | string | Matches reference name or tag. |
| source | string | library = human-approved reference designs (reference image, design_type, design_subtype, slot shape, person slot, render route, agent_notes). Pick by subtype and slot shape that fit the post. |
| category | string | |
| platform | string | one of ["linkedin","x","instagram"] |
| post_type | string | e.g. text, image_quote, infographic, carousel, motion_infographic, single_post, thread, quote_card, screenshot, comic, feed_image, reel_cover |
| design_type | string | With source=library, e.g. infographic, diagram, tweet_card, quote_card, personal_image, visual_metaphor. |
| person_slot | string | one of ["none","avatar","card_photo","full_bleed_photo","illustration"] |
| include_guide |
Return 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.
| Parameter | Type | Description |
|---|---|---|
| page | number | 1-based; increment for 'show 4 more'. |
| format * | string | one of ["infographic","carousel","image","quote","motion","video"] |
| platform | string | one of ["linkedin","x","instagram","tiktok","youtube"] |
| author_id | string | Creator whose approved designs and brand styles are included. |
{
"name": "bamf.list_style_options",
"description": "Return 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.",
"inputSchema": {
"type": "object",
"required": [
"format"
],
"properties": {
"page": {
"type": "number",
"default": 1,
"description": "1-based; increment for 'show 4 more'."
},
"format": {
"enum": [
"infographic",
"carousel",
"image",
"quote",
"motion",
"video"
],
"type": "string"
},
"platform": {
"enum": [
"linkedin",
"x",
"instagram",
"tiktok",
"youtube"
],
"type": "string",
"default": "linkedin"
},
"author_id": {
"type": "string",
"description": "Creator whose approved designs and brand styles are included."
}
}
},
"annotations": {
"title": "List Style Options",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Return 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.
| Parameter | Type | Description |
|---|---|---|
| format | string | Deck to open first. |
| author_id | string | Creator to tune; defaults to the creator the key is scoped to. |
{
"name": "bamf.open_style_swipe",
"description": "Return 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.",
"inputSchema": {
"type": "object",
"properties": {
"format": {
"enum": [
"infographic",
"carousel",
"quote",
"personal",
"video"
],
"type": "string",
"description": "Deck to open first."
},
"author_id": {
"type": "string",
"description": "Creator to tune; defaults to the creator the key is scoped to."
}
}
},
"annotations": {
"title": "Open Style Swipe",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| slug | string | |
| creator_id | string | |
| reference_id | string | |
| brand_pack_id | string | Optional brand pack to take palette and fonts from. |
| brand_kit_project_id | string |
{
"name": "bamf.instantiate_design_reference",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"creator_id": {
"type": "string"
},
"reference_id": {
"type": "string"
},
"brand_pack_id": {
"type": "string",
"description": "Optional brand pack to take palette and fonts from."
},
"brand_kit_project_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Instantiate Design Reference",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| mode | string | one of ["append","replace"] |
| name | string | |
| tags | array | |
| fonts | array | |
| notes | ["string","null"] | |
| palette | array | |
| pack_type | string | one of ["personal","image_quote","infographic","carousel"] |
| asset_role | string | one of ["logo","style_reference","template_reference","texture","color_reference"] |
| creator_id * | string | |
| brand_rules | ["string","null"] | |
| description | ["string","null"] |
List a creator's likeness photos with labels (shot, setting, mood, quality), Real/AI source and review status. Pass post_text and/or slot (avatar, stats_over_photo, personal_image) to get the best-fitting accepted photos ranked with a reason instead. Pass include='identity' for the saved signature marks, sign-off arrangements, sign-off portraits and main references (use this to answer 'use a different signature style'). Read-only.
| Parameter | Type | Description |
|---|---|---|
| slot | string | one of ["avatar","stats_over_photo","personal_image","any"] |
| limit | integer | |
| status | string | one of ["pending","accepted","rejected"] |
| include | string | identity: signature marks, sign-off arrangements and portraits, main references. |
| post_text | string | Rank accepted photos for this post. |
| creator_id | string |
{
"name": "bamf.list_likeness_photos",
"description": "List a creator's likeness photos with labels (shot, setting, mood, quality), Real/AI source and review status. Pass post_text and/or slot (avatar, stats_over_photo, personal_image) to get the best-fitting accepted photos ranked with a reason instead. Pass include='identity' for the saved signature marks, sign-off arrangements, sign-off portraits and main references (use this to answer 'use a different signature style'). Read-only.",
"inputSchema": {
"type": "object",
"properties": {
"slot": {
"enum": [
"avatar",
"stats_over_photo",
"personal_image",
"any"
],
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"status": {
"enum": [
"pending",
"accepted",
"rejected"
],
"type": "string"
},
"include": {
"enum": [
"identity"
],
"type": "string",
"description": "identity: signature marks, sign-off arrangements and portraits, main references."
},
"post_text": {
"type": "string",
"description": "Rank accepted photos for this post."
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "List Likeness Photos",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Save a photo of the creator to their likeness library from an HTTPS URL or a data URL, then label it. Always persist any creator photo you use so the next post can reuse it. Real photos are accepted; set is_ai_generated for AI images, which wait as pending for the creator's approval. Never publishes.
| Parameter | Type | Description |
|---|---|---|
| url | string | |
| scene | string | Scene the photo shows, e.g. 'in a coffee shop'. |
| data_url | string | PNG, JPEG or WebP data URL. |
| filename | string | |
| creator_id | string | |
| description | string | |
| is_ai_generated | boolean |
{
"name": "bamf.add_likeness_photo",
"description": "Save a photo of the creator to their likeness library from an HTTPS URL or a data URL, then label it. Always persist any creator photo you use so the next post can reuse it. Real photos are accepted; set is_ai_generated for AI images, which wait as pending for the creator's approval. Never publishes.",
"inputSchema": {
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"scene": {
"type": "string",
"description": "Scene the photo shows, e.g. 'in a coffee shop'."
},
"data_url": {
"type": "string",
"description": "PNG, JPEG or WebP data URL."
},
"filename": {
"type": "string"
},
"creator_id": {
"type": "string"
},
"description": {
"type": "string"
},
"is_ai_generated": {
"type": "boolean",
"default": false
}
}
},
"annotations": {
"title": "Add Likeness Photo",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Accept or reject a likeness photo and/or correct its labels (shot, setting, mood, clothing, quality, is_person). AI photos are used in designs only after acceptance; marking is_person false moves the image out of the likeness set (never deleted). Without photo_id, pass set to change the creator's defaults: signature_mark_url, signoff_arrangement or signoff_cutout_url (values from include='identity' only).
| Parameter | Type | Description |
|---|---|---|
| set | object | Change identity defaults instead of a photo. |
| labels | object | Partial labels to merge, e.g. { shot: 'candid', setting: 'coffee shop' }. |
| comment | string | |
| relabel | boolean | Re-run the vision labeller. |
| decision | string | one of ["accepted","rejected"] |
| photo_id | string | |
| creator_id | string |
{
"name": "bamf.update_likeness_photo",
"description": "Accept or reject a likeness photo and/or correct its labels (shot, setting, mood, clothing, quality, is_person). AI photos are used in designs only after acceptance; marking is_person false moves the image out of the likeness set (never deleted). Without photo_id, pass set to change the creator's defaults: signature_mark_url, signoff_arrangement or signoff_cutout_url (values from include='identity' only).",
"inputSchema": {
"type": "object",
"properties": {
"set": {
"type": "object",
"properties": {
"signature_mark_url": {
"type": "string"
},
"signoff_cutout_url": {
"type": "string"
},
"signoff_arrangement": {
"enum": [
"centred_compact",
"centred_mark",
"compact",
"compact_handle",
"inline",
"mark_only",
"side",
"stacked"
],
"type": "string"
}
},
"description": "Change identity defaults instead of a photo."
},
"labels": {
"type": "object",
"description": "Partial labels to merge, e.g. { shot: 'candid', setting: 'coffee shop' }."
},
"comment": {
"type": "string"
},
"relabel": {
"type": "boolean",
"description": "Re-run the vision labeller."
},
"decision": {
"enum": [
"accepted",
"rejected"
],
"type": "string"
},
"photo_id": {
"type": "string"
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Update Likeness Photo",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Generate 2-4 new photos of the creator in named scenes (at a desk, in a coffee shop, in a Waymo, after a run) from their accepted real photos. Results land as pending AI photos for the creator to accept; nothing is used before that. Costs about $0.15 per image.
| Parameter | Type | Description |
|---|---|---|
| scenes | array | |
| feedback | string | Free-text direction for the new takes, e.g. 'daytime, more natural, less posed'. |
| post_text | string | Infer the scene from a post when scenes is omitted. |
| creator_id | string |
{
"name": "bamf.request_likeness_scenes",
"description": "Generate 2-4 new photos of the creator in named scenes (at a desk, in a coffee shop, in a Waymo, after a run) from their accepted real photos. Results land as pending AI photos for the creator to accept; nothing is used before that. Costs about $0.15 per image.",
"inputSchema": {
"type": "object",
"properties": {
"scenes": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 4,
"minItems": 1
},
"feedback": {
"type": "string",
"description": "Free-text direction for the new takes, e.g. 'daytime, more natural, less posed'."
},
"post_text": {
"type": "string",
"description": "Infer the scene from a post when scenes is omitted."
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Request Likeness Scenes",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Designing in the background: picks an approved reference, writes slot copy from the post, places the creator's real photo and official app logos, proofreads, and leaves a draft for review. Memes: pass template "meme" and/or a meme library reference_id (bamf.list_design_references, category meme_template) to make a meme with Claude: only the template picture with the post's captions in its slots, no headline, footer, logo or CTA; needs post_id. mode "custom" (with likeness and style) makes a unique scene inspired by that meme's joke structure instead. Poll bamf.get_design. Never schedules or publishes. Costs credits.
| Parameter | Type | Description |
|---|---|---|
| qa | boolean | Mark as a QA run so the draft stays out of the review queue. |
| mode | string | Meme only. template (default): the real template picture with captions. custom: a uniquely made scene inspired by the meme's joke structure (reference_id, or one BAMF picks that fits the post and was not used recently). |
| style | string | Custom meme only: the design style for the scene, e.g. 'pixar 3d', 'claymation', 'film still'. |
| post_id | string | Post to design. Provide post_id or source_post_id. |
| captions | array | Meme only: ordered panel captions used verbatim in the panel slots. Omit to caption from the post text. |
| likeness | boolean | Meme only: put the creator's real likeness in the scene, generated from approved likeness photos (never a pasted cutout or avatar). |
| template | string | one of ["tweet_card_dark","tweet_card_light","chart_post","stats_over_photo","app_icon_grid","highlighted_quote","model_base","meme"] |
Animate the post's current Claude design (same path as Animate with Claude in the editor) with a motion prompt. Returns a job; the MP4 is saved as a new video version on the post. Poll bamf.get_design. Never schedules or publishes. Costs credits.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string | |
| instruction * | string | The motion to add, e.g. a cursor moving to click the checkbox. Keep the design as is. |
{
"name": "bamf.animate_design",
"description": "Animate the post's current Claude design (same path as Animate with Claude in the editor) with a motion prompt. Returns a job; the MP4 is saved as a new video version on the post. Poll bamf.get_design. Never schedules or publishes. Costs credits.",
"inputSchema": {
"type": "object",
"required": [
"post_id",
"instruction"
],
"properties": {
"post_id": {
"type": "string"
},
"instruction": {
"type": "string",
"description": "The motion to add, e.g. a cursor moving to click the checkbox. Keep the design as is."
}
}
},
"annotations": {
"title": "Animate Design",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Read a design's status, image, matched reference, template and layers (likeness, art, text). Poll after bamf.design_post. Read-only.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string |
{
"name": "bamf.get_design",
"description": "Read a design's status, image, matched reference, template and layers (likeness, art, text). Poll after bamf.design_post. Read-only.",
"inputSchema": {
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Get Design",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Swap one layer of a layer-built design without changing the rest: likeness + photo_id (an accepted photo from bamf.list_likeness_photos; a pending AI photo is used but flagged), likeness + new_candid (requests new candid photos, pending), art (new art for the art layer only), or text + slots (rerender, no model call). Claude HTML designs (Made with Claude) have no layers: this returns claude_design_use_edit; change them with bamf.edit_post_image.
| Parameter | Type | Description |
|---|---|---|
| layer * | string | one of ["likeness","art","text"] |
| slots | object | Text slot values to rerender. |
| prompt | string | Direction for new art. |
| post_id * | string | |
| photo_id | string | |
| new_candid | string | Describe the candid photo to request. |
{
"name": "bamf.replace_design_layer",
"description": "Swap one layer of a layer-built design without changing the rest: likeness + photo_id (an accepted photo from bamf.list_likeness_photos; a pending AI photo is used but flagged), likeness + new_candid (requests new candid photos, pending), art (new art for the art layer only), or text + slots (rerender, no model call). Claude HTML designs (Made with Claude) have no layers: this returns claude_design_use_edit; change them with bamf.edit_post_image.",
"inputSchema": {
"type": "object",
"required": [
"post_id",
"layer"
],
"properties": {
"layer": {
"enum": [
"likeness",
"art",
"text"
],
"type": "string"
},
"slots": {
"type": "object",
"description": "Text slot values to rerender."
},
"prompt": {
"type": "string",
"description": "Direction for new art."
},
"post_id": {
"type": "string"
},
"photo_id": {
"type": "string"
},
"new_candid": {
"type": "string",
"description": "Describe the candid photo to request."
}
}
},
"annotations": {
"title": "Replace Design Layer",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Make one version of a layer-built design current (revert to an earlier version or promote a candidate). The post's image follows it. New versions only become current when they beat the current one; this is how you go back. List versions with bamf.get_design.
| Parameter | Type | Description |
|---|---|---|
| reason | string | |
| post_id * | string | |
| version_id * | string | A version id from bamf.get_design versions. |
{
"name": "bamf.set_design_version",
"description": "Make one version of a layer-built design current (revert to an earlier version or promote a candidate). The post's image follows it. New versions only become current when they beat the current one; this is how you go back. List versions with bamf.get_design.",
"inputSchema": {
"type": "object",
"required": [
"post_id",
"version_id"
],
"properties": {
"reason": {
"type": "string"
},
"post_id": {
"type": "string"
},
"version_id": {
"type": "string",
"description": "A version id from bamf.get_design versions."
}
}
},
"annotations": {
"title": "Set Design Version",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Save a design you made in Claude (desktop, Claude Code, the BAMF plugin) onto a post together with its HTML source, so it can be edited and animated with Claude inside BAMF. Upload a bamf-design-source/v1 zip as base64: index.html (one image) or slide-01.html, slide-02.html... (carousel), every local file under assets/, and manifest.json {format:"bamf-design-source/v1", made_with:"claude_code", entries, width, height, scale}. BAMF stores it privately, renders it at width x height x scale and adds it as a new version marked Made with Claude and for review. Max 12 MB. Never schedules or publishes. Poll bamf.get_design.
| Parameter | Type | Description |
|---|---|---|
| note | string | Optional one-line change note shown with the version. |
| post_id * | string | |
| bundle_base64 * | string | Base64 of the bamf-design-source/v1 zip. |
{
"name": "bamf.save_design_source",
"description": "Save a design you made in Claude (desktop, Claude Code, the BAMF plugin) onto a post together with its HTML source, so it can be edited and animated with Claude inside BAMF. Upload a bamf-design-source/v1 zip as base64: index.html (one image) or slide-01.html, slide-02.html... (carousel), every local file under assets/, and manifest.json {format:\"bamf-design-source/v1\", made_with:\"claude_code\", entries, width, height, scale}. BAMF stores it privately, renders it at width x height x scale and adds it as a new version marked Made with Claude and for review. Max 12 MB. Never schedules or publishes. Poll bamf.get_design.",
"inputSchema": {
"type": "object",
"required": [
"post_id",
"bundle_base64"
],
"properties": {
"note": {
"type": "string",
"description": "Optional one-line change note shown with the version."
},
"post_id": {
"type": "string"
},
"bundle_base64": {
"type": "string",
"description": "Base64 of the bamf-design-source/v1 zip."
}
}
},
"annotations": {
"title": "Save Design With Source",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}List a creator's brand fonts with family, role (heading, body, handwriting, accent, mono), usage and whether a font file is stored. Font files are private and never returned. Read-only.
| Parameter | Type | Description |
|---|---|---|
| author_id * | string |
{
"name": "bamf.list_brand_fonts",
"description": "List a creator's brand fonts with family, role (heading, body, handwriting, accent, mono), usage and whether a font file is stored. Font files are private and never returned. Read-only.",
"inputSchema": {
"type": "object",
"required": [
"author_id"
],
"properties": {
"author_id": {
"type": "string"
}
}
},
"annotations": {
"title": "List Brand Fonts",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Add a font file to a creator's brand fonts. When a design uses a font the creator has, upload it here and use it by name; never substitute a look-alike and never ask about licences. Upload each weight/style file of a family; they are stored as faces of one family. Accepts an HTTPS url or file_base64. Font files are stored privately and are never public. Pass replace with an existing family name to overwrite the whole family.
| Parameter | Type | Description |
|---|---|---|
| url | string | HTTPS URL of the font file. Provide url or file_base64. |
| note | string | |
| role * | string | one of ["heading","body","handwriting","accent","mono"] |
| usage | string | |
| family | string | Font family name; read from the file when omitted. |
| replace | string | Existing family name to replace (keeps its role and usage unless given). |
| author_id * | string | |
| file_base64 | string | Base64 font file bytes. Provide url or file_base64. |
| license_confirmed | boolean | Deprecated and ignored. |
Change the role, usage or note of an existing brand font by family name. Does not touch the font file.
| Parameter | Type | Description |
|---|---|---|
| note | string | |
| role | string | one of ["heading","body","handwriting","accent","mono"] |
| usage | string | |
| family * | string | |
| author_id * | string |
{
"name": "bamf.set_brand_font_role",
"description": "Change the role, usage or note of an existing brand font by family name. Does not touch the font file.",
"inputSchema": {
"type": "object",
"required": [
"author_id",
"family"
],
"properties": {
"note": {
"type": "string"
},
"role": {
"enum": [
"heading",
"body",
"handwriting",
"accent",
"mono"
],
"type": "string"
},
"usage": {
"type": "string"
},
"family": {
"type": "string"
},
"author_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Set Brand Font Role",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Register an external media URL as a BAMF media asset. API documentation: https://bamf.ai/docs/mcp/overview
| Parameter | Type | Description |
|---|---|---|
| url * | string | |
| creator_id * | string | |
| visual_type | string |
{
"name": "bamf.add_media",
"description": "Register an external media URL as a BAMF media asset. API documentation: https://bamf.ai/docs/mcp/overview",
"inputSchema": {
"type": "object",
"required": [
"creator_id",
"url"
],
"properties": {
"url": {
"type": "string"
},
"creator_id": {
"type": "string"
},
"visual_type": {
"type": "string"
}
}
},
"annotations": {
"title": "Add Media",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Create a Media Library folder for a creator space after user approval.
| Parameter | Type | Description |
|---|---|---|
| name * | string | |
| creator_id * | string | |
| workspace_id | string |
{
"name": "bamf.create_media_folder",
"description": "Create a Media Library folder for a creator space after user approval.",
"inputSchema": {
"type": "object",
"required": [
"creator_id",
"name"
],
"properties": {
"name": {
"type": "string"
},
"creator_id": {
"type": "string"
},
"workspace_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Create Media Folder",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Move selected media assets into a Media Library folder, or clear the folder with folder_id null.
| Parameter | Type | Description |
|---|---|---|
| item_ids * | array | |
| folder_id | ["string","null"] |
{
"name": "bamf.move_media_items",
"description": "Move selected media assets into a Media Library folder, or clear the folder with folder_id null.",
"inputSchema": {
"type": "object",
"required": [
"item_ids"
],
"properties": {
"item_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"folder_id": {
"type": [
"string",
"null"
]
}
}
},
"annotations": {
"title": "Move Media Items",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| n | number | |
| size | string | |
| engine | string | claude_design: Claude designs the visual as SVG with the creator's brand kit (real logo, colors, fonts) and BAMF renders a platform-sized PNG. Uses BAMF credits. Formats: image_quote, infographic, carousel slide. |
| format | string | With engine=claude_design. motion_infographic returns an animated infographic: poster PNG plus GIF and MP4 (gif_url, mp4_url on bamf.get_job), rendered by the same motion pipeline as the BAMF app. |
| prompt * | string | Asset brief. For visual_type=image_quote, describe the post takeaway and ask for one original, repostable quote-card thought; do not ask the user to supply a quote when post context is available. |
| post_id |
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.
| Parameter | Type | Description |
|---|---|---|
| size | string | |
| title | string | |
| slides * | array | |
| post_id | string | Optional draft/scheduled post to attach the generated PDF to. |
| quality | string | one of ["low","medium","high","auto"] |
| style_id | string | Style the user picked from bamf.list_style_options. Resolved to its reference image and layout notes server side; the brand kit still applies. |
| creator_id * | string | |
| source_urls | array |
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.
| Parameter | Type | Description |
|---|---|---|
| prompt * | string | |
| duration | number | one of [5,10] |
| style_id | string | Style the user picked from bamf.list_style_options. Resolved to its reference image and layout notes server side; the brand kit still applies. |
| image_url | string | Optional HTTPS start frame. When present, BAMF uses Seedance 2.5 image-to-video instead of text-to-video. |
| creator_id * | string | |
| resolution | string | one of ["480p","720p","1080p"] |
| aspect_ratio | string | one of ["16:9","9:16","1:1"] |
| generate_audio | boolean | |
| reference_bindings | array |
Convert existing slide image URLs into a LinkedIn-ready carousel PDF and optionally attach it to a post.
| Parameter | Type | Description |
|---|---|---|
| title | string | |
| post_id | string | Optional draft/scheduled post to attach the generated PDF to. |
| creator_id * | string | |
| slide_image_urls * | array |
{
"name": "bamf.generate_carousel_pdf",
"description": "Convert existing slide image URLs into a LinkedIn-ready carousel PDF and optionally attach it to a post.",
"inputSchema": {
"type": "object",
"required": [
"creator_id",
"slide_image_urls"
],
"properties": {
"title": {
"type": "string"
},
"post_id": {
"type": "string",
"description": "Optional draft/scheduled post to attach the generated PDF to."
},
"creator_id": {
"type": "string"
},
"slide_image_urls": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"annotations": {
"title": "Generate Carousel PDF",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| workspace_id * | string |
{
"name": "bamf.list_saved_people_lists",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"workspace_id"
],
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "List Saved People Lists",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer | |
| list_id * | string | |
| member_kind * | string | one of ["master_contacts","crm_leads"] |
| workspace_id * | string |
{
"name": "bamf.read_saved_people_list",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"workspace_id",
"list_id",
"member_kind"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1
},
"offset": {
"type": "integer",
"maximum": 10000,
"minimum": 0
},
"list_id": {
"type": "string",
"format": "uuid"
},
"member_kind": {
"enum": [
"master_contacts",
"crm_leads"
],
"type": "string"
},
"workspace_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Read Saved People List",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| params | object | |
| workspace_id * | string |
{
"name": "bamf.query_people",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"workspace_id"
],
"properties": {
"params": {
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 120,
"minimum": 1
},
"sort": {
"enum": [
"score",
"recent",
"icp"
],
"type": "string"
},
"tags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"maxItems": 25
},
"text": {
"type": "string",
"maxLength": 160
},
"lanes": {
"type": "array",
"items": {
"enum": [
"opportunity",
"prospect",
"pr_lead",
"pr_prospect",
"investor",
"community",
"vendor"
],
"type": "string"
},
"maxItems": 7
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1
},
"stages": {
"type": "array",
"items": {
"enum": [
"network",
"contact_added",
"contacted",
"connected",
"warm_reply",
"in_conversation",
"meeting_booked",
"meeting_held",
"won_closed"
],
"type": "string"
},
"maxItems": 9
},
"min_icp": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"needs_reply": {
"type": "boolean"
},
"temperature": {
"type": "array",
"items": {
"enum": [
"hot",
"warm",
"cold"
],
"type": "string"
},
"maxItems": 3
},
"channels_min": {
"type": "integer",
"maximum": 7,
"minimum": 1
},
"signal_classes": {
"type": "array",
"items": {
"enum": [
"connection.accepted",
"inbox.inbound",
"inbox.outbound",
"dm.inbound",
"dm.outbound",
"post.comment",
"post.reaction",
"email.opened",
"email.clicked",
"giveaway.claimed",
"x.comment",
"proposal.approved",
"stage.changed",
"funnel.submitted",
"positive.intent"
],
"type": "string"
},
"maxItems": 15
}
},
"additionalProperties": false
},
"workspace_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Query People",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| params | object | |
| workspace_id * | string |
{
"name": "bamf.search_crm_leads",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"workspace_id"
],
"properties": {
"params": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"offset": {
"type": "integer",
"maximum": 10000,
"minimum": 0
},
"search": {
"type": "string",
"maxLength": 160
},
"saudi_only": {
"type": "boolean"
},
"campaign_id": {
"type": "string",
"format": "uuid"
},
"campaign_scope": {
"enum": [
"new",
"in_campaign",
"all"
],
"type": "string"
},
"strong_icp_only": {
"type": "boolean"
},
"connection_scope": {
"enum": [
"first_degree",
"pending_invite",
"not_connected",
"all"
],
"type": "string"
},
"accepted_no_reply": {
"type": "boolean"
}
},
"additionalProperties": false
},
"workspace_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search CRM Leads",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Start a tenant- and principal-scoped, provider-read-only outreach discovery session. This discovers candidates only; it never creates or sends a campaign.
| Parameter | Type | Description |
|---|---|---|
| provider * | string | |
| targeting * | string | |
| session_id * | string | |
| source_mode * | string | one of ["external","crm","first_degree"] |
| workspace_id * | string | |
| gateway_run_id * | string | |
| idempotency_key * | string | |
| search_criteria | object | |
| provider_account_id * | string | |
| capability_receipt_ref * | string |
Resume a scoped outreach discovery session from server-owned coverage. Caller-supplied provider cursors or organization IDs are not accepted as authority.
| Parameter | Type | Description |
|---|---|---|
| provider * | string | |
| targeting * | string | |
| session_id * | string | |
| source_mode * | string | one of ["external","crm","first_degree"] |
| workspace_id * | string | |
| gateway_run_id * | string | |
| idempotency_key * | string | |
| provider_account_id * | string | |
| discovery_session_id * | string | |
| capability_receipt_ref * |
Read the status of one tenant- and principal-scoped outreach discovery session. This never mutates a provider.
| Parameter | Type | Description |
|---|---|---|
| provider * | string | |
| session_id * | string | |
| workspace_id * | string | |
| gateway_run_id * | string | |
| provider_account_id * | string | |
| discovery_session_id * | string | |
| capability_receipt_ref * | string | |
| principal_context_ref_id * | string |
{
"name": "bamf.get_outreach_discovery_status",
"description": "Read the status of one tenant- and principal-scoped outreach discovery session. This never mutates a provider.",
"inputSchema": {
"type": "object",
"required": [
"discovery_session_id",
"workspace_id",
"session_id",
"principal_context_ref_id",
"gateway_run_id",
"provider",
"provider_account_id",
"capability_receipt_ref"
],
"properties": {
"provider": {
"type": "string"
},
"session_id": {
"type": "string",
"format": "uuid"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"gateway_run_id": {
"type": "string",
"format": "uuid"
},
"provider_account_id": {
"type": "string"
},
"discovery_session_id": {
"type": "string",
"format": "uuid"
},
"capability_receipt_ref": {
"type": "string"
},
"principal_context_ref_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Outreach Discovery Status",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Request cancellation of one scoped outreach discovery session. This cancels discovery only and never mutates a provider campaign.
| Parameter | Type | Description |
|---|---|---|
| provider * | string | |
| session_id * | string | |
| workspace_id * | string | |
| gateway_run_id * | string | |
| idempotency_key * | string | |
| provider_account_id * | string | |
| discovery_session_id * | string | |
| capability_receipt_ref * | string | |
| principal_context_ref_id * | string |
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.
| Parameter | Type | Description |
|---|---|---|
| provider * | string | |
| session_id * | string | |
| workspace_id * | string | |
| gateway_run_id * | string | |
| idempotency_key * | string | |
| provider_account_id * | string | |
| discovery_session_id * | string | |
| capability_receipt_ref * | string | |
| principal_context_ref_id * | string |
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.
| Parameter | Type | Description |
|---|---|---|
| plan | object | |
| binding | object | |
| session_id | string | |
| workspace_id * | string | |
| idempotency_key * | string | |
| native_saved_list | object | |
| principal_context_ref_id | string |
{
"name": "bamf.prepare_outreach_campaign",
"description": "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.",
"inputSchema": {
"type": "object",
"oneOf": [
{
"not": {
"required": [
"native_saved_list"
]
},
"required": [
"session_id",
"principal_context_ref_id",
"binding",
"plan"
]
},
{
"not": {
"anyOf": [
{
"required": [
"session_id"
]
},
{
"required": [
"principal_context_ref_id"
]
},
{
"required": [
"binding"
]
},
{
"required": [
"plan"
]
}
]
},
"required": [
"native_saved_list"
],
"properties": {
"idempotency_key": {
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{7,159}$",
"maxLength": 160
}
}
}
],
"required": [
"workspace_id",
"idempotency_key"
],
"properties": {
"plan": {
"type": "object",
"required": [
"copy",
"cadence",
"timezone"
],
"properties": {
"copy": {
"type": "array",
"items": {
"type": "object",
"required": [
"step",
"body"
],
"properties": {
"body": {
"type": "string",
"minLength": 1
},
"step": {
"type": "integer",
"minimum": 1
},
"subject": {
"type": "string"
}
},
"additionalProperties": false
},
"minItems": 1
},
"cadence": {
"type": "array",
"items": {
"type": "object",
"required": [
"step",
"delayMinutes"
],
"properties": {
"step": {
"type": "integer",
"minimum": 1
},
"delayMinutes": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"minItems": 1
},
"timezone": {
"type": "string",
"minLength": 1
},
"booking_ref": {
"type": [
"string",
"null"
]
},
"resource_refs": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"binding": {
"type": "object",
"required": [
"search_list_id",
"snapshot_id",
"list_version",
"connector_provider",
"connector_account_id",
"channel"
],
"properties": {
"channel": {
"enum": [
"linkedin",
"gmail",
"x",
"instagram"
],
"type": "string"
},
"snapshot_id": {
"type": "string",
"format": "uuid"
},
"list_version": {
"type": "integer",
"minimum": 1
},
"search_list_id": {
"type": "string",
"format": "uuid"
},
"connector_provider": {
"type": "string"
},
"connector_account_id": {
"type": "string"
}
},
"additionalProperties": false
},
"session_id": {
"type": "string",
"format": "uuid"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"idempotency_key": {
"type": "string",
"maxLength": 240,
"minLength": 8
},
"native_saved_list": {
"type": "object",
"oneOf": [
{
"properties": {
"member_kind": {
"const": "master_contacts"
}
}
},
{
"not": {
"required": [
"existing_lead_list_id"
]
},
"properties": {
"member_kind": {
"const": "crm_leads"
}
}
}
],
"required": [
"id",
"member_kind"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"member_kind": {
"enum": [
"master_contacts",
"crm_leads"
],
"type": "string"
},
"existing_lead_list_id": {
"type": "string",
"format": "uuid",
"description": "Optional owned CRM lead list combined with a master-contact list into one native audience; unsupported for crm_leads."
}
},
"additionalProperties": false
},
"principal_context_ref_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Prepare Outreach Campaign",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Approve the exact prepared campaign fingerprint until an explicit expiry. Approval alone never queues or sends.
| Parameter | Type | Description |
|---|---|---|
| session_id * | string | |
| campaign_id * | string | |
| approval_ref * | string | |
| workspace_id * | string | |
| idempotency_key * | string | |
| action_fingerprint * | string | |
| approval_expires_at * | string | |
| principal_context_ref_id * | string |
{
"name": "bamf.approve_outreach_campaign",
"description": "Approve the exact prepared campaign fingerprint until an explicit expiry. Approval alone never queues or sends.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id",
"workspace_id",
"session_id",
"principal_context_ref_id",
"approval_ref",
"action_fingerprint",
"approval_expires_at",
"idempotency_key"
],
"properties": {
"session_id": {
"type": "string",
"format": "uuid"
},
"campaign_id": {
"type": "string",
"format": "uuid"
},
"approval_ref": {
"type": "string"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"idempotency_key": {
"type": "string",
"maxLength": 240,
"minLength": 8
},
"action_fingerprint": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"approval_expires_at": {
"type": "string",
"format": "date-time"
},
"principal_context_ref_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Approve Outreach Campaign",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Queue an approved exact campaign after its list, connector, fingerprint, and approval remain current. This state transition does not send.
| Parameter | Type | Description |
|---|---|---|
| session_id * | string | |
| campaign_id * | string | |
| workspace_id * | string | |
| idempotency_key * | string | |
| principal_context_ref_id * | string |
{
"name": "bamf.queue_outreach_campaign",
"description": "Queue an approved exact campaign after its list, connector, fingerprint, and approval remain current. This state transition does not send.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id",
"workspace_id",
"session_id",
"principal_context_ref_id",
"idempotency_key"
],
"properties": {
"session_id": {
"type": "string",
"format": "uuid"
},
"campaign_id": {
"type": "string",
"format": "uuid"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"idempotency_key": {
"type": "string",
"maxLength": 240,
"minLength": 8
},
"principal_context_ref_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Queue Outreach Campaign",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Cancel a prepared, approved, or queued campaign without invoking a provider.
| Parameter | Type | Description |
|---|---|---|
| session_id * | string | |
| campaign_id * | string | |
| workspace_id * | string | |
| idempotency_key * | string | |
| principal_context_ref_id * | string |
{
"name": "bamf.cancel_outreach_campaign",
"description": "Cancel a prepared, approved, or queued campaign without invoking a provider.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id",
"workspace_id",
"session_id",
"principal_context_ref_id",
"idempotency_key"
],
"properties": {
"session_id": {
"type": "string",
"format": "uuid"
},
"campaign_id": {
"type": "string",
"format": "uuid"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"idempotency_key": {
"type": "string",
"maxLength": 240,
"minLength": 8
},
"principal_context_ref_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cancel Outreach Campaign",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| session_id * | string | |
| campaign_id * | string | |
| workspace_id * | string | |
| principal_context_ref_id * | string |
{
"name": "bamf.get_outreach_campaign_status",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id",
"workspace_id",
"session_id",
"principal_context_ref_id"
],
"properties": {
"session_id": {
"type": "string",
"format": "uuid"
},
"campaign_id": {
"type": "string",
"format": "uuid"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"principal_context_ref_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Outreach Campaign Status",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| session_id * | string | |
| campaign_id * | string | |
| workspace_id * | string | |
| idempotency_key * | string | |
| action_fingerprint * | string | |
| principal_context_ref_id * | string |
{
"name": "bamf.admit_outreach_campaign_execution",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id",
"workspace_id",
"session_id",
"principal_context_ref_id",
"action_fingerprint",
"idempotency_key"
],
"properties": {
"session_id": {
"type": "string",
"format": "uuid"
},
"campaign_id": {
"type": "string",
"format": "uuid"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"idempotency_key": {
"type": "string",
"maxLength": 240,
"minLength": 8
},
"action_fingerprint": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"principal_context_ref_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Admit Outreach Campaign Execution",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| intent * | object | |
| workspace_id * | string | |
| idempotency_key * | string |
{
"name": "bamf.prepare_exact_thread_reply",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"workspace_id",
"intent",
"idempotency_key"
],
"properties": {
"intent": {
"type": "object",
"required": [
"version",
"account_ref",
"channel",
"action",
"draft_id",
"draft_revision",
"draft_sha256",
"approval_id",
"thread",
"identity"
],
"properties": {
"action": {
"enum": [
"reply",
"follow_up"
],
"type": "string"
},
"thread": {
"type": "object",
"required": [
"provider_thread_id",
"source_message_id",
"provider_receipt_id",
"observed_at"
],
"properties": {
"observed_at": {
"type": "string",
"format": "date-time"
},
"source_message_id": {
"type": "string"
},
"provider_thread_id": {
"type": "string"
},
"provider_receipt_id": {
"type": "string"
}
},
"additionalProperties": false
},
"channel": {
"enum": [
"linkedin",
"gmail",
"x",
"instagram"
],
"type": "string"
},
"version": {
"type": "string",
"const": "exact-thread-reply/v1"
},
"draft_id": {
"type": "string"
},
"identity": {
"type": "object",
"required": [
"evidence_id",
"subject_id",
"linkedin_profile_url",
"gmail_address",
"observed_at",
"expires_at"
],
"properties": {
"expires_at": {
"type": "string",
"format": "date-time"
},
"subject_id": {
"type": "string"
},
"evidence_id": {
"type": "string"
},
"observed_at": {
"type": "string",
"format": "date-time"
},
"gmail_address": {
"type": [
"string",
"null"
]
},
"linkedin_profile_url": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"account_ref": {
"type": "string",
"maxLength": 512,
"minLength": 3
},
"approval_id": {
"type": "string"
},
"draft_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"draft_revision": {
"type": "integer",
"minimum": 1
}
},
"additionalProperties": false
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"idempotency_key": {
"type": "string",
"maxLength": 240,
"minLength": 8
}
},
"additionalProperties": false
},
"annotations": {
"title": "Prepare Exact-Thread Reply",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| approval * | object | |
| delivery * | object | |
| artifacts * | array | |
| recipient * | object | |
| tenant_id * | string | |
| eligibility * | object | |
| suppression * | object | |
| workspace_id * | string | |
| schema_version * | integer | |
| idempotency_key * | string |
List recent BAMF async jobs for a creator space.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| status | string | |
| job_type | string | |
| creator_id | string |
{
"name": "bamf.list_jobs",
"description": "List recent BAMF async jobs for a creator space.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 20
},
"status": {
"type": "string"
},
"job_type": {
"type": "string"
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "List Jobs",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read one BAMF async job status and output.
| Parameter | Type | Description |
|---|---|---|
| job_id * | string |
{
"name": "bamf.get_job",
"description": "Read one BAMF async job status and output.",
"inputSchema": {
"type": "object",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Get Job",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| run_id * | string | |
| after_sequence | integer |
{
"name": "bamf.get_run_status",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"run_id"
],
"properties": {
"run_id": {
"type": "string"
},
"after_sequence": {
"type": "integer",
"minimum": -1
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get run status",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Cancel a queued or running BAMF async job.
| Parameter | Type | Description |
|---|---|---|
| job_id * | string |
{
"name": "bamf.cancel_job",
"description": "Cancel a queued or running BAMF async job.",
"inputSchema": {
"type": "object",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Cancel Job",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Get LinkedIn Late-authoritative analytics totals for a creator space. Pass platform=x or use bamf.get_x_analytics_summary for X metrics.
| Parameter | Type | Description |
|---|---|---|
| platform | string | one of ["linkedin","x","twitter"] |
| creator_id | string |
{
"name": "bamf.get_analytics_summary",
"description": "Get LinkedIn Late-authoritative analytics totals for a creator space. Pass platform=x or use bamf.get_x_analytics_summary for X metrics.",
"inputSchema": {
"type": "object",
"properties": {
"platform": {
"enum": [
"linkedin",
"x",
"twitter"
],
"type": "string",
"default": "linkedin"
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Get Analytics Summary",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Inclusive lookback window in days. |
{
"name": "bamf.get_creator_analytics_report",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"days": {
"type": "integer",
"default": 90,
"maximum": 365,
"minimum": 1,
"description": "Inclusive lookback window in days."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Creator Analytics Report",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| days | number | Lookback window in days (1-730). |
| creator_id | string |
{
"name": "bamf.get_funnel_mix",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"days": {
"type": "number",
"default": 90,
"description": "Lookback window in days (1-730)."
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Get Funnel Mix",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Find top AI-tagged example posts for a funnel stage (and optional format) to model a draft on: inspiration library (by likes), or post templates; the creator's own posts are topics and proof only, never a style reference. Returns excerpt, stage, format, media type, and metrics. Read-only.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| stage * | string | one of ["tof","mof","bof"] |
| format | string | Optional taxonomy format id, e.g. case_study, framework, hot_take. |
| source | string | one of ["inspiration","templates","own"] |
| creator_id | string | Required for source=own when the key can access several creators. |
{
"name": "bamf.find_funnel_examples",
"description": "Find top AI-tagged example posts for a funnel stage (and optional format) to model a draft on: inspiration library (by likes), or post templates; the creator's own posts are topics and proof only, never a style reference. Returns excerpt, stage, format, media type, and metrics. Read-only.",
"inputSchema": {
"type": "object",
"required": [
"stage"
],
"properties": {
"limit": {
"type": "number",
"default": 10,
"maximum": 20
},
"stage": {
"enum": [
"tof",
"mof",
"bof"
],
"type": "string"
},
"format": {
"type": "string",
"description": "Optional taxonomy format id, e.g. case_study, framework, hot_take."
},
"source": {
"enum": [
"inspiration",
"templates",
"own"
],
"type": "string",
"default": "inspiration"
},
"creator_id": {
"type": "string",
"description": "Required for source=own when the key can access several creators."
}
}
},
"annotations": {
"title": "Find Funnel Examples",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| q | string | Optional text to match in headline, copy, or advertiser name. |
| limit | number | |
| platform | string | one of ["meta","linkedin","tiktok"] |
| creator_id | string | Required when the key can access several creators. |
{
"name": "bamf.find_competitor_ads",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Optional text to match in headline, copy, or advertiser name."
},
"limit": {
"type": "number",
"default": 10,
"maximum": 25
},
"platform": {
"enum": [
"meta",
"linkedin",
"tiktok"
],
"type": "string"
},
"creator_id": {
"type": "string",
"description": "Required when the key can access several creators."
}
}
},
"annotations": {
"title": "Find Competitor Ads",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| country | string | Two-letter country code, default US. |
| keyword * | string | Topic or seed phrase, e.g. linkedin ghostwriting. |
| creator_id | string | Required when the key can access several creators. |
{
"name": "bamf.suggest_ad_keywords",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"keyword"
],
"properties": {
"country": {
"type": "string",
"description": "Two-letter country code, default US."
},
"keyword": {
"type": "string",
"description": "Topic or seed phrase, e.g. linkedin ghostwriting."
},
"creator_id": {
"type": "string",
"description": "Required when the key can access several creators."
}
}
},
"annotations": {
"title": "Suggest Ad Keywords",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List discovered LinkedIn-native posts for a creator with Late-authoritative official_* performance fields when available.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| creator_id | string |
{
"name": "bamf.list_linkedin_posts",
"description": "List discovered LinkedIn-native posts for a creator with Late-authoritative official_* performance fields when available.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 50
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "List LinkedIn Posts",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Get saved X analytics totals, top posts, and latest follower/profile snapshot for a creator space.
| Parameter | Type | Description |
|---|---|---|
| creator_id | string |
{
"name": "bamf.get_x_analytics_summary",
"description": "Get saved X analytics totals, top posts, and latest follower/profile snapshot for a creator space.",
"inputSchema": {
"type": "object",
"properties": {
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Get X Analytics Summary",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List saved X post analytics rows for a creator, including impressions, likes, replies, reposts, quotes, bookmarks, clicks, engagement rate, and post URLs when available.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| creator_id | string |
{
"name": "bamf.list_x_posts",
"description": "List saved X post analytics rows for a creator, including impressions, likes, replies, reposts, quotes, bookmarks, clicks, engagement rate, and post URLs when available.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 50
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "List X Posts",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| since | string | Only return bookmarks imported at or after this ISO timestamp. |
| search | string | Case-insensitive content filter applied after creator scoping. |
| status | string | one of ["saved","used","ignored","archived"] |
| folder_id | string | Only return bookmarks from this native X folder ID. |
| creator_id | string | |
| folder_name | string | Only return bookmarks from this exact native X folder name. |
{
"name": "bamf.list_x_bookmarks",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 50
},
"since": {
"type": "string",
"description": "Only return bookmarks imported at or after this ISO timestamp."
},
"search": {
"type": "string",
"description": "Case-insensitive content filter applied after creator scoping."
},
"status": {
"enum": [
"saved",
"used",
"ignored",
"archived"
],
"type": "string"
},
"folder_id": {
"type": "string",
"description": "Only return bookmarks from this native X folder ID."
},
"creator_id": {
"type": "string"
},
"folder_name": {
"type": "string",
"description": "Only return bookmarks from this exact native X folder name."
}
}
},
"annotations": {
"title": "List X Bookmarks",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List posts the creator saved or bookmarked on any platform (X bookmarks sync automatically; LinkedIn, Instagram and shared links land here too) with BAMF folders, remix state and draft links. Use for 'what did I save', inspiration review, and picking a post to remix.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| state | string | one of ["inbox","remix_queued","remixing","remixed","remix_failed","archived"] |
| search | string | |
| platform | string | one of ["linkedin","x","instagram","threads","tiktok","youtube","other"] |
| folder_id | string | |
| creator_id | string |
{
"name": "bamf.list_saved_posts",
"description": "List posts the creator saved or bookmarked on any platform (X bookmarks sync automatically; LinkedIn, Instagram and shared links land here too) with BAMF folders, remix state and draft links. Use for 'what did I save', inspiration review, and picking a post to remix.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 50
},
"state": {
"enum": [
"inbox",
"remix_queued",
"remixing",
"remixed",
"remix_failed",
"archived"
],
"type": "string"
},
"search": {
"type": "string"
},
"platform": {
"enum": [
"linkedin",
"x",
"instagram",
"threads",
"tiktok",
"youtube",
"other"
],
"type": "string"
},
"folder_id": {
"type": "string"
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "List Saved Posts",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Save a social post to the creator's BAMF saved-posts inbox from a post URL and/or a screenshot URL. Use when the user says 'save this post' or shares a post. Set remix=true (or include 'remix this' in text) to also start a remix: the creator's own idea plus a BAMF house template, using the saved post for structure only. Never schedules or publishes.
| Parameter | Type | Description |
|---|---|---|
| url | string | Post URL (LinkedIn, X, Instagram, Threads, TikTok, YouTube). |
| idea | string | The creator's own angle for the remix. |
| text | string | The user's message, used for URL and intent detection. |
| remix | boolean | |
| folder_id | string | |
| creator_id | string | |
| screenshot_url | string | Hosted screenshot of the post when there is no URL. |
| notify_on_ready | boolean |
{
"name": "bamf.save_post",
"description": "Save a social post to the creator's BAMF saved-posts inbox from a post URL and/or a screenshot URL. Use when the user says 'save this post' or shares a post. Set remix=true (or include 'remix this' in text) to also start a remix: the creator's own idea plus a BAMF house template, using the saved post for structure only. Never schedules or publishes.",
"inputSchema": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Post URL (LinkedIn, X, Instagram, Threads, TikTok, YouTube)."
},
"idea": {
"type": "string",
"description": "The creator's own angle for the remix."
},
"text": {
"type": "string",
"description": "The user's message, used for URL and intent detection."
},
"remix": {
"type": "boolean",
"default": false
},
"folder_id": {
"type": "string"
},
"creator_id": {
"type": "string"
},
"screenshot_url": {
"type": "string",
"description": "Hosted screenshot of the post when there is no URL."
},
"notify_on_ready": {
"type": "boolean",
"default": false
}
}
},
"annotations": {
"title": "Save Post",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Move a saved post into a BAMF folder (created by name if missing). Folders work across platforms; moving into an auto-remix folder starts a remix.
| Parameter | Type | Description |
|---|---|---|
| folder_id | string | |
| auto_remix | boolean | When creating a folder: posts landing in it are remixed automatically. |
| folder_name | string | Created if missing. |
| saved_post_id * | string | |
| platform_folder_name | string | When creating a folder: platform folders with this name (e.g. an X bookmark folder) land here. |
{
"name": "bamf.move_to_folder",
"description": "Move a saved post into a BAMF folder (created by name if missing). Folders work across platforms; moving into an auto-remix folder starts a remix.",
"inputSchema": {
"type": "object",
"required": [
"saved_post_id"
],
"properties": {
"folder_id": {
"type": "string"
},
"auto_remix": {
"type": "boolean",
"description": "When creating a folder: posts landing in it are remixed automatically."
},
"folder_name": {
"type": "string",
"description": "Created if missing."
},
"saved_post_id": {
"type": "string"
},
"platform_folder_name": {
"type": "string",
"description": "When creating a folder: platform folders with this name (e.g. an X bookmark folder) land here."
}
}
},
"annotations": {
"title": "Move Saved Post To Folder",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Start a remix of a saved post: an async draft job built from the creator's own idea and a BAMF house template, with the saved post credited as Inspiration and used for structure only (never its wording or images). The draft lands in review; it is never scheduled. Poll bamf.get_job for progress.
| Parameter | Type | Description |
|---|---|---|
| idea | string | The creator's own angle. Recommended. |
| saved_post_id * | string |
{
"name": "bamf.remix_saved_post",
"description": "Start a remix of a saved post: an async draft job built from the creator's own idea and a BAMF house template, with the saved post credited as Inspiration and used for structure only (never its wording or images). The draft lands in review; it is never scheduled. Poll bamf.get_job for progress.",
"inputSchema": {
"type": "object",
"required": [
"saved_post_id"
],
"properties": {
"idea": {
"type": "string",
"description": "The creator's own angle. Recommended."
},
"saved_post_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Remix Saved Post",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| creator_id * | string | |
| native_limit | number | |
| native_pages | number |
{
"name": "bamf.sync_x_analytics",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id"
],
"properties": {
"creator_id": {
"type": "string"
},
"native_limit": {
"type": "number",
"default": 100
},
"native_pages": {
"type": "number",
"default": 3
}
}
},
"annotations": {
"title": "Sync X Analytics",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}List saved AI analysis reports for a creator profile and LinkedIn analytics performance.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| creator_id | string |
{
"name": "bamf.list_ai_analyses",
"description": "List saved AI analysis reports for a creator profile and LinkedIn analytics performance.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 25
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "List AI Analyses",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Create a Video Studio project (viral_repurpose or talking_head) and return the artifact the BAMF work pane opens.
| Parameter | Type | Description |
|---|---|---|
| title | string | |
| caption | string | |
| template | string | one of ["viral_repurpose","talking_head"] |
| creator_id * | string | |
| source_url | string | Public https source video URL. |
| aspect_ratio | string | one of ["4:5","9:16","1:1","16:9"] |
| source_clip_id | string | A saved source_clips row to repurpose. |
| source_asset_id | string |
{
"name": "bamf.create_video_project",
"description": "Create a Video Studio project (viral_repurpose or talking_head) and return the artifact the BAMF work pane opens.",
"inputSchema": {
"type": "object",
"required": [
"creator_id"
],
"properties": {
"title": {
"type": "string"
},
"caption": {
"type": "string"
},
"template": {
"enum": [
"viral_repurpose",
"talking_head"
],
"type": "string"
},
"creator_id": {
"type": "string"
},
"source_url": {
"type": "string",
"description": "Public https source video URL."
},
"aspect_ratio": {
"enum": [
"4:5",
"9:16",
"1:1",
"16:9"
],
"type": "string"
},
"source_clip_id": {
"type": "string",
"description": "A saved source_clips row to repurpose."
},
"source_asset_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Create Video Project",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Read the video script brief for a project, or save the approved script, burned-in caption, and post copy back onto it.
| Parameter | Type | Description |
|---|---|---|
| script | string | |
| caption | string | |
| post_body | string | |
| video_project_id * | string |
{
"name": "bamf.generate_video_script",
"description": "Read the video script brief for a project, or save the approved script, burned-in caption, and post copy back onto it.",
"inputSchema": {
"type": "object",
"required": [
"video_project_id"
],
"properties": {
"script": {
"type": "string"
},
"caption": {
"type": "string"
},
"post_body": {
"type": "string"
},
"video_project_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Generate Video Script",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Narrate a video project with the creator's own ElevenLabs voice. Requires an authenticated BAMF user session.
| Parameter | Type | Description |
|---|---|---|
| text | string | Defaults to the project script. |
| voice_id | string | Defaults to the creator's saved voice. |
| video_project_id * | string |
{
"name": "bamf.narrate_video_project",
"description": "Narrate a video project with the creator's own ElevenLabs voice. Requires an authenticated BAMF user session.",
"inputSchema": {
"type": "object",
"required": [
"video_project_id"
],
"properties": {
"text": {
"type": "string",
"description": "Defaults to the project script."
},
"voice_id": {
"type": "string",
"description": "Defaults to the creator's saved voice."
},
"video_project_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Narrate Video Project",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Produce or persist word-level burned-in captions for a video project via Whisper. Requires an authenticated BAMF user session when transcribing.
| Parameter | Type | Description |
|---|---|---|
| captions | array | Already-timed cues to persist instead of transcribing. |
| video_project_id * | string |
{
"name": "bamf.transcribe_video_captions",
"description": "Produce or persist word-level burned-in captions for a video project via Whisper. Requires an authenticated BAMF user session when transcribing.",
"inputSchema": {
"type": "object",
"required": [
"video_project_id"
],
"properties": {
"captions": {
"type": "array",
"items": {
"type": "object"
},
"description": "Already-timed cues to persist instead of transcribing."
},
"video_project_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Transcribe Video Captions",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| title | string | YouTube title. |
| content * | string | |
| approved * | boolean | Must be true: the user approved this exact plan. |
| timezone | string | |
| platforms * | array | |
| video_url | string | Defaults to the project's exported output. |
| publish_now | boolean | |
| scheduled_for | string | Future ISO 8601 timestamp. |
| thumbnail_url | string | |
| idempotency_key | string | |
| video_project_id * | string |
Read the video analytics rollup (Reels/Shorts/TikTok views, watch-through, saves) that sync-video-analytics maintains.
| Parameter | Type | Description |
|---|---|---|
| platforms | string | Comma-separated platform filter. |
| creator_id | string |
{
"name": "bamf.get_video_analytics_summary",
"description": "Read the video analytics rollup (Reels/Shorts/TikTok views, watch-through, saves) that sync-video-analytics maintains.",
"inputSchema": {
"type": "object",
"properties": {
"platforms": {
"type": "string",
"description": "Comma-separated platform filter."
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Get Video Analytics Summary",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Create an async BAMF generation/research job. Prefer typed tools such as generate_post, run_research, generate_image, and generate_carousel_pdf.
| Parameter | Type | Description |
|---|---|---|
| input | object | |
| job_type * | string | one of ["post.generate","post.edit","image.generate","carousel.generate","carousel.pdf","brand_kit.generate","research.run","knowledge.process","analytics.sync"] |
| creator_id * | string |
{
"name": "bamf.create_job",
"description": "Create an async BAMF generation/research job. Prefer typed tools such as generate_post, run_research, generate_image, and generate_carousel_pdf.",
"inputSchema": {
"type": "object",
"required": [
"creator_id",
"job_type"
],
"properties": {
"input": {
"type": "object"
},
"job_type": {
"enum": [
"post.generate",
"post.edit",
"image.generate",
"carousel.generate",
"carousel.pdf",
"brand_kit.generate",
"research.run",
"knowledge.process",
"analytics.sync"
],
"type": "string"
},
"creator_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Create Job",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
| article_title |
| string |
| first_comment | string |
| uploaded_image_url | string |
| generated_image_url | string |
{
"name": "bamf.create_post_draft",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id",
"content"
],
"properties": {
"topic": {
"type": "string"
},
"content": {
"type": "string"
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"type"
],
"properties": {
"id": {
"type": "string",
"description": "Library artifact or research-run id."
},
"url": {
"type": "string"
},
"type": {
"enum": [
"browser-research",
"artifact",
"session",
"url"
],
"type": "string"
},
"title": {
"type": "string",
"description": "Label shown in post review, e.g. the artifact title."
},
"session_id": {
"type": "string",
"description": "Agent session that produced the source."
},
"captured_at": {
"type": "string",
"description": "ISO8601 timestamp the source was captured."
}
}
},
"description": "Optional provenance for the draft: where this post idea came from (a research artifact, the agent session that produced it, or a URL). Shown in post review."
},
"platform": {
"enum": [
"linkedin",
"li",
"x",
"twitter",
"instagram",
"ig",
"threads",
"tiktok",
"youtube",
"facebook",
"LinkedIn",
"X",
"Twitter",
"Instagram",
"Threads",
"TikTok",
"YouTube",
"Facebook"
],
"type": "string",
"default": "linkedin",
"description": "Case-insensitive; aliases li, x/twitter, ig accepted. Stored as LinkedIn, Twitter, Instagram, Threads, TikTok, YouTube or Facebook."
},
"post_type": {
"enum": [
"text",
"image",
"carousel",
"video",
"article"
],
"type": "string"
},
"video_url": {
"type": "string"
},
"creator_id": {
"type": "string"
},
"article_url": {
"type": "string"
},
"funnel_plan": {
"type": "object",
"required": [
"stage"
],
"properties": {
"stage": {
"enum": [
"tof",
"mof",
"bof"
],
"type": "string"
},
"format": {
"type": "string",
"description": "Taxonomy format id, e.g. case_study."
},
"planned_date": {
"type": "string",
"description": "YYYY-MM-DD slot date."
}
},
"description": "Optional funnel intent from a funnel plan (bamf.get_funnel_mix). Stored as generation_metadata.funnel_plan."
},
"document_url": {
"type": "string",
"description": "LinkedIn carousel/document PDF URL."
},
"article_title": {
"type": "string"
},
"first_comment": {
"type": "string"
},
"uploaded_image_url": {
"type": "string"
},
"generated_image_url": {
"type": "string"
}
}
},
"annotations": {
"title": "Create Post Draft",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}| array |
| Specific facts, benchmarks, claims, or questions the draft should verify or use. |
| research_notes | string | Concise source-backed findings from web research, or saved research. |
| research_policy | string | auto runs current research when the brief has fresh-data/news/benchmark signals; required forces it; off disables it. |
| interview_policy | string | auto asks mini-interview questions when authentic creator POV is missing. |
| template_category | string | Optional category hint. BAMF still matches multiple templates by semantic, lexical, style, performance, recency, and diversity signals. |
| include_first_comment | boolean |
| mini_interview_answers | object | Creator answers keyed by question or topic. Use for real stories, opinions, proof, and voice. |
| use_template_inspiration | boolean |
{
"name": "bamf.generate_post",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id",
"brief"
],
"properties": {
"tone": {
"type": "string"
},
"brief": {
"type": "string"
},
"topic": {
"type": "string"
},
"platform": {
"enum": [
"linkedin",
"x",
"twitter"
],
"type": "string",
"default": "linkedin"
},
"post_type": {
"enum": [
"text",
"image",
"carousel",
"video",
"article"
],
"type": "string"
},
"creator_id": {
"type": "string"
},
"media_plan": {
"type": "object"
},
"constraints": {
"type": "array",
"items": {
"type": "string"
}
},
"source_urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Source URLs to synthesize and weave into the draft when useful."
},
"evidence_needs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Specific facts, benchmarks, claims, or questions the draft should verify or use."
},
"research_notes": {
"type": "string",
"description": "Concise source-backed findings from web research, or saved research."
},
"research_policy": {
"enum": [
"auto",
"required",
"off"
],
"type": "string",
"default": "auto",
"description": "auto runs current research when the brief has fresh-data/news/benchmark signals; required forces it; off disables it."
},
"interview_policy": {
"enum": [
"auto",
"required",
"off"
],
"type": "string",
"default": "auto",
"description": "auto asks mini-interview questions when authentic creator POV is missing."
},
"template_category": {
"type": "string",
"description": "Optional category hint. BAMF still matches multiple templates by semantic, lexical, style, performance, recency, and diversity signals."
},
"include_first_comment": {
"type": "boolean",
"default": true
},
"mini_interview_answers": {
"type": "object",
"description": "Creator answers keyed by question or topic. Use for real stories, opinions, proof, and voice."
},
"use_template_inspiration": {
"type": "boolean",
"default": true
}
}
},
"annotations": {
"title": "Generate Post",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}| Optional rough draft, LinkedIn post, bookmark note, or source post to adapt. |
| mini_interview_answers | object |
{
"name": "bamf.generate_x_post",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id",
"brief"
],
"properties": {
"brief": {
"type": "string"
},
"x_format": {
"enum": [
"auto",
"single",
"thread",
"long_form",
"reply",
"quote",
"bookmark_remix",
"image_post",
"resource_dm"
],
"type": "string",
"default": "auto"
},
"creator_id": {
"type": "string"
},
"media_plan": {
"type": "object"
},
"constraints": {
"type": "array",
"items": {
"type": "string"
}
},
"source_urls": {
"type": "array",
"items": {
"type": "string"
}
},
"thread_length": {
"type": "number",
"description": "Preferred thread length. 5-10 is usually strongest."
},
"research_notes": {
"type": "string"
},
"engagement_goal": {
"enum": [
"reply",
"repost",
"bookmark",
"profile_click",
"follow",
"dm",
"none"
],
"type": "string",
"default": "reply"
},
"research_policy": {
"enum": [
"auto",
"required",
"off"
],
"type": "string",
"default": "auto"
},
"source_material": {
"type": "string",
"description": "Optional rough draft, LinkedIn post, bookmark note, or source post to adapt."
},
"mini_interview_answers": {
"type": "object"
}
}
},
"annotations": {
"title": "Generate X Post",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}| string |
| generated_image_url | string |
{
"name": "bamf.edit_post",
"description": "Patch an existing draft or scheduled post after the user approves exact edits. Supports first comments and media fields.",
"inputSchema": {
"type": "object",
"required": [
"post_id"
],
"properties": {
"topic": {
"type": "string"
},
"content": {
"type": "string"
},
"post_id": {
"type": "string"
},
"post_type": {
"enum": [
"text",
"image",
"carousel",
"video",
"article"
],
"type": "string"
},
"video_url": {
"type": "string"
},
"article_url": {
"type": "string"
},
"document_url": {
"type": "string",
"description": "LinkedIn carousel/document PDF URL."
},
"article_title": {
"type": "string"
},
"first_comment": {
"type": "string"
},
"carousel_slides": {
"type": "array",
"items": {
"type": "object"
}
},
"edit_instruction": {
"type": "string",
"description": "The user's instruction that produced this content edit; recorded as a learning signal."
},
"uploaded_image_url": {
"type": "string"
},
"generated_image_url": {
"type": "string"
}
}
},
"annotations": {
"title": "Edit Post",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}| evidence_needs | array | Specific facts, benchmarks, claims, or questions the edit should verify or use. |
| research_notes | string | Concise source-backed findings from web research, or saved research. |
| current_content | string |
| preserve_points | array |
| research_policy | string | auto runs current research when the edit has fresh-data/news/benchmark signals; required forces it; off disables it. |
| source_material | string | Rough pasted draft or idea notes when no post_id exists. |
| diagnostic_notes | string | Optional agent pre-read of weak draft signals, buried hook candidates, missing creator POV, or formatting issues. |
| interview_policy | string | auto asks mini-interview questions when authentic creator POV is missing. |
| template_category | string | Optional category hint for matched template inspiration. |
| current_first_comment | string |
| personalization_notes | string |
| mini_interview_answers | object | Creator answers keyed by question or topic. Use for real stories, opinions, proof, and voice. |
| use_template_inspiration | boolean |
{
"name": "bamf.generate_post_edit",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id"
],
"properties": {
"avoid": {
"type": "array",
"items": {
"type": "string"
},
"description": "Phrases, claims, tones, CTAs, or angles the edit should avoid."
},
"post_id": {
"type": "string"
},
"edit_mode": {
"enum": [
"auto",
"surgical",
"general",
"full_rewrite",
"regenerate_from_draft"
],
"type": "string",
"default": "auto"
},
"creator_id": {
"type": "string"
},
"media_notes": {
"type": "string"
},
"quality_bar": {
"type": "array",
"items": {
"type": "string"
},
"description": "Review criteria the proposal should satisfy, such as first-person hook, second-line stakes, specific creator insight, mobile scannability, and strong close."
},
"source_urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Source URLs to synthesize and weave into the revision when useful."
},
"instructions": {
"type": "string"
},
"must_preserve": {
"type": "array",
"items": {
"type": "string"
},
"description": "Facts, claims, wording, examples, or constraints that must survive the edit."
},
"evidence_needs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Specific facts, benchmarks, claims, or questions the edit should verify or use."
},
"research_notes": {
"type": "string",
"description": "Concise source-backed findings from web research, or saved research."
},
"current_content": {
"type": "string"
},
"preserve_points": {
"type": "array",
"items": {
"type": "string"
}
},
"research_policy": {
"enum": [
"auto",
"required",
"off"
],
"type": "string",
"default": "auto",
"description": "auto runs current research when the edit has fresh-data/news/benchmark signals; required forces it; off disables it."
},
"source_material": {
"type": "string",
"description": "Rough pasted draft or idea notes when no post_id exists."
},
"diagnostic_notes": {
"type": "string",
"description": "Optional agent pre-read of weak draft signals, buried hook candidates, missing creator POV, or formatting issues."
},
"interview_policy": {
"enum": [
"auto",
"required",
"off"
],
"type": "string",
"default": "auto",
"description": "auto asks mini-interview questions when authentic creator POV is missing."
},
"template_category": {
"type": "string",
"description": "Optional category hint for matched template inspiration."
},
"current_first_comment": {
"type": "string"
},
"personalization_notes": {
"type": "string"
},
"mini_interview_answers": {
"type": "object",
"description": "Creator answers keyed by question or topic. Use for real stories, opinions, proof, and voice."
},
"use_template_inspiration": {
"type": "boolean",
"default": true
}
}
},
"annotations": {
"title": "Generate Post Edit",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}{
"name": "bamf.edit_carousel_slide",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"post_id",
"slide"
],
"properties": {
"cta": {
"type": "string"
},
"body": {
"type": "string"
},
"slide": {
"type": "number",
"description": "1-based slide number (see bamf.list_post_versions slides[])."
},
"title": {
"type": "string"
},
"content": {
"type": "string",
"description": "Full slide copy; when omitted it is rebuilt from title/body/cta."
},
"post_id": {
"type": "string"
},
"rerender": {
"type": "boolean",
"description": "Prompt carousels only (including hand-built ones): re-render this page (cover or close on hand-built decks) and rebuild the PDF; the previous image stays in versions and errors are returned."
},
"image_instruction": {
"type": "string",
"description": "Edit this slide's current image. Requires images:generate."
}
}
},
"annotations": {
"title": "Edit Carousel Slide",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}{
"name": "bamf.run_ai_roundup",
"description": "Run 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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id"
],
"properties": {
"series": {
"type": "array",
"items": {
"enum": [
"ai_news",
"github_repos",
"memes",
"ai_video",
"prompt_carousels"
],
"type": "string"
},
"default": [
"ai_news"
]
},
"cadence": {
"enum": [
"daily",
"weekly"
],
"type": "string",
"default": "daily"
},
"dry_run": {
"type": "boolean",
"default": false,
"description": "Extract/verify/rank only, no drafts."
},
"eval_run": {
"type": "boolean",
"default": false,
"description": "QA runs: drafts are stamped eval_run and stay out of the review queue."
},
"new_post": {
"type": "boolean",
"default": false,
"description": "True only when the creator explicitly asked for a separate/new post."
},
"creator_id": {
"type": "string"
},
"workspace_id": {
"type": "string",
"description": "Optional; defaults to the creator's workspace."
},
"target_post_id": {
"type": "string",
"description": "The post open in the editor. The matching draft updates it in place (prior version kept) instead of creating a new post. Omit only when the creator explicitly asks for a new post."
}
}
},
"annotations": {
"title": "Run AI Roundup",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}| string |
| one of ["report","dashboard","document","research","analysis"] |
{
"name": "bamf.save_agent_artifact",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id",
"title",
"content",
"source_provider"
],
"properties": {
"path": {
"type": "string",
"description": "Optional lowercase .md, .json, or .txt path under the creator knowledge library."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20
},
"title": {
"type": "string",
"maxLength": 240
},
"content": {
"type": "string",
"description": "Durable Markdown or JSON-compatible text, maximum 200KB."
},
"creator_id": {
"type": "string"
},
"source_provider": {
"enum": [
"claude",
"chatgpt",
"codex",
"bamf",
"other"
],
"type": "string"
},
"created_by_agent": {
"type": "string",
"maxLength": 160
},
"source_session_id": {
"type": "string",
"maxLength": 240
},
"source_session_url": {
"type": "string",
"format": "uri",
"description": "Optional visible Claude, ChatGPT, Codex, or BAMF session URL. Omit when the host does not expose it."
},
"source_artifact_type": {
"enum": [
"report",
"dashboard",
"document",
"research",
"analysis"
],
"type": "string",
"default": "report"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Save Agent Artifact",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}| boolean |
| Also return the repurposing guide. |
| design_subtype | string | With source=library, e.g. numbered_cards, cheat_sheet, steps_process, whiteboard, dark. |
{
"name": "bamf.list_design_references",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 20,
"maximum": 50
},
"query": {
"type": "string",
"description": "Matches reference name or tag."
},
"source": {
"enum": [
"library"
],
"type": "string",
"description": "library = human-approved reference designs (reference image, design_type, design_subtype, slot shape, person slot, render route, agent_notes). Pick by subtype and slot shape that fit the post."
},
"category": {
"type": "string"
},
"platform": {
"enum": [
"linkedin",
"x",
"instagram"
],
"type": "string"
},
"post_type": {
"type": "string",
"description": "e.g. text, image_quote, infographic, carousel, motion_infographic, single_post, thread, quote_card, screenshot, comic, feed_image, reel_cover"
},
"design_type": {
"type": "string",
"description": "With source=library, e.g. infographic, diagram, tweet_card, quote_card, personal_image, visual_metaphor."
},
"person_slot": {
"enum": [
"none",
"avatar",
"card_photo",
"full_bleed_photo",
"illustration"
],
"type": "string"
},
"include_guide": {
"type": "boolean",
"description": "Also return the repurposing guide."
},
"design_subtype": {
"type": "string",
"description": "With source=library, e.g. numbered_cards, cheat_sheet, steps_process, whiteboard, dark."
}
}
},
"annotations": {
"title": "List Design References",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}| brand_pack_id | string |
| reference_name | string |
| reference_urls | array |
| negative_prompt | ["string","null"] |
| reference_notes | string |
| trigger_keywords | array |
| visual_style_prompt | ["string","null"] |
| is_default_reference | boolean |
| inline_reference_data_urls | array |
{
"name": "bamf.update_brand_kit_references",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id"
],
"properties": {
"mode": {
"enum": [
"append",
"replace"
],
"type": "string",
"default": "append"
},
"name": {
"type": "string"
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"fonts": {
"type": "array",
"items": {
"type": "string"
}
},
"notes": {
"type": [
"string",
"null"
]
},
"palette": {
"type": "array",
"items": {
"type": "string"
}
},
"pack_type": {
"enum": [
"personal",
"image_quote",
"infographic",
"carousel"
],
"type": "string",
"default": "image_quote"
},
"asset_role": {
"enum": [
"logo",
"style_reference",
"template_reference",
"texture",
"color_reference"
],
"type": "string",
"default": "style_reference"
},
"creator_id": {
"type": "string"
},
"brand_rules": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"brand_pack_id": {
"type": "string"
},
"reference_name": {
"type": "string"
},
"reference_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 8,
"minItems": 1
},
"negative_prompt": {
"type": [
"string",
"null"
]
},
"reference_notes": {
"type": "string"
},
"trigger_keywords": {
"type": "array",
"items": {
"type": "string"
}
},
"visual_style_prompt": {
"type": [
"string",
"null"
]
},
"is_default_reference": {
"type": "boolean"
},
"inline_reference_data_urls": {
"type": "array",
"items": {
"type": "string",
"description": "PNG, JPEG, or WebP data URL localized into BAMF.ai media before attachment."
},
"maxItems": 4
}
}
},
"annotations": {
"title": "Update Brand Kit References",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}| creator_id * | string |
| instruction | string | Direction for any design, and the feedback a re-run of an existing design needs (8+ characters, e.g. "fewer cards, bigger type"). For a meme: which point the captions make. |
| reference_id | string | Approved design reference to match, or a meme library template id (meme designs only). |
| source_post_id | string |
{
"name": "bamf.design_post",
"description": "Designing in the background: picks an approved reference, writes slot copy from the post, places the creator's real photo and official app logos, proofreads, and leaves a draft for review. Memes: pass template \"meme\" and/or a meme library reference_id (bamf.list_design_references, category meme_template) to make a meme with Claude: only the template picture with the post's captions in its slots, no headline, footer, logo or CTA; needs post_id. mode \"custom\" (with likeness and style) makes a unique scene inspired by that meme's joke structure instead. Poll bamf.get_design. Never schedules or publishes. Costs credits.",
"inputSchema": {
"type": "object",
"required": [
"creator_id"
],
"properties": {
"qa": {
"type": "boolean",
"description": "Mark as a QA run so the draft stays out of the review queue."
},
"mode": {
"enum": [
"template",
"custom"
],
"type": "string",
"description": "Meme only. template (default): the real template picture with captions. custom: a uniquely made scene inspired by the meme's joke structure (reference_id, or one BAMF picks that fits the post and was not used recently)."
},
"style": {
"type": "string",
"description": "Custom meme only: the design style for the scene, e.g. 'pixar 3d', 'claymation', 'film still'."
},
"post_id": {
"type": "string",
"description": "Post to design. Provide post_id or source_post_id."
},
"captions": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 8,
"description": "Meme only: ordered panel captions used verbatim in the panel slots. Omit to caption from the post text."
},
"likeness": {
"type": "boolean",
"description": "Meme only: put the creator's real likeness in the scene, generated from approved likeness photos (never a pasted cutout or avatar)."
},
"template": {
"enum": [
"tweet_card_dark",
"tweet_card_light",
"chart_post",
"stats_over_photo",
"app_icon_grid",
"highlighted_quote",
"model_base",
"meme"
],
"type": "string"
},
"creator_id": {
"type": "string"
},
"instruction": {
"type": "string",
"description": "Direction for any design, and the feedback a re-run of an existing design needs (8+ characters, e.g. \"fewer cards, bigger type\"). For a meme: which point the captions make."
},
"reference_id": {
"type": "string",
"description": "Approved design reference to match, or a meme library template id (meme designs only)."
},
"source_post_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Design Post",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}{
"name": "bamf.add_brand_font",
"description": "Add a font file to a creator's brand fonts. When a design uses a font the creator has, upload it here and use it by name; never substitute a look-alike and never ask about licences. Upload each weight/style file of a family; they are stored as faces of one family. Accepts an HTTPS url or file_base64. Font files are stored privately and are never public. Pass replace with an existing family name to overwrite the whole family.",
"inputSchema": {
"type": "object",
"required": [
"author_id",
"role"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "HTTPS URL of the font file. Provide url or file_base64."
},
"note": {
"type": "string"
},
"role": {
"enum": [
"heading",
"body",
"handwriting",
"accent",
"mono"
],
"type": "string"
},
"usage": {
"type": "string"
},
"family": {
"type": "string",
"description": "Font family name; read from the file when omitted."
},
"replace": {
"type": "string",
"description": "Existing family name to replace (keeps its role and usage unless given)."
},
"author_id": {
"type": "string"
},
"file_base64": {
"type": "string",
"description": "Base64 font file bytes. Provide url or file_base64."
},
"license_confirmed": {
"type": "boolean",
"description": "Deprecated and ignored."
}
}
},
"annotations": {
"title": "Add Brand Font",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}| string |
| Optional draft/scheduled post to attach the first generated image to. |
| quality | string | one of ["low","medium","high","auto"] |
| alt_text | string |
| feedback | string | What to change versus the last output. Required to re-run a post (post_id) that already has design outputs; otherwise the run is refused with library_rerun_needs_feedback. |
| style_id | string | Style the user picked from bamf.list_style_options. Resolved to its reference image and layout notes server side; the brand kit still applies. |
| creator_id * | string |
| size_preset | string | With engine=claude_design: X 1600x900 / 1080x1080; LinkedIn 1200x1500 / 1080x1350 / 1200x627. |
| source_urls | array | Source URLs for visual claims or infographic facts. |
| visual_type | string | one of ["image_quote","infographic","personal","profile_banner","profile_featured"] |
| output_formats | array | Include gif or mp4 to get the animated infographic (same as format=motion_infographic). |
| research_notes | string | Concise source-backed facts to use only when they strengthen the visible copy. |
| research_policy | string | one of ["auto","required","off"] |
| profile_asset_kind | string | Required for profile assets. profile_banner accepts banner; profile_featured accepts featured_1 or featured_2. |
| profile_package_id | string | Required for profile_banner/profile_featured. Must identify an active profile package owned by creator_id. |
| referenceImageUrls | array |
| reference_bindings | array | Resolved bamf.multimodal-reference-binding/v1 envelopes. Each item contains binding plus asset_url. Official person identity routes as likeness, other official refs preserve exact product/brand truth, and inspiration refs route only as style/layout guidance. |
| visual_copy_strategy | string | Guidance for additive visible text; image quotes should be fresh companion thoughts, not pull quotes. |
| styleReferenceImageUrls | array | HTTPS design reference pixels. The first one is rebuilt with the new copy (reference-matched design pipeline). |
| likenessReferenceImageUrls | array | Optional creator likeness references. Defaults to the creator avatar/LinkedIn profile image when omitted. |
{
"name": "bamf.generate_image",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id",
"prompt"
],
"properties": {
"n": {
"type": "number",
"default": 1
},
"size": {
"type": "string",
"default": "1024x1024"
},
"engine": {
"enum": [
"default",
"claude_design"
],
"type": "string",
"description": "claude_design: Claude designs the visual as SVG with the creator's brand kit (real logo, colors, fonts) and BAMF renders a platform-sized PNG. Uses BAMF credits. Formats: image_quote, infographic, carousel slide."
},
"format": {
"enum": [
"quote_card",
"infographic",
"carousel_slide",
"motion_infographic"
],
"type": "string",
"description": "With engine=claude_design. motion_infographic returns an animated infographic: poster PNG plus GIF and MP4 (gif_url, mp4_url on bamf.get_job), rendered by the same motion pipeline as the BAMF app."
},
"prompt": {
"type": "string",
"description": "Asset brief. For visual_type=image_quote, describe the post takeaway and ask for one original, repostable quote-card thought; do not ask the user to supply a quote when post context is available."
},
"post_id": {
"type": "string",
"description": "Optional draft/scheduled post to attach the first generated image to."
},
"quality": {
"enum": [
"low",
"medium",
"high",
"auto"
],
"type": "string",
"default": "high"
},
"alt_text": {
"type": "string"
},
"feedback": {
"type": "string",
"maxLength": 1000,
"minLength": 8,
"description": "What to change versus the last output. Required to re-run a post (post_id) that already has design outputs; otherwise the run is refused with library_rerun_needs_feedback."
},
"style_id": {
"type": "string",
"description": "Style the user picked from bamf.list_style_options. Resolved to its reference image and layout notes server side; the brand kit still applies."
},
"creator_id": {
"type": "string"
},
"size_preset": {
"enum": [
"x_landscape",
"x_square",
"linkedin_portrait",
"linkedin_feed",
"linkedin_landscape"
],
"type": "string",
"description": "With engine=claude_design: X 1600x900 / 1080x1080; LinkedIn 1200x1500 / 1080x1350 / 1200x627."
},
"source_urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Source URLs for visual claims or infographic facts."
},
"visual_type": {
"enum": [
"image_quote",
"infographic",
"personal",
"profile_banner",
"profile_featured"
],
"type": "string"
},
"output_formats": {
"type": "array",
"items": {
"enum": [
"png",
"gif",
"mp4"
],
"type": "string"
},
"description": "Include gif or mp4 to get the animated infographic (same as format=motion_infographic)."
},
"research_notes": {
"type": "string",
"description": "Concise source-backed facts to use only when they strengthen the visible copy."
},
"research_policy": {
"enum": [
"auto",
"required",
"off"
],
"type": "string",
"default": "auto"
},
"profile_asset_kind": {
"enum": [
"banner",
"featured_1",
"featured_2"
],
"type": "string",
"description": "Required for profile assets. profile_banner accepts banner; profile_featured accepts featured_1 or featured_2."
},
"profile_package_id": {
"type": "string",
"description": "Required for profile_banner/profile_featured. Must identify an active profile package owned by creator_id."
},
"referenceImageUrls": {
"type": "array",
"items": {
"type": "string"
}
},
"reference_bindings": {
"type": "array",
"items": {
"type": "object",
"required": [
"binding",
"asset_url"
],
"properties": {
"binding": {
"type": "object",
"description": "A complete bamf.multimodal-reference-binding/v1 object with consent and provenance."
},
"asset_url": {
"type": "string",
"description": "HTTPS URL for the immutable asset version named by the binding."
}
}
},
"maxItems": 10,
"description": "Resolved bamf.multimodal-reference-binding/v1 envelopes. Each item contains binding plus asset_url. Official person identity routes as likeness, other official refs preserve exact product/brand truth, and inspiration refs route only as style/layout guidance."
},
"visual_copy_strategy": {
"type": "string",
"description": "Guidance for additive visible text; image quotes should be fresh companion thoughts, not pull quotes."
},
"styleReferenceImageUrls": {
"type": "array",
"items": {
"type": "string"
},
"description": "HTTPS design reference pixels. The first one is rebuilt with the new copy (reference-matched design pipeline)."
},
"likenessReferenceImageUrls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional creator likeness references. Defaults to the creator avatar/LinkedIn profile image when omitted."
}
}
},
"annotations": {
"title": "Generate Image",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}| Source URLs for slide claims or benchmark facts. |
| research_notes | string | Concise source-backed facts to use only when they strengthen the slides. |
| research_policy | string | one of ["auto","required","off"] |
| referenceImageUrls | array |
| reference_bindings | array | Resolved bamf.multimodal-reference-binding/v1 envelopes. Each item contains binding plus asset_url; official and inspiration authority is validated before the job is persisted. |
| visual_copy_strategy | string | Guidance for additive slide copy that improves on the post instead of copying it. |
| styleReferenceImageUrls | array |
| likenessReferenceImageUrls | array | Optional creator likeness references. Defaults to the creator avatar/LinkedIn profile image when omitted. |
{
"name": "bamf.generate_carousel",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id",
"slides"
],
"properties": {
"size": {
"type": "string",
"default": "1024x1024"
},
"title": {
"type": "string"
},
"slides": {
"type": "array",
"items": {
"type": "object",
"properties": {
"body": {
"type": "string"
},
"title": {
"type": "string"
},
"prompt": {
"type": "string"
},
"alt_text": {
"type": "string"
},
"image_prompt": {
"type": "string"
}
}
}
},
"post_id": {
"type": "string",
"description": "Optional draft/scheduled post to attach the generated PDF to."
},
"quality": {
"enum": [
"low",
"medium",
"high",
"auto"
],
"type": "string",
"default": "high"
},
"style_id": {
"type": "string",
"description": "Style the user picked from bamf.list_style_options. Resolved to its reference image and layout notes server side; the brand kit still applies."
},
"creator_id": {
"type": "string"
},
"source_urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Source URLs for slide claims or benchmark facts."
},
"research_notes": {
"type": "string",
"description": "Concise source-backed facts to use only when they strengthen the slides."
},
"research_policy": {
"enum": [
"auto",
"required",
"off"
],
"type": "string",
"default": "auto"
},
"referenceImageUrls": {
"type": "array",
"items": {
"type": "string"
}
},
"reference_bindings": {
"type": "array",
"items": {
"type": "object",
"required": [
"binding",
"asset_url"
],
"properties": {
"binding": {
"type": "object",
"description": "A complete bamf.multimodal-reference-binding/v1 object with consent and provenance."
},
"asset_url": {
"type": "string",
"description": "HTTPS URL for the immutable asset version named by the binding."
}
}
},
"maxItems": 10,
"description": "Resolved bamf.multimodal-reference-binding/v1 envelopes. Each item contains binding plus asset_url; official and inspiration authority is validated before the job is persisted."
},
"visual_copy_strategy": {
"type": "string",
"description": "Guidance for additive slide copy that improves on the post instead of copying it."
},
"styleReferenceImageUrls": {
"type": "array",
"items": {
"type": "string"
}
},
"likenessReferenceImageUrls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional creator likeness references. Defaults to the creator avatar/LinkedIn profile image when omitted."
}
}
},
"annotations": {
"title": "Generate Carousel",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}| Optional official/inspiration reference contract. The first official likeness image becomes the Seedance image-to-video start frame. |
{
"name": "bamf.generate_video",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"creator_id",
"prompt"
],
"properties": {
"prompt": {
"type": "string"
},
"duration": {
"enum": [
5,
10
],
"type": "number",
"default": 5
},
"style_id": {
"type": "string",
"description": "Style the user picked from bamf.list_style_options. Resolved to its reference image and layout notes server side; the brand kit still applies."
},
"image_url": {
"type": "string",
"description": "Optional HTTPS start frame. When present, BAMF uses Seedance 2.5 image-to-video instead of text-to-video."
},
"creator_id": {
"type": "string"
},
"resolution": {
"enum": [
"480p",
"720p",
"1080p"
],
"type": "string",
"default": "720p"
},
"aspect_ratio": {
"enum": [
"16:9",
"9:16",
"1:1"
],
"type": "string",
"default": "16:9"
},
"generate_audio": {
"type": "boolean",
"default": true
},
"reference_bindings": {
"type": "array",
"items": {
"type": "object",
"required": [
"binding",
"asset_url"
],
"properties": {
"binding": {
"type": "object",
"description": "A complete bamf.multimodal-reference-binding/v1 object with consent and provenance."
},
"asset_url": {
"type": "string",
"description": "HTTPS URL for the immutable asset version named by the binding."
}
}
},
"description": "Optional official/inspiration reference contract. The first official likeness image becomes the Seedance image-to-video start frame."
}
}
},
"annotations": {
"title": "Generate Video",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}| principal_context_ref_id * | string |
| apollo_preview_session_id | string | Owned completed Apollo preview session matching these search criteria; required with credit approval. |
| apollo_enrichment_approval | string | Explicit approval to use up to 90 credits for 10 people or 180 credits for 20 people. Requires external Apollo search and its owned preview session. |
{
"name": "bamf.start_outreach_discovery",
"description": "Start a tenant- and principal-scoped, provider-read-only outreach discovery session. This discovers candidates only; it never creates or sends a campaign.",
"inputSchema": {
"type": "object",
"required": [
"workspace_id",
"session_id",
"principal_context_ref_id",
"gateway_run_id",
"provider",
"provider_account_id",
"capability_receipt_ref",
"source_mode",
"targeting",
"idempotency_key"
],
"properties": {
"provider": {
"type": "string"
},
"targeting": {
"type": "string",
"maxLength": 4000
},
"session_id": {
"type": "string",
"format": "uuid"
},
"source_mode": {
"enum": [
"external",
"crm",
"first_degree"
],
"type": "string"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"gateway_run_id": {
"type": "string",
"format": "uuid"
},
"idempotency_key": {
"type": "string",
"maxLength": 240,
"minLength": 8
},
"search_criteria": {
"type": "object",
"properties": {
"title": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"company": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"industry": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"keywords": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"geography": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"headcount": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"seniority": {
"type": "string",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": false
},
"provider_account_id": {
"type": "string"
},
"capability_receipt_ref": {
"type": "string"
},
"principal_context_ref_id": {
"type": "string",
"format": "uuid"
},
"apollo_preview_session_id": {
"type": "string",
"format": "uuid",
"description": "Owned completed Apollo preview session matching these search criteria; required with credit approval."
},
"apollo_enrichment_approval": {
"enum": [
"up_to_90_credits",
"up_to_180_credits"
],
"type": "string",
"description": "Explicit approval to use up to 90 credits for 10 people or 180 credits for 20 people. Requires external Apollo search and its owned preview session."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Start Outreach Discovery",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| string |
| principal_context_ref_id * | string |
{
"name": "bamf.resume_outreach_discovery",
"description": "Resume a scoped outreach discovery session from server-owned coverage. Caller-supplied provider cursors or organization IDs are not accepted as authority.",
"inputSchema": {
"type": "object",
"required": [
"discovery_session_id",
"workspace_id",
"session_id",
"principal_context_ref_id",
"gateway_run_id",
"provider",
"provider_account_id",
"capability_receipt_ref",
"source_mode",
"targeting",
"idempotency_key"
],
"properties": {
"provider": {
"type": "string"
},
"targeting": {
"type": "string",
"maxLength": 4000
},
"session_id": {
"type": "string",
"format": "uuid"
},
"source_mode": {
"enum": [
"external",
"crm",
"first_degree"
],
"type": "string"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"gateway_run_id": {
"type": "string",
"format": "uuid"
},
"idempotency_key": {
"type": "string",
"maxLength": 240,
"minLength": 8
},
"provider_account_id": {
"type": "string"
},
"discovery_session_id": {
"type": "string",
"format": "uuid"
},
"capability_receipt_ref": {
"type": "string"
},
"principal_context_ref_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Resume Outreach Discovery",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}{
"name": "bamf.cancel_outreach_discovery",
"description": "Request cancellation of one scoped outreach discovery session. This cancels discovery only and never mutates a provider campaign.",
"inputSchema": {
"type": "object",
"required": [
"discovery_session_id",
"workspace_id",
"session_id",
"principal_context_ref_id",
"gateway_run_id",
"provider",
"provider_account_id",
"capability_receipt_ref",
"idempotency_key"
],
"properties": {
"provider": {
"type": "string"
},
"session_id": {
"type": "string",
"format": "uuid"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"gateway_run_id": {
"type": "string",
"format": "uuid"
},
"idempotency_key": {
"type": "string",
"maxLength": 240,
"minLength": 8
},
"provider_account_id": {
"type": "string"
},
"discovery_session_id": {
"type": "string",
"format": "uuid"
},
"capability_receipt_ref": {
"type": "string"
},
"principal_context_ref_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Cancel Outreach Discovery",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}{
"name": "bamf.save_outreach_discovery",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"discovery_session_id",
"workspace_id",
"session_id",
"principal_context_ref_id",
"gateway_run_id",
"provider",
"provider_account_id",
"capability_receipt_ref",
"idempotency_key"
],
"properties": {
"provider": {
"type": "string"
},
"session_id": {
"type": "string",
"format": "uuid"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"gateway_run_id": {
"type": "string",
"format": "uuid"
},
"idempotency_key": {
"type": "string",
"maxLength": 240,
"minLength": 8
},
"provider_account_id": {
"type": "string"
},
"discovery_session_id": {
"type": "string",
"format": "uuid"
},
"capability_receipt_ref": {
"type": "string"
},
"principal_context_ref_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Save Outreach Discovery",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}| principal_context_ref_id * | string |
{
"name": "bamf.prepare_outreach_growth_delivery",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"schema_version",
"tenant_id",
"workspace_id",
"principal_context_ref_id",
"recipient",
"eligibility",
"artifacts",
"approval",
"suppression",
"delivery",
"idempotency_key"
],
"properties": {
"approval": {
"type": "object",
"required": [
"approval_id",
"revision",
"binding",
"approved_at",
"expires_at"
],
"properties": {
"binding": {
"type": "string",
"minLength": 1
},
"revision": {
"type": "string",
"minLength": 1
},
"expires_at": {
"type": "string",
"format": "date-time"
},
"approval_id": {
"type": "string",
"minLength": 1
},
"approved_at": {
"type": "string",
"format": "date-time"
}
},
"additionalProperties": false
},
"delivery": {
"type": "object",
"required": [
"delivery_id",
"state",
"prior_delivery_ids"
],
"properties": {
"state": {
"type": "string",
"const": "pending"
},
"delivery_id": {
"type": "string",
"minLength": 1
},
"prior_delivery_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"artifacts": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"artifact_id",
"revision"
],
"properties": {
"kind": {
"enum": [
"resource",
"newsletter",
"booking"
],
"type": "string"
},
"revision": {
"type": "string",
"minLength": 1
},
"artifact_id": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 3,
"minItems": 3
},
"recipient": {
"type": "object",
"required": [
"recipient_id",
"account_id",
"thread_id"
],
"properties": {
"thread_id": {
"type": "string",
"minLength": 1
},
"account_id": {
"type": "string",
"minLength": 1
},
"recipient_id": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"tenant_id": {
"type": "string",
"format": "uuid"
},
"eligibility": {
"type": "object",
"required": [
"evidence_id",
"tenant_id",
"workspace_id",
"principal_context_ref_id",
"account_id",
"thread_id",
"recipient_id",
"source_receipt_id",
"post_id",
"comment_id",
"comment_text",
"keyword",
"captured_at",
"eligible_until"
],
"properties": {
"keyword": {
"type": "string",
"minLength": 1
},
"post_id": {
"type": "string",
"minLength": 1
},
"tenant_id": {
"type": "string",
"format": "uuid"
},
"thread_id": {
"type": "string",
"minLength": 1
},
"account_id": {
"type": "string",
"minLength": 1
},
"comment_id": {
"type": "string",
"minLength": 1
},
"captured_at": {
"type": "string",
"format": "date-time"
},
"evidence_id": {
"type": "string",
"minLength": 1
},
"comment_text": {
"type": "string",
"minLength": 1
},
"recipient_id": {
"type": "string",
"minLength": 1
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"eligible_until": {
"type": "string",
"format": "date-time"
},
"source_receipt_id": {
"type": "string",
"minLength": 1
},
"principal_context_ref_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"suppression": {
"type": "object",
"required": [
"opted_out",
"checked_at"
],
"properties": {
"opted_out": {
"type": "boolean"
},
"checked_at": {
"type": "string",
"format": "date-time"
}
},
"additionalProperties": false
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"schema_version": {
"type": "integer",
"const": 1
},
"idempotency_key": {
"type": "string",
"maxLength": 240,
"minLength": 8
},
"principal_context_ref_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Prepare Outreach Growth Delivery",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}{
"name": "bamf.schedule_video_post",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"video_project_id",
"content",
"platforms",
"approved"
],
"properties": {
"title": {
"type": "string",
"description": "YouTube title."
},
"content": {
"type": "string"
},
"approved": {
"type": "boolean",
"description": "Must be true: the user approved this exact plan."
},
"timezone": {
"type": "string"
},
"platforms": {
"type": "array",
"items": {
"type": "object",
"required": [
"platform"
],
"properties": {
"platform": {
"enum": [
"linkedin",
"x",
"instagram",
"youtube",
"tiktok"
],
"type": "string"
},
"platformSpecificData": {
"type": "object"
}
}
}
},
"video_url": {
"type": "string",
"description": "Defaults to the project's exported output."
},
"publish_now": {
"type": "boolean"
},
"scheduled_for": {
"type": "string",
"description": "Future ISO 8601 timestamp."
},
"thumbnail_url": {
"type": "string"
},
"idempotency_key": {
"type": "string"
},
"video_project_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Schedule Video Post",
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}