API and MCP

Run the studio from your own tools.

Call the REST API from your own code, or connect Claude, ChatGPT and Cursor over MCP. Draft, schedule, design carousels, run your pipeline and read your analytics without opening the app.

MCP

Connected in three steps

  1. Create a key

    In the app, open Settings, then API Keys, and create a key. Choose what it may do. It is shown once, so copy it straight away.
  2. Add the server

    Point your tool at the MCP URL and send the key in an Authorization header. ChatGPT connects by sign-in instead, with no key.
  3. Ask for what you want

    Tell your assistant to draft a post, schedule it or pull the week’s outliers. It calls the tools below on your behalf.
Server URL
https://social-studio.aifirelab.com/mcp
Claude Code
claude mcp add --transport http social-studio \
  https://social-studio.aifirelab.com/mcp \
  --header "Authorization: Bearer ss_live_YOUR_KEY"
Cursor and other clients with a JSON config
{
  "mcpServers": {
    "social-studio": {
      "url": "https://social-studio.aifirelab.com/mcp",
      "headers": {
        "Authorization": "Bearer ss_live_YOUR_KEY"
      }
    }
  }
}

The transport is Streamable HTTP. ChatGPT connects by sign-in: add the URL and approve access. Actions taken through MCP use your credits exactly as the app does.

REST API

The same studio, over HTTPS

JSON in, JSON out, with an OpenAPI document. Every operation is listed with its parameters and examples in the API reference.

Scoped keys

Give a key full access, read-only access, or just the areas it needs. Set an expiry, rotate it, revoke it.

Safe to retry

Send an Idempotency-Key on a write and a retry replays the first answer instead of publishing twice.

One error shape

Every failure has a stable code, a plain message and a request id, with a matching HTTP status.
Base URL
https://social-studio.aifirelab.com/api/v1
Check a key
curl https://social-studio.aifirelab.com/api/v1/me \
  -H "Authorization: Bearer ss_live_YOUR_KEY"
Draft a post, then schedule it
# a draft from your own caption
curl -X POST https://social-studio.aifirelab.com/api/v1/posts \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"title": "Launch day", "caption": "We are live."}'

# schedule it to a connected account
curl -X POST https://social-studio.aifirelab.com/api/v1/posts/TASK_ID/schedule \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: launch-day-1" \
  -d '{"platform_ids": ["PLATFORM_ID"], "scheduled_at": "2026-12-01T14:30:00+05:30"}'

Tools

What your assistant can do

Named tools for the everyday jobs, and three that reach every other operation of the API. A key limited to some scopes only sees the tools those scopes allow. The full list is in the API reference.

Account

  • get_credit_balanceWho you are signed in as and how many credits are left.
  • list_workspacesYour workspaces.
  • list_platformsThe social accounts connected in a workspace.

Posts

  • create_postGenerate AI-written drafts with caption, hashtags and an optional image.
  • create_manual_postCreate a draft from content you already have, with no generation.
  • list_draftsDraft posts that are not scheduled yet.
  • get_postOne post in full, with its copy and media.
  • update_postEdit a draft’s caption, hashtags or image prompt.
  • delete_postDelete a post.

Publishing

  • schedule_postSchedule a draft to publish at a future time.
  • post_nowPublish a draft immediately.
  • list_scheduled_postsScheduled and recently processed posts.
  • reschedule_postMove a scheduled post to a new time.
  • retry_failed_postTry a failed post again.
  • cancel_scheduled_postCancel a post that has not gone out yet.

Media and images

  • upload_mediaUpload an image or video and get a media id to attach.
  • list_pending_mediaUploads not yet attached to a draft.
  • get_post_imageView a draft’s current image.
  • generate_post_imageGenerate a fresh image for a draft.
  • edit_post_imageEdit the image already on a draft.
  • undo_post_imageRestore the previous image.

Carousels

  • create_carouselGenerate a multi-slide carousel from a topic or brief.
  • wait_for_carouselWait for one that is still generating.
  • list_carouselsCarousels in a workspace, newest first.
  • get_carouselOne carousel in full, with its slides and assets.
  • edit_carouselChange a carousel by telling the agent what to change.

Scripts, ideas and pipelines

  • generate_scriptWrite a short-form video script for a topic or an idea.
  • edit_scriptRevise a script by instruction.
  • create_ideaAdd an idea card.
  • save_idea_from_urlCapture a post or video link as an idea card.
  • get_pipeline_boardA pipeline’s stages and the cards in each.
  • move_ideaMove a card to another stage.

Creative Studio and brand

  • generate_creative_imageGenerate images with the studio’s models.
  • generate_creative_videoGenerate a video from a prompt or an image.
  • get_brandYour brand profile.
  • update_brandEdit the brand profile.

Analytics and research

  • get_analytics_overviewFollowers, reach and engagement over a period.
  • get_best_posting_timesWhen your audience is most active.
  • list_competitorsThe competitors you track.
  • get_competitorA competitor’s profile and numbers.

Inbox and automation

  • list_conversationsDM conversations across your connected accounts.
  • draft_replyAn AI-suggested reply to edit and send.
  • send_messageSend a message in a conversation.
  • create_automation_ruleReply to a comment keyword with a comment or a DM.

Outliers

  • list_outlier_channelsThe creators on your watchlist.
  • add_outlier_channelAdd a creator to the watchlist.
  • get_outlier_feedRecent posts ranked by outlier score.

Everything else

  • search_apiFind any operation by what you want to do.
  • describe_api_operationSee an operation’s inputs before calling it.
  • call_apiRun any operation of the REST API as a tool.

Build on Social Studio

Create an account, make a key in Settings and connect your first tool in a few minutes.

  • No expiry
    On credits
  • 100 credits
    To start, free
  • Unlimited
    Scheduling