late-social-mcp

late-social-mcp

Comprehensive social media management MCP server via Late API

What is this?

late-social-mcp is a standalone Model Context Protocol (MCP) server for managing social media through the Late API. It uses direct HTTP calls to the Late API — no SDK dependency — for maximum control and minimal footprint. It is not a Copilot extension or plugin — it's a general-purpose MCP server that works with any MCP-compatible client:

• GitHub Copilot CLI / VS Code
• Claude Desktop
• Cursor
• Any other MCP client

It exposes 47 MCP tools across 13 categories — covering posts, scheduling, smart realignment, analytics, engagement (messages, comments, reviews), media, webhooks, and more.

Quick Start

Install

npm install -g late-social-mcp

Set your API key

export LATE_API_KEY=your_api_key_here

Get your API key from getlate.dev.

MCP Client Configuration

Copilot CLI / VS Code

Add to your .mcp.json:

{
  "servers": {
    "late-social-mcp": {
      "command": "npx",
      "args": ["-y", "late-social-mcp"]
    }
  }
}

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "late-social-mcp": {
      "command": "npx",
      "args": ["-y", "late-social-mcp"],
      "env": {
        "LATE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Tool Reference

47 tools organized into 13 categories:

#	Category	Tools	Tool Names
1	Setup & Config	3	setup_late, late_status, import_schedule_config
2	Posts	8	list_posts, get_post, create_post, update_post, delete_post, retry_post, unpublish_post, bulk_upload_posts
3	Scheduling	4	schedule_post, find_next_slot, view_calendar, view_schedule_config
4	Smart Features	7	realign_schedule, prioritized_realign, check_realign_status, smart_reschedule, get_best_times, get_posting_frequency, get_content_decay
5	Queue	5	list_queues, create_queue, update_queue, delete_queue, preview_queue_slots
6	Analytics	5	get_post_analytics, get_daily_metrics, get_follower_stats, get_post_timeline, get_youtube_daily_views
7	Messages	5	list_conversations, get_conversation, list_messages, send_message, edit_message
8	Comments	7	list_commented_posts, get_post_comments, reply_to_comment, delete_comment, hide_comment, like_comment, send_private_reply
9	Reviews	3	list_reviews, reply_to_review, delete_review_reply
10	Accounts	4	list_accounts, check_account_health, list_profiles, get_usage_stats
11	Media & Validation	5	upload_media, validate_media, validate_post, validate_post_length, check_instagram_hashtags
12	Webhooks	4	list_webhooks, create_webhook, update_webhook, test_webhook
13	Logs	3	get_post_logs, list_publishing_logs, list_connection_logs

Schedule Config

Create a schedule.json in your working directory to define your posting schedule. The server uses this for slot-based scheduling, realignment, and conflict detection.

{
  "timezone": "America/Chicago",
  "platforms": {
    "x": {
      "slots": [
        { "days": ["mon", "wed", "fri"], "time": "09:00", "label": "Morning post" },
        { "days": ["tue", "thu"], "time": "14:00", "label": "Afternoon post" }
      ],
      "avoidDays": ["sat", "sun"],
      "byClipType": {
        "short": {
          "slots": [{ "days": ["mon", "tue", "wed", "thu", "fri"], "time": "12:00", "label": "Noon short" }],
          "avoidDays": []
        }
      }
    }
  }
}

Fields:

• timezone — IANA timezone for all slot times (e.g. America/Chicago, UTC)
• platforms — Per-platform schedule configuration, keyed by platform name (x, instagram, youtube, etc.)
  • slots — Array of time slots with days (day abbreviations), time (HH:MM 24h), and optional label
  • avoidDays — Days to skip when scheduling (e.g. weekends)
  • byClipType — Override slots for specific content types (e.g. short, reel)

Import an existing config into the server with import_schedule_config, or view the active config with view_schedule_config.

Smart Features

Realignment

realign_schedule compacts your posting schedule by filling gaps left by deleted or failed posts. It shifts pending posts forward to maintain a consistent cadence without changing their relative order.

Prioritized Realignment

prioritized_realign extends realignment with keyword-based priority scoring and saturation probability. Posts matching priority keywords are scheduled into prime slots first. Saturation probability controls how aggressively lower-priority posts fill remaining slots.

Smart Rescheduling

smart_reschedule detects scheduling conflicts (multiple posts in the same slot, overlapping windows) and automatically resolves them by redistributing posts to nearby available slots.

Best Times

get_best_times analyzes your historical engagement data to recommend optimal posting times per platform.

Posting Frequency

get_posting_frequency determines the ideal posting cadence for each platform based on engagement trends and audience behavior.

Content Decay

get_content_decay measures how quickly engagement drops off after publishing, helping you understand the effective lifespan of your content per platform.

Configuration

Config	Source	Description
LATE_API_KEY	Environment variable	Required. Your Late API key
./late-social-mcp.config.json	Auto-generated file	Persistent server config (account selections, preferences)
./schedule.json	User-created file	Schedule configuration (optional)

All configuration files are CWD-relative — the server reads and writes config in whichever directory you run it from.

Development

git clone https://github.com/htekdev/late-social-mcp.git
cd late-social-mcp
npm install
npm run build
npm test

Scripts

Command	Description
npm run build	Bundle with esbuild to bin/mcp-server.cjs
npm test	Run tests with vitest
npm run test:coverage	Run tests with coverage report
npm run test:watch	Run tests in watch mode
npm run typecheck	Type-check with TypeScript (no emit)

Project Structure

src/
├── server.ts           # MCP server entry point
├── client/             # Direct HTTP client for Late API
├── config/             # Configuration management
├── types/              # Shared TypeScript types
├── smart/              # Smart feature logic (realignment, scheduling, optimization)
│   ├── realignment.ts
│   ├── prioritizedRealignment.ts
│   ├── scheduler.ts
│   └── optimizer.ts
└── tools/              # MCP tool definitions
    ├── setup.ts
    ├── posts.ts
    ├── scheduling.ts
    ├── queue.ts
    ├── analytics.ts
    ├── media.ts
    ├── validate.ts
    ├── accounts.ts
    ├── webhooks.ts
    ├── logs.ts
    ├── smart/          # Smart feature tool wrappers
    │   ├── realign.ts
    │   ├── reschedule.ts
    │   └── optimize.ts
    └── engagement/     # Engagement tool wrappers
        ├── messages.ts
        ├── comments.ts
        └── reviews.ts

License

MIT © Hector Flores