# Social Champ

Wires an AI agent into Social Champ for scheduling, channels, queues, approvals and AI content. Handy if you run social accounts from chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2
- Author: SocialChamp
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/SocialChamp/socialchamp-mcp
- Updated: 2026-10-12
- HTML: https://affpapa.org/en/nevibecode/mcp/social-champ

## What it does

The server hands your agent the Social Champ tool catalog. Posts can be created, edited, removed, bulk-scheduled and reordered in the queue, and Instagram first comments can be set. Other tool groups cover channels, workspaces, labels, post recycling and shareable calendars. An AI wizard adds post generation, hashtag suggestions, rewriting and image creation.

Tools carry annotations so the client knows when to ask for confirmation. Read-only ones are marked `readOnlyHint=True`; the destructive set (`delete_post`, `delete_shareable_calendar`, `bulk_delete`, `queue_clear`) is marked `destructiveHint=True`. Agency tools need the caller token to hold the `manage_team` scope as well, and each such tool says so in its description.

Python 3.10 or newer is required, plus a Social Champ API key or OAuth2 access token — both go out as a Bearer token. Everyday tools work with `read_profile` and `manage_post`; approvals, reminders and bulk delete will fail without `manage_team`. The server reads environment variables only and never loads a `.env` file on its own, so pull it into your shell with `set -a; . ./.env; set +a` before starting, then run `unset SOCIALCHAMP_API_KEY` when you are done.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://mcp.socialchamp.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http socialchamp-mcp https://mcp.socialchamp.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add social-champ --url https://mcp.socialchamp.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "social-champ": {
            "url": "https://mcp.socialchamp.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "social-champ": {
            "type": "http",
            "url": "https://mcp.socialchamp.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http social-champ https://mcp.socialchamp.com/mcp
```

## When to use it
- queue a week of posts in one go
- reorder what is already scheduled
- pull hashtag ideas for a draft
- check which approvals are still waiting
- set up a calendar to share with the team

## Example prompts
- Queue three launch posts for tomorrow and the day after
- Suggest hashtags for the latest draft and show them to me
- List the approvals that have been pending the longest

## Similar
- [socialclaw-social-media-scheduling-posting-and-analytics-for-ai-](https://affpapa.org/en/nevibecode/plugins/socialclaw-social-media-scheduling-posting-and-analytics-for-ai.md) — plugin · ★ 101
- [social-publisher](https://affpapa.org/en/nevibecode/skills/social-publisher.md) — skill · 5600 installs
- [typefully](https://affpapa.org/en/nevibecode/skills/typefully.md) — skill · 2000 installs
- [muapi-social-media-video](https://affpapa.org/en/nevibecode/skills/muapi-social-media-video.md) — skill · 2800 installs
- [batch-content-plan](https://affpapa.org/en/nevibecode/skills/batch-content-plan.md) — skill · 683 installs
- [scheduling-and-queue](https://affpapa.org/en/nevibecode/skills/scheduling-and-queue.md) — skill · 619 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md