Metadata-Version: 2.4
Name: ainative-social-mcp
Version: 0.2.0
Summary: AINative Social Growth MCP — post and schedule across LinkedIn, Slack, Reddit, YouTube and more from one MCP, via the AINative backend (official platform APIs).
Author: AINative Studio
License: MIT
Project-URL: Homepage, https://ainative.studio
Project-URL: Repository, https://github.com/AINative-Studio/core
Project-URL: Source, https://github.com/AINative-Studio/core/tree/main/packages/mcps/ainative-social-mcp
Keywords: mcp,model-context-protocol,social-media,social-media-mcp,linkedin,slack,reddit,youtube,scheduling,post-scheduling,growth,claude,cursor,agent,ainative
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Communications
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp<2,>=1.0.0
Requires-Dist: httpx>=0.27.0

# @ainative/social-mcp — AINative Social Growth MCP

Post and schedule across **every social channel from one MCP** — LinkedIn, Slack,
Reddit, YouTube, and more — through the AINative backend using official platform
APIs (no browser automation, no anti-bot fight). Free to use.

Why it beats per-provider MCPs:
- **Multi-platform** — one tool surface for all channels.
- **Schedule-native, any horizon** — queue posts 30/60/90+ days out (most platform
  APIs can't schedule at all; AINative does it app-side).
- **Agent-first** — clean tools, honest capability reporting, actionable errors.

## Install

Published to **npm** as [`@ainative/social-mcp`](https://www.npmjs.com/package/@ainative/social-mcp)
and **PyPI** as [`ainative-social-mcp`](https://pypi.org/project/ainative-social-mcp/).
Pick whichever your setup prefers — both launch the same server.

### Option A — npm / npx (zero-install, recommended)

The `npx` launcher pulls the Python server automatically on first run
(needs Python 3.10+ on PATH).

```json
{
  "mcpServers": {
    "ainative-social": {
      "command": "npx",
      "args": ["-y", "@ainative/social-mcp"],
      "env": { "AINATIVE_API_KEY": "ak_your_key_here" }
    }
  }
}
```

### Option B — PyPI

```bash
pipx install ainative-social-mcp      # or: pip install ainative-social-mcp
```

```json
{
  "mcpServers": {
    "ainative-social": {
      "command": "ainative-social-mcp",
      "env": { "AINATIVE_API_KEY": "ak_your_key_here" }
    }
  }
}
```

Equivalent module form: `"command": "python3", "args": ["-m", "ainative_social_mcp"]`.

Optional env: `AINATIVE_BASE_URL` (default `https://api.ainative.studio`).

Get a free API key at https://ainative.studio — that's the growth hook: the MCP
is free, it just needs an AINative account.

## Tools

| Tool | What it does |
|------|--------------|
| `post_now` | Publish immediately to a platform |
| `schedule_post` | Schedule a post for any future time (no horizon cap) |
| `list_scheduled` | List your scheduled posts |
| `cancel_scheduled` | Cancel a scheduled post |
| `list_accounts` | Show connected social accounts |
| `connect_url` | One-time OAuth connect URL for a platform |
| `platform_status` | What each platform supports + how to enable it |

## Platform support (honest)

| Platform | Post | Schedule | Enable |
|----------|------|----------|--------|
| LinkedIn | ✅ | ✅ | `connect_url('linkedin')` once |
| Slack | ✅ | ✅ | invite the bot to a channel |
| YouTube | ✅ (video) | ✅ | `connect_url('youtube')` once |
| Reddit | ✅ | ✅ | Reddit "script" app + login |
| Instagram / TikTok / X | 🔗 needs approval | — | `platform_status` shows the apply link |
| Craigslist | ✖ no API | — | not supported |

## Example

```json
{ "tool": "schedule_post",
  "arguments": {
    "platform": "linkedin",
    "text": "We just shipped persistent memory for AI agents. 🧠",
    "scheduled_at": "2026-09-01T14:00:00Z",
    "link_url": "https://ainative.studio" } }
```

## Links
- AINative Studio — https://ainative.studio
- GitHub — https://github.com/AINative-Studio/core/tree/main/packages/mcps/ainative-social-mcp
