Anomalia
About
Anomalia plans, writes and designs everything — posts, articles, lead outreach. You approve in one tap; the rest goes live across every channel.
Details
- Author
- andreabuttarelli
- Categories
- Marketing, Other
Jump to
Setup
Install Anomalia in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/andreabuttarelli/anomalia-cli
Follow the installation instructions in the repository README, then restart your MCP client.
Anomalia CLI — Social Media AI Automation CLI, MCP Server & Agent Skill
Automate your social media from the terminal.Anomaliais the social media AI autopilot that plans, writes, designs and publishes posts, blog articles and SEO/GEO audits on autopilot. This repository is its command-line client,MCP server(Model Context Protocol —stdio+ HTTP) and agent skill: everything you need to run social media automation, content generation and approval workflows from a terminal or an AI agent.
This repository shipsthree waysto drive the same product (same OAuth, same API,no static tokens):
You need an Anomalia account.This is a client, not a standalone tool: every call talks to the Anomalia API over HTTPS. Without an account there is nothing to drive.
With the Anomalia CLI you can automate social media posting, approve AI-generated content in one tap, edit a carousel slide by slide, turn a post into a video, run SEO and GEO audits, and manage your blog — from the terminalorfrom an AI agent like Cursor or Claude.
┌─────────────┐ ┌─────────────┐ ┌──────────────────┐ │ anomalia │ │ MCP host │ │ Agent + Skill │ │ CLI │ │ (Cursor…) │ │ (npx skills) │ └──────┬──────┘ └──────┬──────┘ └────────┬─────────┘ │ │ │ │ lib/api.ts + OAuth session │ └─────────────────┼───────────────────┘ ▼ Anomalia /api/v1/
npm install -g anomalia-cli # or: pnpm add -g anomalia-cli / bun add -g anomalia-cli anomalia login
brew tap andreabuttarelli/anomalia-cli https://github.com/andreabuttarelli/anomalia-cli brew install anomalia anomalia login
Installer (standalone binary)— macOS arm64/x64 and Linux arm64/x64, no Node/Bun required:
curl -sSL https://raw.githubusercontent.com/andreabuttarelli/anomalia-cli/main/scripts/install.sh | bash anomalia login
Update later withanomalia update, ornpm install -g anomalia-cli@latest/brew upgrade anomaliadepending on how you installed. More detail:docs/distribute.md.
anomalia brands anomalia dashboard my-brand anomalia content my-brand --status pending_user anomalia approve my-brand --all anomalia seo my-brand anomalia web my-brand generate --topic "..." anomalia ads my-brand --remix anomalia ai my-brand --message "..." --pipe
Every command takes the brand slug as its first argument.anomalia --helplists them all;anomalia <command> --helpdetails one. Short id prefixes from tables are accepted; ambiguous prefixes error instead of guessing.
Full command dump:llms.txt· more docs:docs/
git clone https://github.com/andreabuttarelli/anomalia-cli.git cd anomalia-cli bun install bun run cli.ts --help
Same tools and OAuth as the CLI. Docs:docs/mcp.md.
bun run mcp # stdio (local hosts) bun run mcp:http # http://localhost:8787/mcp
Remote:https://mcp.anomalia.so/mcp(Bearer JWT required). Health:GET /health.
{ "mcpServers": { "anomalia": { "command": "bun", "args": ["run", "/ABS/PATH/to/anomalia-cli/mcp/stdio.ts"] } } }
{ "mcpServers": { "anomalia": { "url": "https://mcp.anomalia.so/mcp" } } }
If Connect fails withNot an https or loopback URI: cursor://…, your Cursor build is still using the custom-scheme OAuth callback — usestdioabove, update Cursor (loopbackhttp://localhost:8787/callback), or seedocs/mcp.md.
- Local stdio:logintool or existinganomalia login→~/.config/anomalia/session.json
- Remote HTTP:Authorization: Bearer <access_token>(401 without it is expected)
PublishableAgent Skillfor Cursor, Claude, skills.sh, and friends:
npx skills add andreabuttarelli/anomalia-cli --skill anomalia # or bash scripts/install-skill.sh --project
Package:skills/anomalia/→plugins/anomalia/skills/anomalia/(SKILL.md+references/for MCP setup, tool map, CLI).
When the skill is active, agents preferMCP toolsif connected, otherwise theCLI.
Same skill + remote MCP, packaged for plugin install and directory submit:
# Claude Code /plugin marketplace add andreabuttarelli/anomalia-cli /plugin install anomalia@anomalia # Codex codex plugin marketplace add andreabuttarelli/anomalia-cli
Submit checklist (Claude community directory + OpenAI Plugins Directory):docs/plugins.md.
Zero config by default →https://anomalia.so, with automatic fallback tohttp://localhost:5173when a local app is answering.
Session:~/.config/anomalia/session.json.anomalia logoutclears it. No secrets are embedded in this repo or the binary.
Thin HTTPS client — no DB access, no coupling to the Anomalia server codebase:
CLI ──┐ MCP ──┼── HTTPS ──► /api/v1/ ──► Anomalia Skill ─┘ (guides agents to CLI or MCP)
- CLI commands:commands/+cli.ts
- HTTP client:lib/api.tsonly
- MCP:mcp/(reuseslib/api.ts, registers tools)
- Skill / plugins:skills/anomalia/→plugins/anomalia/(Claude + Codex marketplace manifests)
bun install bun run cli.ts --help bun run mcp bun run mcp:http bun run typecheck bun test bun run build # binary → dist/ bun run build:all # all four targets bun run vercel-build # MCP bundles under mcp/api/
Releases: push av*tag → CI typechecks, tests, cross-compiles binaries +.tar.gz+SHA256SUMS.txton the GitHub Release, bumpsFormula/anomalia.rb, and publishesanomalia-clito npm whenNPM_TOKENis set. Details:docs/distribute.md.
Free MCP that drives an audit of your marketing. Your AI connects, adsOS digs through your ads, email and site, and hands back a growth plan you can run today.
Launch & manage your User Referral and Partner / Affiliate program — for developers and growth teams.
Let AI clients add payments to your website. Create checkout pages, events and forms and embed them on your site in minutes.
Answers questions on AEO, SEO, web development and branding from the published material of GOJI, a Melbourne digital agency, with a goji.agency URL to cite on every result.
A shared campaign canvas for you and your AI agent: briefed by your brand rules, gated by your approval.
Technical SEO audits and crawl insights for AI assistants via MCP.
Run your Linkedin account from claude or chatgpt
AI agents that manage paid ads across Meta, LinkedIn, and Google Ads: campaigns, ad creative, and day-to-day ad operations from any MCP client.
Chat with any brand's Meta (Facebook/Instagram) ads inside Claude — research a competitor's ad library, surface their longest-running winners, extract hooks/formats, and clone winning ads for your own brand.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
