Skip to main content
SmartlyQ ships a hosted MCP (Model Context Protocol) server. MCP is the open standard that lets AI assistants use external tools. With it, an AI agent can post to your socials, generate content, and read analytics on your SmartlyQ account — just by asking.
Server URL
https://mcp.smartlyq.com/mcp

​
Prerequisites

  • A SmartlyQ account on a Pro plan or higher (API access requires Pro+).
  • An API key (sqk_live_...) from the Developer Dashboard, with the scopes you need enabled (see Scopes below).
  • An MCP-capable client: Claude Desktop, Claude Code, Cursor, ChatGPT, Windsurf, or any MCP client.

​
Connect

The server authenticates with your SmartlyQ API key, passed as a Bearer token. 
{
  "mcpServers": {
    "smartlyq": {
      "type": "http",
      "url": "https://mcp.smartlyq.com/mcp",
      "headers": { "Authorization": "Bearer sqk_live_xxxxxxxxxxxx" }
    }
  }
}
Once connected, try a prompt like:
“List my connected social accounts, then draft and schedule a launch post across all of them for tomorrow at 9am.”

​
Available tools

ToolWhat it doesScope
list_social_accountsList connected social accountssocial:read
create_social_postPublish a post immediatelysocial:write
schedule_social_postSchedule a post for latersocial:write
list_social_postsList posts (filter by status/platform)social:read
retry_social_postRe-attempt publishing on given platformssocial:write
disconnect_social_accountDisconnect a connected accountsocial:write
get_account_healthToken validity/status of an accountsocial:read
get_account_reconnect_urlURL to re-authenticate an accountsocial:read
pause_social_account / resume_social_accountPause/resume posting to an accountsocial:write
list_commentsList comments on your postssocial:read
reply_to_commentReply to a comment (posts to platform)social:write
hide_comment / delete_commentHide or delete a commentsocial:write
list_conversationsList DM conversationssocial:read
list_messagesList messages in a conversationsocial:read
send_direct_messageSend a DM (within platform window)social:write
mark_conversation_readMark a conversation readsocial:write
list_webhooksList webhook subscriptions + available eventswebhooks:read
create_webhookSubscribe an HTTPS URL to eventswebhooks:write
delete_webhookDelete a webhook subscriptionwebhooks:write
get_analytics_overviewLikes/impressions/clicks/views overviewanalytics:read
rewrite_contentRewrite/rephrase textarticles:write
generate_articleGenerate a long-form articlearticles:write
generate_imageGenerate an imageimages:write
list_video_modelsList video models + optionsvideos:read
generate_videoGenerate a videovideos:write
text_to_speechConvert text to speechaudio:write
get_jobGet an async job’s status/resultjobs:read
list_jobsList async jobsjobs:read

​
Tool scopes

Each tool requires the matching scope on your API key. Enable them in the Developer Dashboard. If a key lacks a scope, the tool returns: 
SmartlyQ API error (HTTP 403) — code: INSUFFICIENT_SCOPE — API key lacks required scope: social:read

​
Async generation

Content generation tools (generate_article, generate_image, generate_video, text_to_speech) run asynchronously and return a job id. The agent should poll get_job until the job’s status is completed to retrieve the result. See Async jobs.

​
Webhooks

Subscribe an HTTPS endpoint to events with create_webhook (or POST /webhooks) so your agent reacts to posts publishing, comments arriving, or jobs finishing. Deliveries are HMAC-signed and retried with backoff — see the full Webhooks guide for the event list, signature verification, and retry policy.

​
Billing

MCP calls are ordinary API calls under the hood, so the same billing and credits and rate limits apply. The MCP layer adds no extra charges and grants no extra access — everything is governed by your API key.

​
Security

  • Treat your API key like a password. If it leaks, rotate it in the Developer Dashboard.
  • The server forwards your key to the SmartlyQ API per request and stores nothing.