MCP server setup guide

01What it is#

The Model Context Protocol (MCP) is an open standard that lets AI assistants call tools in other apps. Sociolark's MCP server exposes your brands, analytics and planner as tools, so you can ask questions in plain language and let the assistant do the lookups.

Access is scoped: a read key can see analytics and posts; a write key can also create and edit drafts and scheduled posts. Keys can be limited to specific brands and revoked any time from Settings → API & MCP.

02Connect Claude Code#

Create a key in Settings → API & MCP, then run:

claude mcp add --transport http sociolark https://sociolark.com/api/mcp \
  --header "Authorization: Bearer <your-api-key>"

03Connect Claude Desktop or claude.ai#

Open Settings → Connectors and choose Add custom connector.
Paste the server URL below.
Sign in to Sociolark when prompted and approve access. No key needed; you can disconnect from Settings.

https://sociolark.com/api/mcp

04Connect Cursor#

Add this to ~/.cursor/mcp.json (or your project's .cursor/mcp.json) with your key:

{
  "mcpServers": {
    "sociolark": {
      "url": "https://sociolark.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

ChatGPT and other MCP clients that support remote HTTP servers connect the same way: use the server URL and either OAuth sign-in or a bearer key.

05Tools#

Sociolark MCP tools
Tool	Scope	What it does
list_brands	read	Brands in the workspace the key can access, with timezone and connected networks.
list_accounts	read	Connected social accounts for a brand, with health and last sync time.
get_analytics	read	KPIs and daily series for a brand or account over a date range, with period-over-period deltas.
get_top_posts	read	Best-performing posts by views, reach or engagement rate.
get_best_times	read	The 7×24 best-time-to-post grid and the top three slots per network.
list_posts	read	Drafts, scheduled, published and failed posts in a date window.
create_post	write	Create a draft or scheduled post for one or more accounts. Never publishes immediately.
update_post	write	Edit the caption, targets or time of a draft or scheduled post.
cancel_post	write	Unschedule a post and return it to drafts.
create_report_link	write	Generate a PDF report for a brand and date range and return a private download link.

06Things to try#

“Summarize last week's Instagram performance for Northwind Coffee.”
“Draft 3 TikTok posts for next week at the best times.”
“Which of our YouTube videos kept viewers watching the longest this quarter?”
“Move Thursday's Facebook post to Friday at 9 am and tell me what else is scheduled that day.”

07Safety#

Write tools never publish instantly. They create drafts or scheduled posts that appear in your planner, where you can review, edit or cancel them before their time.
Every call is checked against the key's scopes, brand restrictions and your plan, exactly like a teammate's action.
Recent calls are listed in Settings → API & MCP → Recent activity, and every write is recorded in the audit log.
Free plans get read access; Pro and Agency add write access. Agency workspaces can create up to 10 keys.
If a key leaks, revoke it. It stops working immediately.