Developers

Suara MCP docs

Suara's MCP server connects ChatGPT to Suara. This page covers the address, how to connect, sign-in, every tool and the limits.

Overview

With Suara in your assistant you can make free sample posts and check holidays, festive calendars, posting times, trending music, review reply templates and the Restaurant Index without an account. After you sign in, you can see your brand, this week's posts and how they did, approve or move posts, add photos and style notes, and send requests to the Suara team.

Suara has no public REST API and no API keys. The MCP server below is the way apps connect to Suara.

Address

https://trysuara.com/mcp

MCP over Streamable HTTP: JSON-RPC 2.0 in a single POST, with no session to keep. Supported protocol versions: 2025-11-25, 2025-06-18 and 2025-03-26. Opening the address in a browser shows a short page for people instead.

Try it

List the tools from a terminal. No account is needed for this.

curl -s https://trysuara.com/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Nothing is posted without the owner's yes. Two tools can publish, both marked as ones that can't be undone: approve_post, which the assistant uses only when the owner has clearly said to approve that post, and reschedule_post, which only works on a post already approved and shows the change and waits for a yes first.

Connect

ChatGPT

  1. In ChatGPT's settings, turn on Developer mode (it lets you add an app by its address).
  2. Add a new app and paste https://trysuara.com/mcp.
  3. Ask for 3 sample posts for your business, no account needed. To see your own week, sign in when ChatGPT asks.

Other MCP apps

Any app that speaks MCP over HTTP can use the address. The no-account tools work without sign-in. Signing in needs an app that supports OAuth with PKCE; we have only tested sign-in in ChatGPT.

Suara isn't in the ChatGPT app directory yet, so for now it's added by its address.

Sign-in and privacy

  • An email code, no password. When a tool needs your account, your assistant opens Suara's sign-in. You type your email and we send a 6-digit code. New to Suara? After the code, it asks about your business and sets up your account.
  • One business per sign-in. Your access names one business. A tool can't reach another business's brand or posts, whatever it's asked.
  • Your social passwords stay with the platform. Connecting Instagram, Facebook or TikTok happens on the platform's own login page. Instagram must be a Business or Creator account.
  • What we keep. For each tool call: which tool, which app, whether it worked, and when. Not your words and not the answer. Requests you send with send_to_suara or request_post_change, photos you add with add_photo and notes you save with add_style_note stay with your Suara account so the team can act on them, and partner applications go to the team. Sample pictures are shared through links that expire after 7 days.
  • Disconnect any time. Remove Suara in your assistant's settings. Your Suara account and posts stay until you ask us to delete them.

The full details are in our Privacy Policy. Questions: Support.

Tools

26 tools. This list is read from the server's own tool list, so it is always current. "Changes anything" says what a call does beyond reading.

No account needed (8)

ToolWhat it doesAccountChanges anything
apply_as_partner Sends an application to Suara's partner program, only after you've seen every detail and said yes.
Inputs
  • name required string
    The person's full name
  • email required string
    Their email, where Suara will reply
  • country required one of: Malaysia, Singapore, Canada, Australia, Brunei, Hong Kong, India, Indonesia, Ireland, Japan, New Zealand, Philippines, Qatar, Saudi Arabia, South Korea, Taiwan, Thailand, United Arab Emirates, United Kingdom, United States, Vietnam, Another country, Other
    Where they are. 'Another country' if theirs isn't listed.
  • channel required string
    Their main channel link, e.g. instagram.com/theirname, a TikTok, YouTube, newsletter or website
  • other_links string
    Other channels or links, optional
  • audience_size required one of: under 1K, 1-5K, 5-20K, 20-100K, 100K+
    Rough audience size
  • audiences required list
    Who their audience is (pick any that fit)
  • role required one of: SME educator or coach, Owner-creator, Freelance social media manager, Agency, Other
    What they do
  • how_you_will_share required string
    How they'd share Suara, in their words: a reel, a newsletter, a talk, a word with clients...
  • handle required string
    The handle they want in their link (trysuara.com/app/start/?src=creator-<handle>): 2 to 30 lowercase letters, numbers, _ or -
  • business string
    Their own business's Instagram or website if they'd like Suara for it, optional
  • agrees_to_rules required boolean
    True only if they said they'll disclose the commission and follow the partner rules
  • confirmed required boolean
    True only after they saw every detail above and explicitly said to send it
Not needed Sends an application to the Suara team.
make_sample_posts Makes 3 sample posts for a business you own or work for, from its own website or up to 3 photos you add in the chat.
Inputs
  • business_name required string
    The business's name
  • website string
    The business's own website (https), optional if photos are given
  • photos list
    Up to 3 photos of the business uploaded in the chat
  • city string
    Where the business is, optional
  • language string
    Language for the captions, optional (default: the business's own)
  • what_to_promote string
    Something to feature in one post, optional (e.g. weekend brunch)
Not needed Makes a sample. Posts nothing.
trending_audio This week's songs charting on both Apple Music and Spotify in one of 10 countries, with each app's rule for business accounts.
Inputs
  • country required string
    Country name or 2-letter code, e.g. Malaysia or MY
  • platform one of: instagram, tiktok, any
    Which app the post is for (changes the business-account rule shown). Default any.
  • limit integer
    How many songs (default 10)
Not needed No, read only.
holiday_calendar Public holidays, state holidays and big shopping days for 10 countries, checked against the official list.
Inputs
  • country required string
    Country name or 2-letter code, e.g. Malaysia or MY
  • from string
    Start date YYYY-MM-DD, optional (default today)
  • to string
    End date YYYY-MM-DD, optional (default a year from the start)
Not needed No, read only.
best_time_to_post Posting windows for 15 cities where two 2026 studies agree, plus what Suara measured itself.
Inputs
  • city string
    City or country, e.g. Kuala Lumpur, KL, Toronto or Malaysia
  • platform string
    instagram, facebook or tiktok; optional (all three when left out)
  • category string
    Kind of business, e.g. cafe or salon; optional
Not needed No, read only.
festive_calendar When to start posting for each festival and holiday in Malaysia, Canada or Brunei, and what to post.
Inputs
  • country required one of: Malaysia, Canada, Brunei
    Which calendar
  • from string
    Start date YYYY-MM-DD, optional (default today)
  • to string
    End date YYYY-MM-DD, optional (default a year from the start)
Not needed No, read only.
review_reply_templates Reply templates for customer reviews, good or bad, with the rules for a good reply.
Inputs
  • situation string
    What the review is about, optional, e.g. '5 stars no words', 'food was cold', 'rude review'. Leave out to see every situation.
Not needed No, read only.
restaurant_index How restaurants and cafes use Instagram in 10 cities, from real public posts.
Inputs
  • city string
    One of the 10 cities, optional (leave out for all 10)
Not needed No, read only.

After you sign in (18)

ToolWhat it doesAccountChanges anything
get_my_brand Your brand as Suara has it: name, voice, audience, colours, what you sell and the notes you gave. Sign in No, read only.
get_my_posts This week's posts with captions, days and status, shown with every slide.
Inputs
  • postId string
    Only this post (with every carousel slide)
  • images boolean
    Also attach the pictures to the answer (default false: the Suara viewer shows them)
Sign in No, read only.
send_to_suara Sends a request or a change to the Suara team. Nothing changes right away; they reply later.
Inputs
  • message required string
    What the owner wants, in full
  • postId string
    The post it's about, if any
Sign in Sends a message to the Suara team.
get_suara_replies The Suara team's replies and updates from the last 7 days (up to 30).
Inputs
  • days number
    How many days back (default 7, max 30)
Sign in No, read only.
approve_post Approves one post you've seen and schedules it on your connected accounts.
Inputs
  • postId required string
    The post to approve
  • when one of: its_day, now
    its_day (default): its planned day at their usual time. now: right away.
Sign in Yes: publishes a post. It can't be undone from the chat.
connect_social_account A link, valid for an hour, to connect Instagram, a Facebook Page or TikTok on the platform's own login page.
Inputs
  • platform required one of: instagram, facebook, tiktok
Sign in Gives you a link. Nothing is posted.
my_social_accounts Which social accounts Suara can post to. Sign in No, read only.
my_instagram_insights What works on your own public Instagram: when you post, which posts do better, recurring themes. Sign in No, read only.
post_stats Reach, likes, comments, saves and shares for each post Suara published for you, up to 30 days back.
Inputs
  • days integer
    How many days back (default 7)
Sign in No, read only.
get_my_week This week's posts as a list: day, time, platforms and where each one stands. Sign in No, read only.
reschedule_post Moves an approved post to a new time, or books one. It shows you the change first and waits for your yes.
Inputs
  • postId required string
    The post to move
  • when required string
    The new time in the business's own timezone as YYYY-MM-DDTHH:MM (e.g. 2026-11-07T19:00), or now
  • confirm boolean
    True only after the owner saw what will change and said yes
Sign in Yes: changes when a post goes out. Choosing now can't be undone.
cancel_post Cancels a booked post. It shows you what would be cancelled first and waits for your yes. The post stays approved.
Inputs
  • postId required string
    The post to cancel
  • confirm boolean
    True only after the owner saw what will be cancelled and said yes
Sign in Yes: the post will not go out.
add_photo Adds a photo you upload or link to your Suara library. Nothing is posted.
Inputs
  • photo object
    A photo uploaded in the chat
  • url string
    Or a public https link straight to the image file
  • note string
    What it shows or how to use it, optional, in the owner's words
Sign in Adds a photo to your library.
request_post_change Asks for a change to one specific post. It comes back for you to review.
Inputs
  • postId required string
    The post to change
  • change required string
    Exactly what the owner wants changed, in their words
Sign in Sends the change to your assistant or designer.
add_style_note Saves a lasting note like "less pink" for all your future posts. The 8 newest notes are kept.
Inputs
  • note required string
    The correction, short, in the owner's words
Sign in Saves a note on your brand.
my_plan Whether you are paying, since when, and what your plan includes this week. Sign in No, read only.
studio_status Where your requests to the Suara design team stand.
Inputs
  • include_finished boolean
    Also show requests finished in the last 14 days
Sign in No, read only.
my_best_times The time your posts go out and what it rests on: your own results when there are enough, otherwise a study. Sign in No, read only.

Limits

WhatLimitNotes
Tool calls30 a minute, no hourly capPer person: the id ChatGPT sends for you, your business when signed in, or else your connection. Connecting and listing tools (initialize, tools/list, ping) never count. Over it, the call returns a rate_limited error with retryAfterSeconds.
Time per call60 secondsA slower call stops and says to try again. The free sample keeps going in the background; ask again for it.
Free sampleOne a day per personCounted per Malaysia day, by the id ChatGPT sends; apps that send none share one. Samples can also pause when the monthly sample budget runs out.
Partner applications10 a day per personCounted per day (UTC).
Sign-in codes6 per email and 20 per internet address a dayThe sign-in page expires after 15 minutes; 5 wrong codes and you start again.
Access1 hour, renewed for up to 60 daysYour assistant renews it on its own. After 60 days without use, sign in again.
Connect links1 hourFrom connect_social_account.

Countries and cities: holidays and trending music cover Malaysia, Singapore, Indonesia, Philippines, Thailand, United States, Canada, United Kingdom, Australia and the UAE. Posting times cover Kuala Lumpur, Penang, Johor Bahru, Singapore, Jakarta, Manila, Bangkok, New York, Los Angeles, Toronto, Vancouver, London, Sydney, Melbourne and Dubai.

Tool list read live. Page checked against the server on 2026-11-03.