MCP Server
Aether ships a native MCP server. Every social media endpoint — posting, scheduling, analytics, inbox, webhooks — becomes a callable tool for any MCP-compatible AI agent. One config block. No integration code.
Get your Aether API key from the dashboard, then add the config block below to your AI tool of choice. Restart the app — Aether tools appear immediately.
// ~/.claude/claude_desktop_config.json
{
"mcpServers": {
"aether": {
"command": "npx",
"args": ["-y", "aether-mcp"],
"env": {
"AETHER_API_KEY": "sk_live_..."
}
}
}
}// Cursor → Settings → MCP → Add Server
// Or edit ~/.cursor/mcp.json directly:
{
"mcpServers": {
"aether": {
"command": "npx",
"args": ["-y", "aether-mcp"],
"env": {
"AETHER_API_KEY": "sk_live_..."
}
}
}
}// Windsurf → Cascade → MCP Servers → Configure
// Or edit ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"aether": {
"command": "npx",
"args": ["-y", "aether-mcp"],
"env": {
"AETHER_API_KEY": "sk_live_..."
}
}
}
}| Tool name | Key inputs | Description |
|---|---|---|
| aether_post_create | text, profileIds, mediaUrls?, scheduledFor?, overrides? | Create or schedule a post to one or more platforms |
| aether_post_list | status?, platform?, limit? | List posts filtered by status or platform |
| aether_post_get | postId | Get a specific post and its current status |
| aether_post_cancel | postId | Cancel a scheduled post before it publishes |
| aether_analytics_post_metrics | postId | Get engagement metrics for a specific post |
| aether_analytics_account_metrics | from, to, platform?, profileId?, granularity? | Get account-level metrics over a date range |
| aether_inbox_list | status?, platform?, limit? | List inbox messages (DMs, comments, mentions) |
| aether_inbox_reply | messageId, text | Reply to a DM or comment |
| aether_inbox_mark_read | messageId | Mark a message as read |
| aether_connect_link_create | platform, redirectUrl? | Generate an OAuth connect link for a platform |
| aether_webhook_create | url, events[] | Register a webhook endpoint for real-time events |
| aether_profiles_list | platform? | List all connected social profiles |
Connect to Aether's MCP server from any Node.js agent using the official MCP SDK. No REST calls — just tool invocations with typed inputs and outputs.
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
// Connect to Aether MCP server from your own agent
const transport = new StdioClientTransport({
command: "npx",
args: ["-y", "aether-mcp"],
env: { AETHER_API_KEY: process.env.AETHER_API_KEY! },
});
const client = new Client({ name: "my-agent", version: "1.0.0" }, {
capabilities: { tools: {} },
});
await client.connect(transport);
// List available tools
const { tools } = await client.listTools();
// → [{ name: "aether_post_create", ... }, { name: "aether_analytics_post_metrics", ... }, ...]
// Call a tool
const result = await client.callTool({
name: "aether_post_create",
arguments: {
text: "Shipping a new feature today 🚀",
profileIds: ["ig_abc123", "li_company789"],
scheduledFor: "2026-06-15T09:00:00Z",
},
});Free tier · 3 accounts · no credit card
Get your free API keyMCP (Model Context Protocol) is an open standard, introduced by Anthropic, that lets AI models like Claude call external tools and services in a structured, safe way. An MCP server exposes a set of typed tools — each with a name, description, and input schema — that the AI can call during its reasoning process. It's similar to function calling in OpenAI's API, but designed as a universal protocol any model or agent can implement.
Every major Aether REST endpoint as a callable tool: post creation and scheduling, post analytics, account metrics, inbox (DMs and comments), connect link generation, webhook registration, and profile listing. The full tool list is documented above. The server is auto-generated from Aether's OpenAPI spec, so it stays in sync with every API release.
Claude Desktop (Anthropic's desktop app), Cursor (AI code editor), Windsurf (Codeium's editor), and any tool that implements the MCP client spec. The MCP ecosystem is growing rapidly — Zed, Continue, and several other AI development tools have added MCP support. Any agent framework using the @modelcontextprotocol/sdk can also connect to Aether's MCP server.
Yes. Use the @modelcontextprotocol/sdk package to connect to Aether's MCP server programmatically from any Node.js agent. The server runs as a local process via stdio transport. You can call any Aether tool from your agent code without writing REST integration — the code example above shows the pattern.
Yes. The aether-mcp package is published on npm and the source is on GitHub. It's MIT licensed. You can inspect the tool definitions, fork it, or extend it with custom tools that combine Aether capabilities with your own business logic.
Claude Desktop · Cursor · Windsurf · custom agents · 7 platforms · free to start.
Get your free API key →