faden CLI + MCP server

The open-source client for faden — a unified social-media publishing API. One command (or one MCP tool call) posts across X, LinkedIn, Facebook, Instagram, Threads, Bluesky and more; faden handles each network's OAuth, media and scheduling quirks.

npm install -g @fadenhq/cli     # installs the `faden` command
faden login --key fdn_live_…
faden post -p x,linkedin -c "Hello from faden 🚀"

As an MCP server for agent runtimes:

claude mcp add faden --env FADEN_API_KEY=fdn_live_… -- npx @fadenhq/cli mcp

And as a skill, so the agent knows how to use those tools well — check constraints before writing, tailor per platform, read per-target results:

npx skills add fadenhq/cli     # Claude Code, Codex, Cursor, … ; -g for every project
npx skills update              # refresh the copy later

That installs the skill alone. Claude Code can take the plugin instead, which carries the skill and the MCP server together:

/plugin marketplace add fadenhq/cli
/plugin install faden@faden

See apps/cli/README.md for the full command reference and plugin/ for what the plugin contains.

Repository layout

This repo is the public mirror of the OSS subset of the faden codebase:

• apps/cli — the @fadenhq/cli package: CLI + MCP server (faden mcp)

• packages/shared — shared types, Zod validators and the per-platform constraint matrix (bundled into the published artifact)

• plugin — Claude Code plugin: MCP config + posting skill

The faden service itself (API, connectors, dashboard) is proprietary; get an API key at faden.io. Issues and PRs for the CLI/MCP surface are welcome here.

Related MCP server: @posteverywhere/mcp

Development

npm install
npm run typecheck
npm test
npm run build -w @fadenhq/cli    # bundles dist/index.js via tsup

Releases: maintainers push a cli-v<version> tag matching apps/cli/package.json; .github/workflows/release.yml publishes to npm via trusted publishing (OIDC) with provenance.

License

AGPL-3.0-only.