# Atlas Social MCP Server

> AI-powered social media posting for Claude Code. Post to 14 platforms with one command.

[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![npm version](https://img.shields.io/npm/v/@runatlas/atlas-social-mcp)](https://npmjs.com/package/@runatlas/atlas-social-mcp)

## What it does

- **Post to 14 platforms** simultaneously with one command
- **AI adapts content** per platform — Twitter gets a punchy one-liner, LinkedIn gets thought leadership, TikTok gets a scroll-stopping hook
- **Schedule posts** for optimal times
- **Generate 30-day content calendars** with daily topics, hooks, and platform recommendations
- **Track analytics** across all connected platforms

## Supported Platforms

Twitter/X · Instagram · TikTok · Facebook · LinkedIn · YouTube · Threads · Pinterest · Reddit · Bluesky · Telegram · Google Business · Snapchat · WhatsApp

## Quick Start

### Install via npx (recommended)

Add to your Claude Code MCP config (`~/.claude/settings.json`):

```json
{
  "mcpServers": {
    "atlas-social": {
      "command": "npx",
      "args": ["-y", "@runatlas/atlas-social-mcp"],
      "env": {
        "ZERNIO_API_KEY": "sk_your_key_here",
        "ANTHROPIC_API_KEY": "sk-ant-your_key_here"
      }
    }
  }
}
```

### Or for Claude Desktop (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "atlas-social": {
      "command": "npx",
      "args": ["-y", "@runatlas/atlas-social-mcp"],
      "env": {
        "ZERNIO_API_KEY": "sk_your_key_here",
        "ANTHROPIC_API_KEY": "sk-ant-your_key_here"
      }
    }
  }
}
```

Restart Claude Code. Done.

## Usage

Just talk naturally:

```
"Post our new product launch to all platforms"
"Tweet: Just shipped v2.0 — faster, smarter, better."
"Schedule a LinkedIn post for Monday 9am about our hiring news"
"Generate a 30-day calendar for Elite Plumbing"
"Show me this week's analytics"
"What posts went out this week?"
"List my connected accounts"
```

## Tools

| Tool | Description |
|------|-------------|
| `post_now` | Post immediately. AI adapts content per platform. |
| `schedule_post` | Schedule for future date/time. |
| `generate_calendar` | 30-day content calendar with AI. |
| `get_analytics` | Performance metrics across platforms. |
| `get_recent_posts` | Recent post history and status. |
| `list_accounts` | Connected social accounts. |

## How Content Adaptation Works

When you say *"Post this to Twitter and LinkedIn"*, Atlas Social:

1. Takes your message
2. Rewrites for Twitter: punchy, under 240 chars, 1-2 hashtags
3. Rewrites for LinkedIn: professional, 200 words, thought leadership angle
4. Posts both versions simultaneously

Each platform gets content that feels **native** — not a copy-paste resize.

## Setup

1. **Get a Zernio API key** (free tier available): [zernio.com](https://zernio.com)
2. **Connect your social accounts** in the Zernio dashboard
3. **Add the MCP server** to your Claude config (see Quick Start above)
4. **Optional**: Add `ANTHROPIC_API_KEY` for AI content adaptation and calendar generation

## API Keys

| Key | Required | Get it from |
|-----|----------|-------------|
| `ZERNIO_API_KEY` | Yes | [zernio.com](https://zernio.com) → Dashboard → API Keys |
| `ANTHROPIC_API_KEY` | Optional | [console.anthropic.com](https://console.anthropic.com) |

Without `ANTHROPIC_API_KEY`, posts will use your original text on all platforms (no per-platform adaptation). Calendar generation requires it.

## Pricing

Atlas Social MCP is **free and open source**.

You'll need a Zernio account for the posting API:

| Zernio Plan | Posts/mo | Price |
|-------------|----------|-------|
| Free | 20 | $0 |
| Build | 120 | $19/mo |
| Accelerate | Unlimited | $49/mo |

## Local Development

```bash
git clone https://github.com/runatlas/atlas-social-mcp.git
cd atlas-social-mcp
npm install
cp .env.example .env  # Add your keys
npm run build
npm start
```

## Built by

**Atlas Systems AI** — [run-atlas.com](https://run-atlas.com)

Building the operating system for AI-powered content production.