Skip to content

x-use v2.1.0 - scheduled-action queue, account management, 24 MCP tools

Choose a tag to compare

@ihuzaifashoukat ihuzaifashoukat released this 24 Jul 11:31

The MCP server grows from 9 to 24 tools: a persistent scheduled-action queue with safety pacing, full account management from your MCP client, and the operational tools that were missing. Additive only; everything from v2.0.0 keeps working unchanged.

Highlights

  • Scheduled-action queue: queue_post and queue_engagement store fully-rendered payloads (LLM text generated at enqueue time, so list_queue shows exactly what will fire). process_queue is the explicit approval gate and drains with jittered 90-240s pacing, per-action daily caps (posts 5, replies 15, likes 30, retweets 10 per day by default), and retry backoff. An opt-in auto_drain background worker (default off) trickles the queue on an interval.
  • Account management: add_account, update_account, set_account_active, remove_account (confirm-gated), get_account. Every write to config/accounts.json is validated, backed up to config/backups/, and applied atomically. Cookies import from a server-side file path only, never inline through the chat. Paused accounts are rejected at enqueue and skipped on drain-all.
  • Support tools: list_drafts, get_draft, reject_draft (drafts can now be reviewed and rejected, not just approved), get_run_status (poll run_cycle handles), get_account_health (config, cookie validity, metrics, session, queue depth, pending drafts in one read-only call).

Details

  • New standalone xuse/queue/ package (store, runner, scheduler) with no MCP imports, ready for a future x-use queue CLI
  • New xuse/core/config_writer.py: load-fresh, validate-every-account, timestamped pruned backups, atomic replace
  • The queue subsystem has its own top-level queue block in settings.json; see docs/CONFIG_REFERENCE.md
  • Legacy account-key normalization consolidated into xuse/core/config_loader.py (shared by core, MCP, and the init wizard)
  • config/backups/ added to .gitignore (backup copies may contain secrets)
  • Tests: 148 -> 234, all passing; the 24-tool contract is pinned so signature drift fails CI

Upgrade notes

  • pip install -U x-use-mcp
  • No config changes required; every new setting defaults conservatively (auto_drain off, pacing 90-240s, daily caps as above)
  • Drafts file gains one status value (rejected); older servers simply never produce it