act_on_inbox_item
ChatGPTUse this when the user approves or dismisses an inbox item from list_inbox: a team suggestion or finished draft, or a Reddit opportunity (approving posts the drafted comment to Reddit publicly). Only call approve when the user said so. Do not use for email drafts (use send_email_reply) or reviews (use draft_review_reply). Snoozing is not supported.
add_brand_document
ChatGPTUse this when the user shares a document Markty should know when writing for the brand: a style guide, product sheet, price list, policy or FAQ. Pass a link as url, or the document the user uploaded in this chat as file (pdf, docx, txt, md, csv or xlsx). Markty reads it for every later piece. Needs a paid Markty plan.
add_product
ChatGPTUse this when the user wants a product added to their Markty product library, which brand images and photo packs can feature. Pass the user's uploaded photo as photo to attach it now, or add one later. Free.
approve_scheduled_post
ChatGPTUse this when the user approves a post that is waiting for approval, so it publishes at its scheduled time. Only posts waiting for approval (needs_approval or needs_reapproval) can be approved. Only call it when the user said to approve this post. Do not use to publish immediately (use publish_post_now).
approve_work_order
ChatGPTUse this when the user agrees to a work order quoted by quote_work_order. Places the credit hold and starts the team in the background; check progress with get_work_order. Only call it after the user agreed to the quoted price.
ask_marketing_team
ChatGPTUse this when the request needs judgement or several steps: a plan, an analysis, feedback on a draft, a strategy question, a change to work the team already made, or anything no direct tool covers. It sends the message to the customer's Markty marketing team (Marty, the manager, and the social media, SEO and blog, e-commerce and email experts) and returns their reply in the customer's language, any content they made, image links and what was queued for approval. Costs one Markty credit per request, plus the app's price for anything it generates; the reply states what was charged. One request runs at a time. If the reply says the team is still working, call get_team_reply after a short wait. Do not use for a plain post (use draft_social_post), a standalone image (use generate_image) or a blog article (use create_blog_article); those are faster.
cancel_scheduled_post
ChatGPTUse this when the user wants a scheduled post taken off the calendar before it publishes. It is removed and cannot be restored from here. Free. Do not use to keep the post on record as declined (use reject_scheduled_post).
cancel_work_order
ChatGPTUse this when the user wants a work order stopped. An unapproved quote is dropped and nothing is charged; a running order stops after its current item, finished items stay done and charged, and the rest of the hold is released.
create_blog_article
ChatGPTUse this when the user wants a blog article or SEO article for their website on a topic, with optional secondary keywords. Written the way Markty's Blog & SEO expert writes, at Markty's standard SEO length (about 900-1200 words), and saved to the content library; include_cover_image also renders a cover. Costs credits like a blog article in the Markty app; when the price is above the usual threshold it first returns a quote, and runs only when called again with confirm set to true after the user agrees. Can take a while; the result then arrives as a job. Do not use for social posts (use draft_social_post). Publish with schedule_content.
create_content_plan
ChatGPTLays out a dated content plan ("next_week" or "next_month") the same way the Markty chat's "plan my week" does. A week plan can be committed (confirm: true): the team then writes every piece in the background, each charged as it is produced, and it lands on the content calendar. A month plan is a preview only and can never be committed. Above a small credit threshold, committing a week first returns a quote; call again with confirm: true to go ahead.
create_product_photos
ChatGPTUse this when the user wants product photos for their store or listings from one photo: a full gallery of clean product, lifestyle, scale, detail, variations, packaging and a Pinterest pin, optionally in a theme (Halloween, Christmas...). Pass the user's uploaded photo as photo, or product_name for a product already in their library. Always returns a quote first; runs only when called again with confirm set to true after the user agrees. Do not use for a single image (use generate_image).
create_standing_order
ChatGPTTurns a plain-language recurring task ("post to Instagram every weekday about our new arrivals", "check our top 3 competitors every Monday") into a scheduled standing order the team runs on its own from now on. Refused when it duplicates a built-in automation already on the schedule. When the monthly cost is more than trivial, this first returns a quote (about how many times a month it runs times its price); call again with confirm: true to actually create and turn it on.
delete_content
ChatGPTUse this when the user wants a content library item removed. Archives the item; free. Posts already on the calendar are unaffected (use cancel_scheduled_post for those).
draft_review_reply
ChatGPTUse this when the user wants a reply to a Google review. Drafts an on-brand reply from the business's Local Presence data; Markty cannot post it to Google, so the text is returned for the user to post. Omit review_id to draft for the review that most needs one (negative and unanswered first). Part of the Manager plan's Local Presence.
draft_social_post
ChatGPTUse this when the user wants a social media post, caption or hashtags for Instagram, Facebook, LinkedIn, Pinterest or X, for example 'write a post about our weekend offer' or 'use this photo for Instagram'. Writes the idea in the brand's voice for each platform, grounded in the brand's research and uploaded documents, saves every draft to the content library and shows each as a post card. Drafts are free. Set include_image to also render one on-brand image (costs credits like generate_image), or pass the user's uploaded photo as photo to use it as the image. Do not use for a blog article (use create_blog_article) or to schedule (use schedule_content with the returned content id).
edit_content
ChatGPTUse this when the user gives the exact new wording for a content library item: a new caption or body, title or hashtags. Replaces the text directly and returns the updated item. Free. Do not use when the user wants the team to rewrite it (use revise_content) or for a post already on the calendar (use edit_scheduled_post).
edit_image
ChatGPTUse this when the user wants to change an existing Markty image: variation (a fresh take), upscale (2x), reframe (new aspect ratio, pass aspect_ratio), background (remove, or replace as described in instructions) or edit (change something described in instructions). Pass a Markty image link from list_images or a previous result. Costs credits like the same action in Markty's Visual Studio; larger costs are quoted first. Do not use to make a new image from scratch (use generate_image).
edit_scheduled_post
ChatGPTUse this when the user wants to change the caption, hashtags or image of a post already on the calendar that has not started publishing. Its approval status does not change. Free. Do not use for items that are not scheduled (use edit_content).
fetch
ChatGPTUse this when you need the full text of a document a search call returned: a content library item, or the brand voice, strategy or daily brief document. Pass the id from search. Read-only and free.
generate_image
ChatGPTUse this when the user wants a standalone image: a product shot, a visual for a sale, a background, a banner. A brand-aware art director writes the shot brief from the brand's research, visual identity and library products; the image is rendered with the brand's colors and logo and saved to the Markty visual history. Pass the user's uploaded photo as reference_image to use it as a reference. Costs credits like the same action in the Markty app. Returns the image as a Markty card and as a link valid for 7 days. Do not use for a post that needs a caption too (use draft_social_post with include_image) or to change an existing image (use edit_image).
generate_video
ChatGPTUse this when the user wants a short video clip from a description, or wants an existing image animated (pass image_url). Costs Markty video credits priced like the Markty app, and always returns a quote first; runs only when called again with confirm set to true after the user agrees. model fast renders quicker at 720p; quality renders at 1080p and takes longer. The result arrives as a job.
get_ai_visibility
ChatGPTUse this when the user asks whether ChatGPT, Gemini, Perplexity or Google AI recommend their business, how visible they are in AI answers, or which competitors AI assistants name instead; also for a weekly background check. Returns the latest 0-100 score, the movement since the previous scan, how often each assistant names the brand, competitors and cited sources. Read-only and free; needs a plan that includes AI Visibility. Do not use to start a new scan (use run_visibility_scan).
get_brand_voice
ChatGPTUse this when you need the brand's identity, tone of voice, positioning, audience, key personas, strategy headline or active goals, for example before writing anything in the brand's name or when the user asks who their audience is. Returns the brand core from Markty's brand research. Read-only and free. Do not use to change the brand voice (use update_brand_voice).
get_content
ChatGPTUse this when you need the full text of one content library item: title, body (plain text, even for a blog article), hashtags, image links, status and, if scheduled, when. Pass a content id from list_content, search or a previous tool result. Read-only and free.
get_credit_balance
ChatGPTUse this when the user asks how many Markty credits they have, when credits reset, or whether they can afford an action. Returns credits available now, the monthly grant, rollover and purchased credits, the reset date and whether the balance is healthy, low or empty. Read-only and free. Do not use for a breakdown of what credits were spent on (use get_credit_usage).
get_credit_usage
ChatGPTUse this when the user asks what their Markty credits were spent on: usage this billing cycle (or the previous one) by action and category, the current balance and the reset date. Read-only and free.
get_daily_brief
ChatGPTUse this when the user asks what needs their attention, wants today's marketing brief, or when checking in the background (once or twice a day) whether anything needs the owner: posts waiting for approval, a disconnected channel, low credits, plus what the team finished since the last check (content produced, posts published, AI visibility movement, new reviews). Answers in one line when nothing changed, so frequent checks are cheap. Read-only and free. Do not use for a full list of scheduled posts (use list_scheduled_posts).
get_job_status
ChatGPTUse this when a Markty tool returned a job that is still working (its result carries jobId and jobKind): an image render, a video, an article, an audit, a scan or a team reply. Waits up to wait_seconds, then returns the finished result or that it is still working; call again if so. The Markty card calls it on its own. Free.
get_local_presence
ChatGPTUse this when a local business (a shop, clinic or restaurant) asks about its Google Business Profile or Google Maps: profile health, rating, review counts, latest reviews and Maps rank for tracked searches. Read-only and free. Part of the Manager plan.
get_performance_report
ChatGPTUse this when the user asks how their marketing is performing: Google Analytics website traffic (when connected) and recent Instagram and Facebook post performance. Read-only and free. Says plainly which channels are not connected.
get_search_performance
ChatGPTUse this when the user asks how their website does on Google: Search Console clicks, impressions, top search queries and the pages worth fixing. Read-only and free. Needs Google Search Console connected in Markty.
get_strategy
ChatGPTUse this when the user asks about their marketing strategy, which channels to focus on, or what their content should be about. Returns the approved digital marketing strategy: channels in priority order with their strategy, and the content themes every piece should advance. Read-only and free.
get_team_reply
ChatGPTUse this when ask_marketing_team answered that the team is still working: call it after a short wait to collect the reply, and again if it is still working. Free; it starts no work.
get_work_order
ChatGPTUse this when the user asks how a work order is going: each item's progress, what it produced and credits charged so far. Read-only and free.
list_automations
ChatGPTUse this when the user asks what Markty does for them automatically: every background automation lane, whether it is on, its price per run and when it next runs. Read-only and free.
list_connected_channels
ChatGPTUse this when you need to know which publishing channels (Instagram, Facebook, LinkedIn, Pinterest, blog) are connected for this brand, for example before scheduling, or when the user asks how to connect one. Returns each channel's state and a link to connect missing ones in Markty. Read-only and free.
list_content
ChatGPTUse this when the user wants to see what the team has made: their Markty content library of social posts, blog articles, email drafts and other content, newest first, with an excerpt of each. Read-only and free. Use get_content for the full text of one item; use search to find items by topic.
list_email_drafts
ChatGPTUse this when the user asks which email replies Markty drafted for them: reply drafts for inbound emails on their connected Gmail or Outlook, with subject, sender and the first lines. Read-only and free.
list_goals
ChatGPTUse this when the user asks about their marketing goals or targets: title, status, KPIs and target date for each. Read-only and free.
list_images
ChatGPTUse this when the user wants to see images Markty made for them, or you need an image link to edit or post: the brand's visual history, newest first, from Creative Studio, Visual Studio or here. Pass the cursor from a previous call in before to page back. Read-only and free.
list_inbox
ChatGPTUse this when the user asks what is waiting in their Markty inbox: team suggestions and finished drafts, email reply drafts, Reddit opportunities and Google reviews needing a reply. Each row has an id, kind, title, one-line summary and the tool to act on it. Read-only and free.
list_scheduled_posts
ChatGPTUse this when the user asks what is on their content calendar, what is waiting for approval, or what was published or failed. Lists scheduled, approved, published and failed posts in a date window (default: the last 7 days to the next 30), posts waiting for approval first. Read-only and free. Do not use to change a post (use reschedule_post, edit_scheduled_post, approve_scheduled_post or cancel_scheduled_post).
list_standing_orders
ChatGPTUse this when the user asks which recurring tasks the team runs for them (weekly posts, competitor checks): each standing order with its cadence and credit cost. Read-only and free.
list_updates
ChatGPTUse this when checking in the background for what changed in the customer's Markty account: posts waiting for approval, published or failed posts, finished work, new images, inbox items, AI visibility moves, new reviews and low credits. Pass the cursor from the previous call to get only what is new; an empty list means nothing changed. Read-only and free. For a person asking what needs attention, prefer get_daily_brief.
list_visibility_actions
ChatGPTUse this when the user asks what to do to be recommended more by AI assistants: the prioritized actions from the last AI visibility scan, why each matters and which ones Markty can do for them. Read-only and free.
list_workspaces
ChatGPTUse this when the user manages several brands and asks which ones exist or which one is active. Lists the workspaces (brands) on the account with their ids and marks the active one. Read-only and free. Use switch_workspace to change the active brand.
open_markty_home
ChatGPTUse this when the user wants to see or manage their marketing at a glance, or asks to open Markty: what needs their approval today, the content calendar, the content library, recent images and AI visibility, with one-tap approve and schedule. Read-only and free.
publish_post_now
ChatGPTUse this only when the user clearly says to publish a specific scheduled or failed post right now. This call is the approval and the publish decision: the post goes out publicly on the connected channel within about a minute, with no further confirmation. Free. Do not use for a post the user only wants approved for its scheduled time (use approve_scheduled_post).
quote_work_order
ChatGPTPrices a single one-off request ("write a case study about our biggest customer", "research our top 5 competitors' pricing") the same way the Markty chat quotes a work order before making it: no hold is placed yet. Returns a quote naming approve_work_order and an order_id; nothing is made or charged until that is called.
reject_scheduled_post
ChatGPTUse this when the user does not want a scheduled post to go out: works on posts waiting for approval and on approved posts that have not been published yet. The post stays on record as rejected. Do not use to remove a post from the calendar entirely (use cancel_scheduled_post).
reschedule_post
ChatGPTUse this when the user wants a scheduled post moved to a new date or time. Its approval status does not change. Free. Do not use to publish right now (use publish_post_now).
retry_failed_post
ChatGPTUse this when a post failed to publish and the user wants to try again: it is sent to publish again right away. Only works on posts whose status is failed. Free.
revise_content
ChatGPTUse this when the user wants the team to rework a content library item: a new angle, tone, length or a fix, described in instructions. Costs the same credits as the app (about 8 for a social post, 25 for a blog article). A blog article can take a while; the result then arrives as a job. Do not use for a change the user already worded (use edit_content).
run_site_audit
ChatGPTUse this when the user asks to check their website for SEO problems: crawls the site like Markty's website check-up and reports issues by page (speed, structured data, content, links, indexability) with fixes. Costs credits; larger costs are quoted first. Takes a few minutes; the result arrives as a job.
run_visibility_scan
ChatGPTUse this when the user wants fresh AI visibility results now instead of waiting for the regular scan: asks ChatGPT, Gemini, Perplexity and Google AI the brand's tracked questions and reports the score, competitors and next steps. Costs credits and always returns a quote first; runs only when called again with confirm set to true. Takes a few minutes; the result arrives as a job. Part of the Manager plan. Do not use to read the latest results (use get_ai_visibility).
schedule_content
ChatGPTUse this when the user wants to put something the team already made (a content library item) on the calendar for Instagram, Facebook, LinkedIn, Pinterest or their blog. It waits for approval like every scheduled post; nothing is published until it is approved. Instagram needs an image, on the item or passed as image_url; blog needs a connected WordPress or Wix site. Free. Do not use for text that is not in the library yet (use schedule_post).
schedule_post
ChatGPTUse this when the user wants to put new text (not yet in their content library) on the calendar for Instagram, Facebook, LinkedIn or their blog. Every post waits for approval and is not published until the user approves it. Instagram needs image_url; blog needs blog_title. Free. Do not use for an item the team already drafted (use schedule_content with its content id).
search
ChatGPTUse this when you need to find something in the customer's Markty account by topic: their content library (social posts, blog articles, drafts) and their brand voice, strategy and daily brief documents. Returns short references (id, title, url) to open with fetch. Read-only and free. Text comes back in the customer's language.
send_email_reply
ChatGPTUse this only when the user says to send a drafted email reply. It sends right away, on the owner's behalf, through their connected Gmail or Outlook, like the Markty app's send button; this call is the confirmation. Pass body to send an edited version, or omit it to send the draft as written. Refused when no mailbox is connected.
set_automation
ChatGPTUse this when the user wants a background automation turned on or off, the same switch as Markty's Automations page. Refused when the lane is not in the account's plan.
set_goal
ChatGPTUse this when the user wants to set a new marketing goal or change one (pass goal_id to update). A new goal is checked for realism like in the Markty app: an unrealistic target for the timeframe is refused with a saner alternative. Free.
switch_workspace
ChatGPTUse this when the user wants to work on a different brand (workspace) of their Markty account. Every later tool call then reads and writes that brand, and the team's conversation threads restart for it. Pass a workspace id from list_workspaces. Free.
update_brand_voice
ChatGPTUse this when the user wants to change how Markty writes for their brand: tone of voice, target audiences, what the brand should and should not do, or its summary. Pass only the fields to change. Same as editing brand voice in the Markty app. Free.
update_standing_order
ChatGPTUse this when the user wants a recurring task paused, resumed or ended. Ending stops it for good; pausing can be undone with resume. Free.
