# Growcita

> Growcita is an AI marketing platform: 10 specialized agents (strategy, SEO, paid ads, organic social, email, creative, CRO, web, influencer, demand gen) that plan and execute marketing work on a company's real connected platforms.

Programmatic access comes in two forms: a REST API (Bearer API key, base URL https://growcita.com/api/v1) and a hosted MCP server (https://growcita.com/api/mcp) usable from Claude, Claude Code, Cursor, Codex, and any MCP client. API keys are created in the app under Settings → API Keys. Agent tasks run asynchronously (typically 1–5 minutes) and are polled until completed; actions that publish or change campaigns respect the account's autonomy and human-approval settings.

## Docs

- [Developer hub](https://growcita.com/developers): start here — what you can build, how auth works
- [REST API guide](https://growcita.com/developers/api): endpoints, auth, status codes, curl examples
- [MCP server guide](https://growcita.com/developers/mcp): hosted endpoint, tools, claude.ai connector setup
- [Claude Code setup](https://growcita.com/developers/claude-code): one-command install via claude mcp add
- [Codex setup](https://growcita.com/developers/codex): config.toml snippet for OpenAI Codex
- [Cursor setup](https://growcita.com/developers/cursor): .cursor/mcp.json snippet
- [OpenAPI 3.1 spec](https://growcita.com/api/v1/openapi.json): machine-readable API description (no auth required)

## API

- GET /api/v1/agents: List the 10 marketing agents with specialties and sub-specialties.
- GET /api/v1/sessions: List your workspaces (sessions). Tasks always run inside a session.
- POST /api/v1/sessions: Create a workspace for a company (name required; companyName/companyUrl recommended).
- POST /api/v1/tasks: Run an agent task from a plain-English instruction. Async — returns the task with its current status; optionally waits up to 120s.
- GET /api/v1/tasks: List recent tasks, filterable by sessionId, status, and agentType.
- GET /api/v1/tasks/{taskId}: Get one task's status, result, and error.
- GET /api/v1/me: Introspect the API key used for the request (name, prefix, expiry, last use).
- GET /api/v1/openapi.json: Machine-readable OpenAPI 3.1 description of this API (no auth required).

## MCP tools

- list_agents: List Growcita's 10 marketing agents with their specialties and sub-specialties.
- list_sessions: List the user's Growcita workspaces (sessions).
- create_session: Create a new Growcita workspace (session) for a company.
- run_agent_task: Run a marketing task with one of Growcita's agents.
- get_task: Fetch a task's current status and result.
- list_tasks: List recent tasks, optionally filtered by sessionId, status, or agentType.

## Agents

- Growth Marketer (growth-marketer): VP-level strategist. Growth hacking, viral loops, content orchestration, pricing, and launch playbooks. Supervisor — delegates to all specialists.
- Organic Social (organic-social): Full-stack social media across Twitter/X, TikTok, Instagram, Reddit, LinkedIn, and YouTube.
- Paid Media (paid-media): Performance marketing across Google, Meta, TikTok, LinkedIn, and Reddit ads.
- SEO/AEO (seo): Technical SEO, keyword strategy, AI/LLM visibility (GEO/AEO), YouTube SEO, and App Store Optimization.
- Email Marketing (email-marketing): Cold email outreach, marketing automation, nurture sequences, and deliverability.
- Creative (creative): Ad creative, brand design, AI image/video generation, and UGC strategy.
- Web Developer (web-developer): Landing pages, analytics/tracking (GA4, GTM), and performance optimization.
- CRO (cro): A/B testing, funnel optimization, landing page CRO, and signup/onboarding flows.
- Influencer Marketing (influencer-marketing): Influencer discovery, partnership management, campaign execution, and ROI tracking.
- Demand Gen (demand-gen): B2B lead generation, ICP targeting, Apollo enrichment, and outbound email sequences.

## Optional

- [Full reference](https://growcita.com/llms-full.txt): expanded single-file docs — request/response shapes, MCP tool schemas, client configs