# MicroCreatorr

> Social-commerce creative studio — product URL to posts, reels, and ads, with publish to Instagram and TikTok.

MicroCreatorr is built for AI agents via MCP (Model Context Protocol) and Bearer-token REST APIs.

## Agent entry points

- MCP server: `{ORIGIN}/api/mcp-server/mcp`
- Agent docs: `{ORIGIN}/docs/agents`
- Feature register (internal): `{ORIGIN}/docs` and repo `docs/FEATURES.md`
- API token: Settings → MCP → Generate API token (`mc_…`)

## Authentication

- MCP: `Authorization: Bearer mc_…` header on the MCP connection
- REST: same Bearer header on `/api/*` routes (session cookies also work in browser)
- Optional team scope: `X-Team-Id: {teamId}` header

## Core workflows (MCP tools)

1. **Product → design**: `import_product_url` → `list_design_templates` → `create_design_from_product_url`
2. **Product → published post**: `create_and_publish_product_post` (one-shot)
3. **Content batch**: `generate_content_calendar` (6–20 posts, credit-free)
4. **Export PNG**: `render_design_png` → hosted URL
5. **Schedule**: `schedule_post` with `mediaUrl` + `scheduledFor`
6. **Bulk catalog**: `start_bulk_render` → poll `get_bulk_render_job`
7. **Video export**: `start_video_render` → poll `get_video_render_job`
8. **Generate AI media**: `generate_image`, `generate_video`, `generate_product_ad`

## Key REST endpoints (Bearer auth)

| Method | Path | Purpose |
|--------|------|---------|
| POST | `/api/url-metadata/batch` | Scrape product URLs (no auth) |
| POST | `/api/content-calendar/generate` | AI content calendar batch |
| GET/POST | `/api/designs` | List/create designs |
| GET/PATCH | `/api/designs/{id}` | Read/update design |
| POST | `/api/social/publish` | Publish image/video immediately |
| GET/POST | `/api/scheduled-posts` | List/schedule posts |
| POST | `/api/bulk/render` | Start bulk ZIP render job |
| GET | `/api/bulk/render/{jobId}` | Poll bulk job |
| POST | `/api/video/render` | Video export (sync or async) |
| GET | `/api/video/render/{jobId}` | Poll video job |

## Async jobs

Long-running exports return `{ jobId, status, pollUrl }`. Poll until `status` is `completed` or `failed`.

## Design documents

- Prefer `create_design_from_template` over raw JSON
- Schema: MCP tool `get_design_schema`
- Layer summary: `get_design_summary`
- Text edits: `update_design_text`, `auto_fill_design_copy`

## Human UI

- Studio editor: `/studio`
- MCP setup: `/settings/mcp`
- Pricing / trial: 30-day free trial for new accounts

## Support

- Compare vs Canva: `/design/overview`
- Full docs: `/docs`