MCP server

Tools reference

Every MCP tool with its arguments and scope.

Tools return JSON in structuredContent and the same JSON as text. Input mistakes come back as a result with isError: true so the assistant can fix them.

list_accounts

Connected accounts. No arguments. Scope read.

get_briefing

The latest daily briefing: headline, summary, needs_you, wins, concerns and actions. No arguments. Scope read.

get_analytics

Parameters
days7 | 30 | 90 | 365
Window, default 30. Limited by your plan history.
platforminstagram | facebook | tiktok | linkedin
Only one network.

get_ads_summary

Parameters
daysinteger 1-365
Window, default 30.

list_posts

Parameters
fromISO date-time
Default 7 days ago.
toISO date-time
Default 30 days ahead.
statusstring
draft, in_review, approved, scheduled, publishing, published, needs_action or failed.

list_comments

Parameters
viewneeds_reply | buying | complaints | questions | all
Default needs_reply.
limitinteger 1-50
Default 20.

list_competitors

No arguments. Scope read.

get_guardian_status

Connections, problem posts and the 7 day on time rate. No arguments. Scope read.

list_pending_actions

No arguments. Scope read.

create_draft_post

Parameters
platforminstagram | facebook | tiktok | linkedinrequired
Must be connected in ZieAds.
captionstring, max 2200required
Post text.
scheduled_forISO date-time
When it goes out after approval.
media_urlhttps URL
Public image or video.
first_commentstring
Posted as the first comment.

draft_comment_reply

Parameters
comment_idstringrequired
From list_comments.
textstring, max 2200required
Reply text.

add_competitor

Parameters
namestringrequired
Brand name.
website_urlstring
Website.
instagram_usernamestring
With or without @.