Skip to main content
Contract Snapshot: 66 Agent API operations · 56 MCP tools Version: 1.7.0 | Status: Production | Updated: 2026-02-28 Citedy is a backend service for AI agents. Connect once, configure defaults in the web UI, and let any agent — OpenClaw, Claude Code, Cursor, ChatGPT, or any MCP-compatible client — write posts, generate images, publish to social platforms, scan trends, and produce short-form video. The web UI is for settings and scheduling review. The agent does the work.

​
Who Is This For

  • Vibe-coders and solo founders who already use AI agents daily
  • Micro-companies that want content automation without agency overhead
  • Developers building agent workflows on top of a reliable content + publish API
Not for: agencies, enterprise, or anyone who wants a web chat interface.

​
Quick Start for Agents

1. Register: POST /api/agent/register  (or use SKILL.md onboarding)
2. Infra health: GET /api/agent/health
3. Operational status: GET /api/agent/status
4. Configure defaults: GET /api/agent/settings (update via web UI or PUT API)
5. Create a post: POST /api/agent/post
6. Publish it: POST /api/agent/publish
Operational response from /api/agent/status: 
summary.operational_status: attention
billing.credits_available: 100
social.connected_count: 0                  -> https://www.citedy.com/dashboard/settings?section=account&tab=integrations
knowledge.documents_count: 0               -> https://www.citedy.com/dashboard/settings?section=blog&tab=knowledge
schedule.scheduled_7d: 0                   -> https://www.citedy.com/dashboard/calendar
content.total_items: 0                     -> /post or /write

​
Command Reference (Quick)

Agent CommandAPI CallCost
/post <topic>POST /api/agent/post2-4 credits
/write <topic>POST /api/agent/autopilot4-8 credits
/shorts <prompt>POST /api/agent/shorts60-185 credits
/shorts scriptPOST /api/agent/shorts/script1 credit
/shorts avatarPOST /api/agent/shorts/avatar3 credits
/shorts mergePOST /api/agent/shorts/merge5 credits
/publish nowPOST /api/agent/publish0 credits
/schedule listGET /api/agent/schedule0 credits
/schedule gapsGET /api/agent/schedule/gaps0 credits
/scan fastPOST /api/agent/scan (mode=fast)2 credits
/scan deepPOST /api/agent/scan (mode=deep)4 credits
/scan ultraPOST /api/agent/scan (mode=ultra)6 credits
/scan ultra+POST /api/agent/scan (mode=ultra+)8 credits
/products uploadPOST /api/agent/products1 credit
/products listGET /api/agent/products0 credits
/products searchPOST /api/agent/products/search0 credits
/image-stylePUT /api/agent/image-style0 credits
/statusGET /api/agent/status0 credits
/settingsGET /api/agent/settings0 credits
These commands describe the full Agent API surface. Public MCP v1 intentionally exposes a smaller tool set (see below).

​
MCP v1 Tool Surface (Public)

MCP v1 is outcome-first. The goal is to expose stable high-value workflows, not every internal pipeline step.
MCP ToolBackend API PathNotes
agent.healthGET /api/agent/healthCore diagnostics
agent.statusGET /api/agent/statusActionable readiness snapshot
settings.getGET /api/agent/settingsRead settings in-agent
schedule.gapsGET /api/agent/schedule/gapsPlanning visibility
webhooks.deliveriesGET /api/agent/webhooks/deliveriesDelivery debugging
products.createPOST /api/agent/productsUpload product doc
products.listGET /api/agent/productsList product docs
products.deleteDELETE /api/agent/products/[id]Remove product doc
products.searchPOST /api/agent/products/searchSearch knowledge chunks
shorts.generatePOST /api/agent/shortsReturns processing + poll hint
shorts.getGET /api/agent/shorts/[id]Poll final video status/url
shorts.scriptPOST /api/agent/shorts/scriptGenerate script text
shorts.avatarPOST /api/agent/shorts/avatarGenerate avatar image
shorts.mergePOST /api/agent/shorts/mergeMerge clips + subtitles
Advanced/deferred for MCP public exposure:
  • settings.update (safe-field policy needed; web-first by default)
  • schedule.suggest (heuristic helper, not a critical contract)

​
Authentication

All agent endpoints require: 
Authorization: Bearer <AGENT_API_KEY>
Obtain your key at citedy.com/dashboard/settings or via POST /api/agent/register. Key rotation: POST /api/agent/rotate-key

​
Platform Support Matrix

PlatformTextImagesVideo
Twitter / XYesYesYes
LinkedInYesYesYes
FacebookYesYesYes
InstagramYesYesReels
YouTube--Shorts
RedditYesYesNo (link only)
ThreadsYesYes-