Anomalia MCP server
Commit Aug 20, 2026Automate social media workflows including content planning, writing, designing, and publishing posts via a terminal or AI agent.
Also known as andreabuttarelli/anomalia-cli, anomalia-cli
- Stars
- 3
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Aug 20, 2026
- License
- AGPL-3.0
What is Anomalia MCP?
Anomalia automates social media workflows including content planning, writing, designing, and publishing posts via a terminal or AI agent.
Summary generated from the project's README
About Anomalia MCP server
Anomalia provides a way to automate social media workflows through a terminal interface, an MCP server, or an agent skill. It allows users to plan, write, design, and publish content such as posts and blog articles. The system functions as a thin client that communicates with the Anomalia API over HTTPS, meaning a registered Anomalia account is required to use any of its features.
Developers can interact with the service using the command-line interface for manual scripts or connect it to AI hosts like Cursor and Claude via the Model Context Protocol. The server supports both stdio for local connections and HTTP for remote access. It includes specific tools for managing brand voices, running SEO and GEO audits, managing ad campaigns, and editing carousel slides. Because it uses OAuth sessions rather than static tokens, it maintains a secure connection to the central Anomalia platform.
What you can do with it
- 1Automate content publishingA developer can use the CLI to approve AI-generated content or publish posts directly from the terminal.
- 2Manage ad campaignsThe tool allows for the creation, pausing, and remixing of advertising campaigns.
Written from the project's README. Every use case is checked against a quote from it.
How to install Anomalia MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Anomalia MCP in Claude Code
$ claude mcp add --transport http anomalia-cli https://mcp.anomalia.so/mcpInstall Anomalia MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"anomalia-cli": {
"url": "https://mcp.anomalia.so/mcp"
}
}
}Install Anomalia MCP in VS Code
.vscode/mcp.json
{
"servers": {
"anomalia-cli": {
"type": "http",
"url": "https://mcp.anomalia.so/mcp"
}
}
}Install Anomalia MCP in VS Code CLI
$ code --add-mcp '{"name":"anomalia-cli","type":"http","url":"https://mcp.anomalia.so/mcp"}'Install Anomalia MCP in Codex
$ codex mcp add anomalia-cli --url https://mcp.anomalia.so/mcpInstall Anomalia MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.anomalia-cli] url = "https://mcp.anomalia.so/mcp"
Install Anomalia MCP in Gemini CLI
$ gemini mcp add -s user --transport http anomalia-cli https://mcp.anomalia.so/mcpInstall Anomalia MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"anomalia-cli": {
"url": "https://mcp.anomalia.so/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableandreabuttarelli/anomalia-cli is public and reachablegithub.com/andreabuttarelli/anomalia-cli ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-08-22github.com/andreabuttarelli/anomalia-cli ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubAnomalia CLI — Social Media AI Automation CLI, MCP Server & Agent Skill
Automate your social media from the terminal. Anomalia is 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 ships three ways to drive the same product (same OAuth, same API, no static tokens):
| What | Who it’s for | |
|---|---|---|
| CLI | anomalia terminal commands |
Humans & scripts |
| MCP | Model Context Protocol server (stdio + HTTP) |
Cursor, Claude, other MCP hosts |
| Skill | Agent Skill (skills/anomalia/) |
Coding agents / skills.sh / npx skills |
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 terminal or from an AI agent like Cursor or Claude.
┌─────────────┐ ┌─────────────┐ ┌──────────────────┐
│ anomalia │ │ MCP host │ │ Agent + Skill │
│ CLI │ │ (Cursor…) │ │ (npx skills) │
└──────┬──────┘ └──────┬──────┘ └────────┬─────────┘
│ │ │
│ lib/api.ts + OAuth session │
└─────────────────┼───────────────────┘
▼
Anomalia /api/v1/*
1. CLI
Install
Pick one:
| Method | Command | Notes |
|---|---|---|
| npm | npm install -g anomalia-cli |
Needs Node.js ≥ 20 |
| Homebrew | see below | macOS / Linux, standalone binary |
| Installer | see below | curl script → binary on PATH |
| From source | see below | Needs Bun |
npm
npm install -g anomalia-cli
# or: pnpm add -g anomalia-cli / bun add -g anomalia-cli
anomalia login
Homebrew
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 with anomalia update, or npm install -g anomalia-cli@latest / brew upgrade anomalia depending on how you installed. More detail: docs/distribute.md.
Quick start
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 --help lists them all;
anomalia <command> --help details one. Short id prefixes from tables are accepted; ambiguous
prefixes error instead of guessing.
| Area | Commands |
|---|---|
| Posts | content, approve, post <id> [show|edit|regenerate|slide|reorder|video|publish] |
| Planning | plan, weekly-plan, calendar, gtm |
| Brand | studio, voice, people, products |
| Web | seo, geo, keywords, web |
| Ads | ads — campaigns, spend, boost proposals, remix, duplicate/delete (--sync, --propose, --remix, --create, --approve, --pause, --resume, --duplicate, --delete, --reject, --ad per singola creatività) |
| Insight | dashboard, status, analytics |
| AI | ai --message "..." — natural language, full read/write access |
Full command dump: llms.txt · more docs: docs/
From source
Requires Bun.
git clone https://github.com/andreabuttarelli/anomalia-cli.git
cd anomalia-cli
bun install
bun run cli.ts --help
2. MCP server
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.
Cursor — stdio
{
"mcpServers": {
"anomalia": {
"command": "bun",
"args": ["run", "/ABS/PATH/to/anomalia-cli/mcp/stdio.ts"]
}
}
}
Cursor — HTTP
{
"mcpServers": {
"anomalia": { "url": "https://mcp.anomalia.so/mcp" }
}
}
If Connect fails with Not an https or loopback URI: cursor://…, your Cursor build is still
using the custom-scheme OAuth callback — use stdio above, update Cursor (loopback
http://localhost:8787/callback), or see docs/mcp.md.
- Local stdio:
logintool or existinganomalia login→~/.config/anomalia/session.json - Remote HTTP:
Authorization: Bearer <access_token>(401 without it is expected)
3. Agent Skill & plugins
Publishable Agent Skill for 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 prefer MCP tools if connected, otherwise the CLI.
Claude Code / Codex marketplace plugin
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.
Configuration
Zero config by default → https://anomalia.so, with automatic fallback to
http://localhost:5173 when a local app is answering.
| Variable | Purpose |
|---|---|
PUBLIC_APP_URL |
Point CLI/MCP at another Anomalia instance |
SENTRY_DSN |
(MCP HTTP / Vercel) Errors → Sentry |
SUPABASE_SERVICE_ROLE_KEY |
(MCP HTTP / Vercel) Rows in mcp_logs |
MCP_PUBLIC_URL |
Public MCP base URL for OAuth metadata |
Session: ~/.config/anomalia/session.json. anomalia logout clears it. No secrets are embedded
in this repo or the binary.
Architecture
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)
Development
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 a v* tag → CI typechecks, tests, cross-compiles binaries + .tar.gz +
SHA256SUMS.txt on the GitHub Release, bumps Formula/anomalia.rb,
and publishes anomalia-cli to npm when NPM_TOKEN is set. Details: docs/distribute.md.
License
Copyright © 2026 Andrea Buttarelli.
Licensed under the GNU Affero General Public License v3.0 or later. You may use, modify and redistribute it, but derivative works must stay open source under the same license, must keep the copyright notice, and must state their changes — including when offered to users over a network.
Anomalia MCP questions
How do I add Anomalia MCP to Claude Code?
Run claude mcp add --transport http anomalia-cli https://mcp.anomalia.so/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Anomalia MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Do I need an account to use Anomalia?
Yes, you need an Anomalia account because this is a client that communicates with the Anomalia API.
What kind of social media tasks can I automate?
You can automate posting, approving AI content, editing carousels, turning posts into videos, and running SEO/GEO audits.