saypage
Docs menuMCP tools reference

SayPage MCP tools reference

Every tool the SayPage MCP server exposes to Claude, ChatGPT and other assistants, what each one does, and which ones change something.

Updated View as Markdown

SayPage is a remote MCP server. These are the tools it gives your assistant, grouped by what they do. You never call them yourself: your assistant picks them from what you ask. This page is for developers, and for anyone who wants to know exactly what an assistant can do with SayPage.

The server#

Property Value
URL https://api.saypage.ai/mcp
Transport Streamable HTTP
Sign-in OAuth, with a SayPage account
Tools 45, all with a title and explicit annotations
Instructions A short server description telling the assistant to start with get_account (or onboarding the first time), to read get_page_guide before writing a page, and to get the user's go-ahead before anything public

Every tool carries MCP annotations, summarized in the Effect column:

Effect Meaning Annotations
Read only Reads, changes nothing readOnlyHint: true
Saves Saves something private: a draft, an upload, a prepared post readOnlyHint: false, destructiveHint: false, openWorldHint: false
Changes May change or delete your SayPage data destructiveHint: true, openWorldHint: false
Public Visible on Instagram or the web destructiveHint: false, openWorldHint: true
Public, may be final Visible on Instagram or the web, and may replace or delete something destructiveHint: true, openWorldHint: true

Account and Instagram connection#

Tool What it does Effect
get_account The account: site address, connected Instagram accounts (and whether publishing and insights are allowed), plan limits and contacts this month Read only
onboarding How to welcome a new user, and the link to connect Instagram while none is connected Read only
connect_instagram A link to connect (or reconnect) an Instagram professional account on Instagram's own consent screen Read only
get_instagram_publishing_link A link where the user can allow publishing, on Instagram itself; turns nothing on Read only
disable_instagram_publishing Turns publishing off at once Changes

Pages#

Tool What it does Effect
get_page_guide The page guide: questions to ask, the design bar, every format rule Read only
list_libraries The open source libraries a page may load, with their exact URLs Read only
list_pages The pages, with their status (draft, published, taken down) and review state Read only
get_page A page with its current draft HTML Read only
create_page Saves a new page as a draft, and reports any issue to fix Saves
update_page Replaces a page's draft; the live page doesn't change Changes
preview_page A private preview link to the draft, valid about an hour, for the signed-in user only Saves
publish_page Publishes the draft once SayPage's checks accept it Public, may be final
unpublish_page Takes a page offline and keeps its draft Public, may be final
delete_page Deletes a page and its draft Public, may be final
claim_site Chooses the site's address, or moves it (the old address redirects for a year) Public, may be final
get_page_stats Visits per page over up to 90 days: views, daily views, sources, referring sites, countries Read only

Images#

Tool What it does Effect
request_upload_link A link where the user uploads photos, or a video, from a browser Saves
start_image_upload For assistants with a shell: a signed address to upload a local image to Saves
confirm_image_upload Finishes an upload and returns the image's reference for pages Saves
list_images The uploaded images, with the pages using each one Read only
delete_image Deletes an image no page uses Changes

Comment-to-DM automations#

Tool What it does Effect
list_automations The automations, with their post, status and links sent Read only
get_automation_activity Who an automation DMed and how far each person got, with totals Read only
create_automation Creates an automation: a keyword on a post, and the DMs that send a page or a web address Public, may be final
update_automation Changes the keyword, messages or buttons; live automations stay live Public, may be final
activate_automation Turns an automation on (or arms it for the next post) Public, may be final
pause_automation Stops it answering new comments Saves
delete_automation Deletes an automation Changes

Instagram posts and comments#

Tool What it does Effect
list_instagram_posts Recent posts, Reels and live stories, with like and comment counts Read only
get_instagram_post One post in full: caption, counts, image URL Read only
list_instagram_comments A post's comments with their replies, and which ones the account answered Read only
reply_to_instagram_comment Replies publicly under a comment, as the account Public, may be final
hide_instagram_comment Hides a comment from everyone but its author, or shows it again Public
delete_instagram_comment Deletes a comment under one of the account's posts Public, may be final

Insights#

Tool What it does Effect
get_instagram_insights Account insights over up to 30 days, and follower demographics on request Read only
get_instagram_post_insights One post's numbers Read only

Publishing (optional)#

Tool What it does Effect
prepare_instagram_post Builds a photo post, carousel or story from uploaded images, without publishing it Saves
preview_instagram_post Shows each image exactly as Instagram will get it, crop or padding included Read only
publish_instagram_post Publishes a prepared post Public, may be final
start_video_upload For assistants with a shell: a signed address to upload a local video to Saves
confirm_video_upload Finishes a video upload Saves
list_videos The uploaded videos and where each stands (uploaded, publishing, published, failed, expired) Read only
publish_instagram_video Publishes a video as a Reel or a story; it then goes out by itself Public, may be final
delete_video Deletes an uploaded video before it expires Changes

What no tool does#

There is no tool to read or send DMs outside automations, to message followers in bulk, to delete a published Instagram post, to act on another account, or to buy or change a plan.