Developers

Build on SocialPatra.

Two ways in. A REST API with scoped keys for your own code, and a hosted MCP server that lets AI assistants draft, schedule and report inside your workspace.

Developer API

For scripts, backends and automation tools.

1 Open Workspace › Settings › API keys and create a key. Give it only the scopes it needs. The key is shown once.
2 Send it in the X-API-Key header. A key belongs to one workspace and only sees that workspace's accounts and data.
3Publish, schedule and pull analytics from your own code. Rate limits and expiry are per key.

curl https://api.socialpatra.com/api/v1/socialpatra/auth/whoami \
  -H "X-API-Key: sp_live_…"

Read the API guide Create an API key

MCP for AI assistants

For Claude, ChatGPT and any client that supports remote MCP servers.

1In your assistant, add a custom connector with the URL below.
2 Sign in when prompted, pick the workspace and approve the scopes. The connection is bound to that one workspace.
3Ask for a draft, a schedule or a performance report. The assistant uses the tools listed below.

https://mcp.socialpatra.com/mcp

Connecting or disconnecting social accounts stays in the web app; assistants can read, post and report, never change what is connected.

What an assistant can do

Every tool maps to a scope. You grant scopes at consent; a key or connection never gets more than you approved.

Tool	What it does	Scope
whoami	Verify the connection: user, workspace, granted scopes	`any`
list_connections	List connected social accounts	`connections:read`
check_connection_health	Find accounts that need a reconnect	`connections:read`
create_post	Create, publish or schedule a post to selected accounts	`posts:write, media:upload`
list_drafts	List draft posts	`posts:read`
get_top_performing_posts	Best posts by engagement	`posts:read`
get_post_status	Live per-platform status of a post	`posts:read`
get_analytics_dashboard	Workspace metrics over a date range	`analytics:read`
search_content_library	Search reusable content and templates	`any`
save_to_content_library	Save a plan, report or snippet for reuse	`any`

connections:readanalytics:readposts:readposts:writemedia:uploadcontent:readcontent:write