Ghost in the Box MCP Server

Welcome to the garden 🌱

Good conversations need more than a publish button. Ghost in the Box connects the work around it: understand the conversation, keep the sources, develop a draft, choose the account, send the exact job, and remember what happened.

Built by Digital Disconnections for people who want to own their tools and keep control of their work. Read our mission statement — It's Not 1997.

Related MCP server: so-easy-mcp

Pick a plot

LinkedIn, Facebook, TikTok, and YouTube currently have brief formats, not built-in publishing adapters. Provider access changes, so mocked tests establish local behavior rather than a guarantee that your account is connected.

Plant your first seed

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e '.[instagram,media]'
ghost-in-the-box doctor
ghost-in-the-box --help

Try the offline example before connecting anything. It generates a brief and a local outbox draft without logging in or sending a post.

Connect your chosen account using the first-seed guide, then use the same ghost-in-the-box command for accounts, briefs, inboxes, and delivery. Linux and macOS use POSIX file locks; Windows users need a Linux environment such as WSL.

Bring a Bat, or your favorite MCP client 👻

Ghost in the Box works alongside Batbox and other MCP clients. Instagram tools speak framed or newline JSON over stdio; the included bridge connects framed clients to the optional Substack server.

Connect the tools → · Follow the agent workflow →

Your garden stays yours

Accounts, cookies, drafts, inboxes, and receipts live in your local state directory. Ghost in the Box has no project-operated telemetry collector or analytics uploader. Social requests go to the platforms you connect; optional image inspection sends selected images to your configured vision endpoint. Those services control their own data practices.

Configuration and state explains the paths and optional helpers. Credentials and real account exports belong outside Git.

Come grow with us

This is a community project. Your fixes, improvements, testing, documentation, and artwork are welcome. AI-assisted code is welcome with regression tests.

We would love help with more provider adapters, clearer account setup, better conversation context, and a friendly interface over the existing inbox and outbox. Start with CONTRIBUTING.md and the roadmap.

Project-owned code uses the MIT license. Required dependency attribution is preserved in Third-party notices.