approve_post
ChatGPTApprove a pending content item for immediate publishing or schedule for later. Only call when the user explicitly confirms.
contact_feedclaw
ChatGPTSend a message from the user to Martin, FeedClaw's founder, who reads every one and replies by email. Use it when the user reports something not working, sounds frustrated or stuck, asks a question you cannot answer, has feedback or a feature request, or asks to talk to a person at FeedClaw. Offer it; do not send without the user agreeing. Write the message in the user's own words and language, and include what they were trying to do and what happened. FeedClaw attaches the workspace, plan and recent errors itself, so do not ask the user for those. After it is sent, tell the user Martin will reply to the email address in reply_to.
create_and_publish
ChatGPTCreate content AND immediately approve and publish it in one step. Use ONLY when the user explicitly asks to publish or post now. Supports scheduling via schedule_at. For email content, returns preview_url. IMPORTANT for email: you must specify either list_id or send_to_all: true. If neither is provided, the system will return available lists for the user to choose from.
create_draft
ChatGPTCreate or save content in FeedClaw for publishing, scheduling, or later retrieval. Supports X (Twitter), LinkedIn, and email newsletters. Content is created as pending_approval when not scheduled. After creating, present the full content to the user as an inline preview and ask if they want to: (1) publish now, (2) schedule for a specific time, (3) edit, or (4) save it to FeedClaw for later. For batch creation (4+ items), direct the user to the FeedClaw inbox instead. For email content, share the preview_url so they can see the formatted email. Attach an image with image_url or a video with video_url (X or LinkedIn). For files the user has on their device, use get_upload_link then list_media (upload_media is only for small images you already hold as bytes). Media rules: X takes up to 4 images (image_urls) or one video; LinkedIn takes up to 9 images or one video; never images and video together; email takes one image. Never publish or schedule unless the user confirms; if the user explicitly asks to publish/post/send now, use create_and_publish instead. IMPORTANT for email: subscriber lists are optional groupings, not the subscriber count. You must specify either list_id or send_to_all: true. If get_lists returns 0 lists but total_active_subscribers is greater than 0, use send_to_all: true when the user wants all/current subscribers.
create_post
ChatGPTCreate content for X or email. Supports text and images. If schedule_at is provided, content is auto-scheduled. After creating, present the full content to the user as an inline preview and ask if they want to approve, schedule, edit, or leave in inbox. For email content, share the preview_url. Never auto-approve — always ask the user first. IMPORTANT for email: you must specify either list_id (to target a specific subscriber list) or send_to_all: true (to send to all subscribers). If the user does not specify, call this tool without either — the system will return available lists so you can ask the user.
delete_content
ChatGPTPermanently delete a draft, pending, or scheduled content item.
delete_draft
ChatGPTPermanently delete a draft, pending, or scheduled content item. Approved or published items cannot be deleted. Deleting a scheduled item cancels its publish job.
feedclaw_app
ChatGPTOpen FeedClaw: drafts, scheduled posts and recent publishes for every brand.
feedclaw_init
ChatGPTGet workspace brands and context. Call this first to obtain brand IDs needed by other tools.
feedclaw_panel
ChatGPTOpen your FeedClaw drafts and schedule beside this conversation.
get_analytics
ChatGPTGet email campaign analytics: delivery rates, click rates, bounce rates, and per-campaign performance. Shows data for the last N days.
get_brands
ChatGPTList all brands in your FeedClaw workspace. If no brands are returned, tell the user they must create a brand and connect a publishing channel in FeedClaw before creating or publishing content.
get_connect_channel_link
ChatGPTGet a link the user opens to connect X or LinkedIn. Use when they have drafts and want to publish somewhere that is not connected yet. The link opens the provider's own authorize screen; after approval the tab closes itself. Show the url and message_for_user, then follow instructions_for_agent: poll get_onboarding_state silently until channels.<platform> is true. Do not explain OAuth.
get_content
ChatGPTGet the full details of a content item by ID.
get_lists
ChatGPTGet the email subscriber lists for a brand. Use when the user wants to see their mailing lists or choose which list to send to.
get_next_slot
ChatGPTGet the next optimal publishing time slot for a brand and channel. Use when the user says "schedule for the best time" or "next available slot".
get_onboarding_state
ChatGPTSame as feedclaw_init: brands, setup card and onboarding instructions. Prefer feedclaw_init at the start of a conversation; use this to re-check setup, for example after the user connects X or LinkedIn.
get_schedule
ChatGPTView scheduled content items sorted by publish time (soonest first).
get_subscribers
ChatGPTGet the email subscribers for a brand, optionally filtered by list. Use when the user wants to see who is subscribed.
get_upload_link
ChatGPTGet a link where the user drops photos or videos from their own device (phone or computer). Use it whenever the user wants to attach media they have — never ask them to paste files into the chat, and do not use upload_media for anything you do not already hold as bytes. The response includes a batch; after they say they are done, call list_media with that batch to get exactly those files. Images up to 10 MB, MP4 video up to 50 MB.
list_content
ChatGPTList content in the inbox with optional filters. Returns paginated results.
list_email_templates
ChatGPTList email templates available for a brand. Returns template ID, name, subject_prefix, and whether it is the brand default.
list_media
ChatGPTList the photos and videos the user uploaded (newest first). Pass the batch from get_upload_link to get exactly the files from that link; each asset says whether it is already attached_to a post and how long ago it was uploaded. Use url as image_url (one image), image_urls (up to 4, X only) or video_url. Rules: X takes up to 4 images or one video; LinkedIn takes up to 9 images or one video; never both together; email takes one image.
list_pending
ChatGPTList content items saved in FeedClaw that are ready for a publish, schedule, edit, or later decision.
quick_start
ChatGPTGet a drafting brief for a brand with no content yet. Returns the brand voice, topic hints and instructions — YOU write the posts, then save them with create_draft using channels: []. Use when get_onboarding_state returns next_step "create_first_content".
reschedule
ChatGPTMove a scheduled content item to a new publish time.
setup_brand
ChatGPTName the workspace brand and say what it publishes about. Use this ONLY when get_onboarding_state returns next_step "confirm_brand". It fills in an unconfirmed placeholder brand; if the user already named their brand it changes nothing and tells you so. It never renames an existing brand and never creates a second one unless create_new is true.
unschedule
ChatGPTCancel a scheduled publish and return the content item to pending approval. Use this to stop a scheduled post from being published. Confirm with user before canceling a scheduled publish.
update_draft
ChatGPTUpdate a draft, pending, or scheduled content item. Only title, content, channels, and metadata can be changed. Approved or published items cannot be modified.