# AI Marketing Agent — SEO, Leads & Social by Citedy

Your AI-powered SEO content engine, accessible from any MCP-compatible client.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add citedy/citedy

# Browse available tools
npx -y @smithery/cli@latest tool list citedy/citedy

# Get full schema for a tool
npx -y @smithery/cli@latest tool get citedy/citedy article.generate

# Call a tool
npx -y @smithery/cli@latest tool call citedy/citedy article.generate '{}'
```

## Direct MCP Connection

Endpoint: `https://citedy--citedy.run.tools`

**Optional config:**
- `apiKey` (query) — Citedy agent API key (citedy_agent_...). Get yours at https://www.citedy.com/dashboard/settings → Team & API
- `baseUrl` (query) — Custom MCP endpoint URL (default: https://mcp.citedy.com)
- `timeout` (query) — Request timeout in milliseconds (default: 300000)
- `language` (query) — Default language for content generation (ISO 639-1 code)

## Tools (52)

- `article.generate` — Generate a new article using the autopilot flow and current workspace settings.
- `article.list` — List previously generated articles for the current workspace.
- `leadmagnet.generate` — Start lead magnet generation (checklist/swipe/framework) and return polling instructions.
- `leadmagnet.get` — Fetch lead magnet status/result by ID.
- `leadmagnet.publish` — Publish a lead magnet by ID.
- `leadmagnet.archive` — Archive a lead magnet by ID.
- `scout.x` — Run X/Twitter scout analysis. Returns processing status — poll scout.x.result for results.
- `scout.x.result` — Get X scout run status and results by run ID.
- `scout.reddit` — Run Reddit scout analysis. Returns processing status — poll scout.reddit.result for results.
- `scout.reddit.result` — Get Reddit scout run status and results by run ID.
- `gaps.generate` — Generate SEO/GEO content gap opportunities.
- `gaps.list` — List saved content gaps.
- `adapt.generate` — Generate social adaptations for an article.
- `ingest.create` — Create an ingestion job from a source URL.
- `ingest.get` — Get ingestion job status/result by ID.
- `ingest.content.get` — Fetch extracted content payload for a completed ingestion job.
- `session.create` — Create and start an autopilot session.
- `social.publish` — Publish, schedule, or cancel social adaptation publishing.
- `schedule.list` — List upcoming article/post/social schedule timeline.
- `schedule.gaps` — List schedule gaps for upcoming days.
- `ingest.batch` — Create ingestion jobs in batch mode for multiple URLs.
- `competitors.discover` — Discover competitors by keyword set.
- `competitors.scout` — Analyze a competitor domain.
- `webhooks.register` — Register webhook endpoint for agent events.
- `webhooks.list` — List webhook endpoints for current agent.
- `webhooks.deliveries` — List webhook delivery attempts.
- `webhooks.delete` — Delete a webhook endpoint by ID.
- `agent.me` — Return agent profile, balances and limits.
- `agent.health` — Return infrastructure health checks for agent platform.
- `agent.status` — Return actionable operational status snapshot (credits, socials, schedule, knowledge, content).
- `settings.get` — Get current agent settings.
- `personas.list` — List available writing personas.
- `products.create` — Upload product knowledge document.
- `products.list` — List product knowledge documents.
- `products.delete` — Delete product knowledge document by ID.
- `products.search` — Search product knowledge documents.
- `seo.meta_tags.check` — Analyze meta tags for a target page URL.
- `seo.headings.check` — Analyze heading hierarchy (H1-H6) for a page.
- `seo.links.analyze` — Analyze internal/external links and link attributes.
- `seo.internal_links.plan` — Plan internal linking opportunities from source URL and target URLs/sitemap.
- `seo.og.preview` — Extract Open Graph and Twitter card preview metadata.
- `seo.schema.validate` — Validate JSON-LD schema markup for a page.
- `seo.robots.check` — Check robots.txt availability and parsed directives.
- `seo.sitemap.check` — Check sitemap availability and robots sitemap hints.
- `seo.og_image.generate` — Generate an Open Graph image artifact and return hosted URL for brand assets.
- `brand.scan` — Run AI brand visibility scan across major LLM providers (async, poll with brand.scan.get).
- `brand.scan.get` — Get brand scan status and final result payload by scan ID.
- `shorts.generate` — Generate shorts video and return poll instructions until final video URL is ready.
- `shorts.get` — Get shorts generation status/result by ID.
- `shorts.script` — Generate short-form video script text (hook/educational/cta styles).
- `shorts.avatar` — Generate an AI avatar image for shorts and return hosted avatar URL.
- `shorts.merge` — Merge 2-4 short clips, apply subtitle phrases, and return final video URL.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get citedy/citedy <tool-name>
```

## Prompts (3)

- `seo-article` (topic, language, size) — Generate an SEO-optimized article on any topic with AI-powered research and writing
- `competitor-analysis` (keyword) — Analyze competitors for a given domain or keyword set to find content gaps
- `trend-scout` (query, platform) — Scout trending topics on X/Twitter and Reddit for content inspiration