# Aivy Marketing

> MCP tools for an external assistant to read a brand, draft posts, attach media, and schedule or publish to connected social channels.

Aivy is an AI marketing agent for small businesses and creators. It learns a brand from its website (Brand DNA), builds a marketing strategy and a 12-month content plan, writes posts, schedules and publishes them to connected social channels (LinkedIn, Facebook, Instagram, X), and reports results. There is a Free plan; paid plans are Solo, Growth and Scale (https://aivymarketing.com/#pricing). AI assistants are welcome: connect through the MCP endpoint below.

## Canonical URLs
- Website: https://aivymarketing.com
- Developer docs: https://aivymarketing.com/developers
- All agent docs in one file: https://aivymarketing.com/llms-full.txt
- MCP endpoint: https://aivymarketing.com/api/mcp
- Protected resource metadata: https://aivymarketing.com/.well-known/oauth-protected-resource/api/mcp
- Authorization server metadata: https://aivymarketing.com/.well-known/oauth-authorization-server
- Tool reference: https://aivymarketing.com/api/agent/openapi.json
- Setup guide for people: https://aivymarketing.com/docs/ai-assistants.md
- Walkthrough: https://aivymarketing.com/docs/agent-mcp.md

## Authentication
OAuth 2.1 clients (dynamic client registration, PKCE S256) are sent to https://aivymarketing.com/connect/agent, where the person signs in or creates an account and approves. Aivy is the authorization server. The access token is an opaque aivy_at_ grant, not a Supabase JWT.
Clients without OAuth use a key the person creates under Settings → AI Assistants (https://aivymarketing.com/ai-assistants). It starts with aivy_at_, is shown once, and is sent as Authorization: Bearer aivy_at_...
A grant can cover chosen brands or all of the person's brands, including brands created later.
Scopes aivy.reader, aivy.drafter, and aivy.publisher are ceilings. Consent can choose a lower profile.

## Profiles
- Reader: brand, strategy, channels, posts, media, and analytics.
- Drafter: reader plus drafts, media uploads, brand and strategy writes, and optional generation inside a ceiling.
- Publisher: drafter plus schedule_post and publish_post. A drafter cannot publish or schedule. When requireApproval is on, those tools return pendingApproval until a person approves the post in Aivy.

## Setting up a brand
Call get_setup_status and continue with its nextStep: create_brand, start_website_scan (or create_brand_dna_without_website), get_brand_dna and approve_brand_dna, get_strategy_questions and save_strategy_answers, generate_strategy, get_strategy_draft and approve_strategy, create_content_plan and get_content_plan. Scans, strategies and plans build in the background; read them again after checkAgainInSeconds. They cost 9, 5 and 14 credits from the person's Aivy account. The MCP prompt set_up_my_brand starts this flow.

## Workflow
Read brand context and channels, create an unpublished draft, attach media, fix validation errors, schedule or publish, then poll get_publish_status.

## Retired REST API
https://aivymarketing.com/api/agent/v1 returns HTTP 410. Use the MCP endpoint above.