Antwork

Get the current authenticated user's profile. Returns user ID, email, display name, subscription status, and the persisted default workspace (if set).

No parameter schema in public metadata yet.

List all workspaces the authenticated user belongs to. Call this first if you need to know which workspaces are available. If the user has only one workspace, other tools auto-select it. Each entry is flagged with `isDefault: true` when it matches the user's persisted default...

No parameter schema in public metadata yet.

Pin (or clear) the user's default workspace for subsequent tool calls. Pass a workspace ID or name to PIN: every workspace-scoped tool called without an explicit `workspace_id` thereafter resolves to this workspace — instead of erroring out with "multiple workspaces". Use this...

Create a new workspace owned by the authenticated user. Use this when the user wants a separate brand / client / project space — each workspace has its own connected social accounts, voice profiles, posts, and media library. Subsequent tool calls can target the new workspace b...

Retrieve recent posts from a workspace. Results are pre-sorted scheduled → draft → published → failed. Within scheduled, the closest publish appears first (so the user sees "what's about to go live" at the top); other groups are newest-first. The posts-table iframe paginates c...

List the social media accounts currently connected to the workspace. Text-only and fast — this does NOT render the connections panel iframe. Use it to answer account questions and to confirm target platforms are connected before drafting / scheduling / publishing. When the use...

Disconnect a connected social media account (SOFT DELETE). This is a soft-delete — the social_accounts doc stays in Firestore with `isActive: false`. Nothing on the user's social platform is touched: no OAuth revocation, no app uninstall, no post deletion. The user's posts and...

Open the connections panel to connect, disconnect, or re-auth accounts. This renders the interactive connections-panel iframe (connect grid + per-account reauth / disconnect controls) and returns OAuth connect URLs per platform. Call this whenever the user wants to MANAGE conn...

Fetch recent posts from connected social media platforms. Retrieves actual published posts from your social accounts (not just Antwork drafts), including text, engagement metrics, publish date, and permalink. Useful for understanding what you've been posting and what's perform...

Get the workspace's configuration: name, default posting schedule, timezone, and connected platforms. Use this to discover the workspace's preferred posting times and timezone before suggesting schedule slots, or to confirm which platforms the user has selected as their primar...

Step 1 of voice-profile extraction. Returns the posts + schema YOU (the host LLM) should analyze yourself, then write back via `save_voice_analysis`. USE THIS WHEN: `get_post_context` returned `voiceStale: true` (or null voice) and you're about to draft a post for that account...

Step 2 of voice-profile extraction. Persists the analysis you produced in response to `prepare_voice_analysis`. Call this with EXACTLY the `accountId` returned by prepare_voice_analysis and an `analysis` object matching the `schema` from that call. The server validates the sha...

One-stop drafting bundle: brand identity, voice, and recent posts. Call this BEFORE writing a post. It returns everything the model needs to produce on-brand, on-tone copy for a specific (workspace, platform, account) target in a single round-trip: - `workspace`: name, website...

Get lifetime engagement totals per published post, as a tabular result. Returns a BigQuery-style payload: - `schema.fields`: column definitions (name, type, mode) - `rows`: one row per published post with lifetime metrics - `rowCount`: number of rows - `summary`: range totals...

Fetch fresh engagement metrics from each post's platform, RIGHT NOW. Unlike get_performance / get_post (which read cached numbers refreshed by a 6-hour cron), this tool hits the platform APIs live and writes the result back to Firestore. Use it when freshness matters: - "How's...

Get historical per-day engagement, as a tabular result. Returns a BigQuery-style payload in *long format* — one row per (date, platform) tuple, plus an "all" platform aggregate row per date. The host LLM can chart this directly (line per platform, stacked bars, pie of platform...

Get a single post by ID, including aggregated and per-platform metrics. Returns the post content, target platforms, status, and the latest LIFETIME engagement metrics: - `metrics`: aggregated totals across all platforms ({likes, comments, shares, impressions}) - `platformMetri...

Get the per-day historical metrics for a single post, as a tabular result. Returns a BigQuery-style payload in *long format* — one row per (date, platform) tuple. Both cumulative lifetime totals and the daily delta (engagement earned that day) are included as columns so the ho...

Get the workspace's preferred posting times, timezone, and selected accounts per platform. Returns the schedule the user configured (e.g. ["09:00", "18:00"] in their timezone) plus the per-platform account selections. Use this when scheduling a post to pick a time that aligns...

Create a draft post bound to ONE social account. The post is saved as a DRAFT only — to actually schedule or publish, call schedule_post or publish_post with the returned postId. Single-account model (IMPORTANT — read carefully): - Each call creates ONE draft for ONE specific...

Update an existing post. Posts are single-account. To switch the target account, pass `account_id` and we re-bind the post (the platform is re-derived from the new account). There is no per-platform text variant — if the user wants the same idea on a different account with dif...

Delete a post from the workspace. Drafts and scheduled posts are hard-deleted. Published posts are soft-deleted by default (the post is hidden from lists but metrics history is preserved); pass preserve_analytics=False to hard-delete a published post instead. Args: post_id: Th...

Publish a draft post immediately to its target account. Call this after create_post to publish right away instead of scheduling for later. Waits for the publish to complete on every target platform (up to ~60s) and returns the live post URLs in `url` / `urls` / per-platform en...

Schedule a draft post for automatic publishing at a specific time. Call this after create_post to actually schedule the post. The post must exist and be bound to a social account. Args: post_id: The post ID returned by create_post. scheduled_for: ISO 8601 datetime (e.g. "2026-...

Retry a post that failed to publish. Args: post_id: The failed post ID to retry. workspace_id: Workspace ID or name. Optional if user has only one workspace.

Duplicate an existing post into a new draft, optionally retargeting it to a different social account and / or rewriting the copy. Single-account model: the new draft binds to ONE account. If `account_id` is omitted, the new draft keeps the source's account. To produce variants...

List media files in the workspace media library. Returns uploaded images, videos, and PDF documents with URLs that can be attached to posts. Use this to find existing media before creating posts for visual platforms like Instagram, TikTok, or Pinterest, or for LinkedIn documen...

Attach media (images, videos, or PDFs) to an existing post. Sets the media URLs on the post. Use URLs from list_media or any Firebase Storage URL from the workspace. This replaces any existing media on the post. Required for publishing to visual platforms like Instagram, TikTo...

Add a file to the workspace media library from a public HTTPS URL. Antwork downloads the URL server-side and stores it. Use this for AI-generated content or anything else already reachable over HTTP. For LOCAL files (the user attached a screenshot, photo, video, etc.): NEVER r...

IFRAME-INTERNAL. DO NOT CALL FROM CHAT. Used by the post-card "Add media" picker to send file bytes over the MCP RPC channel (postMessage → tools/call) without touching the LLM's transcript. The LLM must NEVER call this tool. Passing a large base64 string as a tool argument ba...

Mint a short-lived signed PUT URL for a direct upload to GCS. PREREQUISITE: do NOT call this until you have a tool response showing `hostSupportsUi: false` (typically from a prior `get_post(post_id)` or `get_post_context` call). On UI hosts (claude.ai web / desktop, where `hos...

Validate a signed-PUT upload and register it in the workspace media library. Second half of the LLM-on-CLI upload flow. Call this AFTER a successful curl PUT against the URL from `request_upload_url`. Verifies the GCS object exists, matches the declared mime + size, attaches a...

Get a single media item by ID. Returns the media URL, name, type, size, and upload date. Args: media_id: The media item ID. workspace_id: Workspace ID or name. Optional if user has only one workspace.

Delete a media item from the workspace media library. This removes the Firestore record. The file in storage may still exist but will no longer appear in the media library. Args: media_id: The media item ID to delete. workspace_id: Workspace ID or name. Optional if user has on...

Search posts by keyword, status, platform, or date range. Args: query: Search keyword to match against post text (case-insensitive). status: Filter by status: "draft", "scheduled", "published", or "failed". platform: Filter by platform (e.g., "linkedin", "x"). date_from: Filte...

Get scheduled and published posts as an interactive calendar view. Returns posts grouped by date, useful for seeing what's coming up and finding gaps in the content schedule. On supported clients this renders an interactive calendar UI. Args: date_from: Start date (ISO 8601, e...

Update the workspace's identity (name, website, logo). Only the provided fields are updated; others remain unchanged. Args: name: The workspace / brand name. website: Brand website URL. logo_url: URL to the brand logo image. workspace_id: Workspace ID or name. Optional if user...

Update workspace settings such as the default posting schedule. Only the provided fields are updated; others remain unchanged. Args: timezone: IANA timezone for scheduling, e.g. "Europe/Madrid", "America/New_York". preferred_times: List of preferred posting times in HH:MM form...