MCP Server

Aether ships an MCP (Model Context Protocol) server that exposes API workflows as callable tools for AI clients.

Coverage

MCP covers profiles, posts, inbox, and analytics. Queues and automations are not yet exposed as MCP tools — use the REST API or dashboard.

V1 connect + publish: Instagram, Facebook, Threads, TikTok, and LinkedIn. Inbox and analytics tools are useful for Instagram and Facebook today; other platforms' inbox and analytics are on the roadmap.

Installation (stdio)

{
  "mcpServers": {
    "aether": {
      "command": "npx",
      "args": ["@aether/mcp"],
      "env": {
        "AETHER_API_KEY": "aeth_live_your_key_here",
        "AETHER_API_URL": "https://api.aetherhq.dev/v1"
      }
    }
  }
}

Claude Desktop setup

Open Claude Desktop settings
Navigate to Developer → MCP Servers
Add the configuration above
Restart Claude Desktop

Available tools (20)

Profiles

Tool	Description
`list_profiles`	List connected social profiles
`get_profile`	Get a profile by ID
`disconnect_profile`	Disconnect a profile
`create_connect_link`	Generate a Connect Link URL

Posts

Tool	Description
`create_post`	Create a draft, scheduled, or immediate post
`list_posts`	List posts with filters
`get_post`	Get post by ID
`update_post`	Update a scheduled post
`cancel_post`	Cancel a scheduled post
`publish_post`	Create and publish immediately
`schedule_post`	Create and schedule for a time

Inbox

Tool	Description
`list_messages`	List inbox messages
`mark_message_read`	Mark a message read
`get_inbox_summary`	Summarize unread messages
`reply_to_message`	Reply to a DM or comment

Analytics

Tool	Description
`get_post_analytics`	Metrics for a post
`get_account_analytics`	Metrics for a profile
`get_best_posting_times`	Best times to post
`get_performance_report`	7 or 30-day performance report

Workflows

Tool	Description
`connect_account`	Generate Connect Link for a platform

Threads (V1)

Threads is available for OAuth connect, publishing, and scheduling through MCP — the same tools you use for Instagram and Facebook.

What works

Tool	Threads usage
`create_connect_link` / `connect_account`	`platform: "threads"` — returns a Connect Link URL
`list_profiles`	Filter with `platform: "threads"` to get Threads `profileId`s
`publish_post`	`platforms: ["threads"]` or pass a Threads `profileId`
`schedule_post`	Same as `publish_post`, with `scheduledFor`
`create_post`	Pass Threads `profileIds` and optional `overrides.threads` (`topicTag`, `threadItems`)

Example prompts for Claude or Cursor:

Connect a Threads account for my org

Publish "Launch day 🚀" to my connected Threads profile now

Schedule a post to Instagram and Threads for tomorrow at 9am UTC

What does not work yet

Tool	Threads status
`list_messages`, `reply_to_message`, `get_inbox_summary`	No Threads inbox ingestion — tools accept `platform: "threads"` but return no useful data
`get_post_analytics`, `get_account_analytics`, `get_best_posting_times`, `get_performance_report`	Analytics pipeline is Instagram and Facebook only today

See the Threads platform guide for OAuth setup, overrides, and rate limits.

TikTok (V1)

TikTok is available for OAuth connect, publishing, and scheduling through MCP — the same profile and post tools you use for other V1 platforms.

What works

Tool	TikTok usage
`create_connect_link` / `connect_account`	`platform: "tiktok"` — returns a Connect Link URL (PKCE handled server-side)
`list_profiles`	Filter with `platform: "tiktok"` to get TikTok `profileId`s
`publish_post`	`platforms: ["tiktok"]` or pass a TikTok `profileId`
`schedule_post`	Same as `publish_post`, with `scheduledFor`
`create_post`	Pass TikTok `profileIds` and `mediaUrls` (video or images required)

Example prompts for Claude or Cursor:

Connect a TikTok account for my org

Publish this video to TikTok now: https://cdn.example.com/clip.mp4

What does not work yet

Tool	TikTok status
`list_messages`, `reply_to_message`, `get_inbox_summary`	No TikTok inbox ingestion
`get_post_analytics`, `get_account_analytics`, `get_best_posting_times`, `get_performance_report`	Analytics pipeline is Instagram and Facebook only today

See the TikTok platform guide for content types, rate limits, and connect setup.

LinkedIn (V1)

LinkedIn is available for OAuth connect, publishing, and scheduling on personal profiles through MCP — text, images, and PDF documents.

What works

Tool	LinkedIn usage
`create_connect_link` / `connect_account`	`platform: "linkedin"` — returns a Connect Link URL
`list_profiles`	Filter with `platform: "linkedin"` to get LinkedIn `profileId`s
`publish_post`	`platforms: ["linkedin"]` or pass a LinkedIn `profileId`
`schedule_post`	Same as `publish_post`, with `scheduledFor`
`create_post`	Pass LinkedIn `profileIds`; optional `overrides.linkedin` (`documentTitle`, `disableLinkPreview`)

Example prompts for Claude or Cursor:

Connect a LinkedIn account for my org

Publish "We shipped LinkedIn support today" to my connected LinkedIn profile

Schedule a PDF report post to LinkedIn for tomorrow at 8am UTC

What does not work yet

Tool	LinkedIn status
Company page posting	Requires Community Management API — use personal profile only in V1
`list_messages`, `reply_to_message`, `get_inbox_summary`	No LinkedIn inbox ingestion
`get_post_analytics`, `get_account_analytics`, `get_best_posting_times`, `get_performance_report`	Analytics pipeline is Instagram and Facebook only today

See the LinkedIn platform guide for content types, overrides, and verification steps.

Error messages

MCP tools return LLM-optimized errors with recovery hints — e.g. suggesting list_profiles when IDs are invalid.

MCP Server

On this page