Markty

Use 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_team_reply

Use 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_blog_article

Use 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_product_photos

Turns 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.

create_standing_order

Use 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.

set_goal

Use 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).

delete_content

Use 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_review_reply

Use 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).

draft_social_post

Use 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).

edit_scheduled_post

Use 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_image

Use 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_content

Use 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.

fetch

Use 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_image

Use 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.

generate_video

Use 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_ai_visibility

Use 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_search_performance

Use 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_performance_report

Use 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_brand_voice

Use 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_content

Use 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_balance

Use 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_credit_usage

Use 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_strategy

Use 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_local_presence

Use 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_daily_brief

Use 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_visibility_actions

Use 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_automations

Use 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_connected_channels

Use 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_content

Use 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_email_drafts

Use this when the user asks about their marketing goals or targets: title, status, KPIs and target date for each. Read-only and free.

list_goals

Use 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_images

Use 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_scheduled_posts

Use 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_standing_orders

Use 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_inbox

Use 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_updates

Use 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.

list_workspaces

Use 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.

open_markty_home

Use this when the user wants a recurring task paused, resumed or ended. Ending stops it for good; pausing can be undone with resume. Free.

update_standing_order

Lays 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_content_plan

Use 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).

publish_post_now