MCP

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 MCP-capable client: Claude.ai, Claude Desktop, Claude Code, Cursor, ChatGPT, Windsurf, or any MCP client.

Connect with OAuth (recommended)

The server supports OAuth 2.1 sign-in (MCP spec authorization) — no API key needed. This is the only way to connect from claude.ai custom connectors, and the easiest everywhere else:

Add a custom connector / MCP server with the URL https://mcp.smartlyq.com/mcp.
Your client opens a SmartlyQ sign-in window. Log in, pick the workspace to connect, and tick the permissions you want to grant.
Approve — you’re connected. Revoke anytime from Settings > Developer API (the connection appears as an API key).

Claude Code (CLI)

claude mcp add smartlyq --transport http https://mcp.smartlyq.com/mcp
# Claude Code walks you through the SmartlyQ sign-in on first use.

Connect with an API key

Alternatively, authenticate with a SmartlyQ API key (sqk_live_...) from the Developer Dashboard — with the scopes you need enabled (see Scopes below) — passed as a Bearer token.

{
  "mcpServers": {
    "smartlyq": {
      "type": "http",
      "url": "https://mcp.smartlyq.com/mcp",
      "headers": { "Authorization": "Bearer sqk_live_xxxxxxxxxxxx" }
    }
  }
}

claude mcp add smartlyq \
  --transport http https://mcp.smartlyq.com/mcp \
  --header "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.”

Managing connections

Every OAuth connection is listed in the SmartlyQ dashboard under Settings → Developer API → Connections (“Connected AI clients”). Each entry shows the client, the workspace, the permissions you granted, and when it was last used, with a Disconnect button that revokes the app’s access immediately.

Disconnecting is instant and irreversible — the app must sign in again to reconnect. API-key connections are managed separately under the API Keys tab.

Available tools

Tool	What it does	Scope
`list_social_accounts`	List connected social accounts	`social:read`
`create_social_post`	Publish a post immediately	`social:write`
`schedule_social_post`	Schedule a post for later	`social:write`
`list_social_posts`	List posts (filter by status/platform)	`social:read`
`retry_social_post`	Re-attempt publishing on given platforms	`social:write`
`disconnect_social_account`	Disconnect a connected account	`social:write`
`get_account_health`	Token validity/status of an account	`social:read`
`get_account_reconnect_url`	URL to re-authenticate an account	`social:read`
`pause_social_account` / `resume_social_account`	Pause/resume posting to an account	`social:write`
`list_comments`	List comments on your posts	`social:read`
`reply_to_comment`	Reply to a comment (posts to platform)	`social:write`
`hide_comment` / `delete_comment`	Hide or delete a comment	`social:write`
`list_conversations`	List DM conversations	`social:read`
`list_messages`	List messages in a conversation	`social:read`
`send_direct_message`	Send a DM (within platform window)	`social:write`
`mark_conversation_read`	Mark a conversation read	`social:write`
`list_webhooks`	List webhook subscriptions + available events	`webhooks:read`
`create_webhook`	Subscribe an HTTPS URL to events	`webhooks:write`
`delete_webhook`	Delete a webhook subscription	`webhooks:write`
`get_analytics_overview`	Likes/impressions/clicks/views overview	`analytics:read`
`rewrite_content`	Rewrite/rephrase text	`articles:write`
`generate_article`	Generate a long-form article	`articles:write`
`generate_image`	Generate an image	`images:write`
`list_video_models`	List video models + options	`videos:read`
`generate_video`	Generate a video	`videos:write`
`text_to_speech`	Convert text to speech	`audio:write`
`generate_presentation`	Generate a complete AI presentation deck from a prompt	`presentations:write`
`get_job`	Get an async job’s status/result	`jobs:read`
`list_jobs`	List async jobs	`jobs:read`

The full API catalog (operations facade)

Beyond the curated tools above, three facade tools expose every operation in the SmartlyQ API (100+ operations across Chatbot, Media, Short URLs, AI Captain, Account, and more) without flooding the model’s context:

Tool	What it does
`search_operations`	Find operations by intent (“shorten a url”, “train chatbot”)
`describe_operation`	Full parameter/body docs for one operation
`execute_operation`	Run it — write/delete operations require an explicit `confirm: true`

The agent discovers what it needs (search_operations → describe_operation → execute_operation); scopes, rate limits, and billing apply exactly as for direct API calls.

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. The long SEO lookups (/seo/site-audit, /seo/rank-history, /seo/brand-lookup, /seo/prompt-explorer) are also async on the REST API (202 + job_uid). Over MCP you don’t need to do anything: the MCP server waits for these jobs internally and returns the finished result as a normal tool response (30s-2min). If the wait budget is exceeded you receive the job_uid to poll with get_job.

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.

SDKs & CLI

Guides

Prerequisites

Connect with OAuth (recommended)

Connect with an API key

Managing connections

Available tools

The full API catalog (operations facade)

Tool scopes

Async generation

Webhooks

Billing

Security

​Prerequisites

​Connect with OAuth (recommended)

​Connect with an API key

​Managing connections

​Available tools

​The full API catalog (operations facade)

​Tool scopes

​Async generation

​Webhooks

​Billing

​Security

Prerequisites

Connect with OAuth (recommended)

Connect with an API key

Managing connections

Available tools

The full API catalog (operations facade)

Tool scopes

Async generation

Webhooks

Billing

Security