On this page
What is the Genna connector
The Genna connector lets you manage your brands’ social media content directly from your AI assistant, using the Model Context Protocol (MCP). With it, your assistant can plan, draft, and design posts for your brands, keep your brand profile and product catalog up to date, organize your media gallery, follow industry news, research reference accounts, read your own pages’ performance analytics, and — only when you say so — publish or schedule content to your connected social channels.
It is a remote MCP server operated by Genna Technologies, Inc. at https://mcp.genna.co/mcp, using the Streamable HTTP transport and OAuth 2.1 authentication. It works with any MCP-compatible AI assistant or agent that supports remote connectors, in chat apps and developer tools alike.
Using the connector requires a Genna account. Everything the connector does is governed by the Genna Terms of Service and the Genna Privacy Policy.
How it works: you stay in control
Genna is an assistive tool, and the connector follows the same principles as the Genna app:
- Drafts first. Creating a post produces a draft inside your Genna workspace — nothing is posted anywhere. You can review every draft in the chat or open it in the Genna editor.
- Human review and approval. Content reaches a social network only when you explicitly ask your assistant to publish or schedule it. The connector marks publishing tools as destructive so compliant assistants ask for your confirmation before calling them.
- Scoped permissions. Publishing requires a separate
mcp:publishpermission that you grant (or withhold) when you connect. Without it, the connector can create and edit drafts but can never post. - Your accounts only. The connector acts only on brands in your Genna workspace and social accounts you have connected and are authorized to manage.
Connect your AI assistant to Genna
Chat assistants (custom connectors)
- Open your assistant’s connectors or integrations settings and choose to add a custom/remote MCP connector.
- Enter the endpoint:
https://mcp.genna.co/mcp. - You are redirected to Genna’s secure sign-in and consent screen. Sign in, choose which brands the connector may access, and which permissions to grant (read, write, publish).
- Approve. Your assistant is now connected — start a chat and ask it about your brands.
CLI and developer MCP clients
Add the connector with your client’s standard flow, using the endpoint https://mcp.genna.co/mcp and the Streamable HTTP transport. The OAuth flow starts automatically on first use.
Advanced users can alternatively authenticate with a Genna API key created in the Genna app, sent as a Bearer token in the Authorization header.
Disconnecting
You can revoke the connector’s access at any time: remove the connector in your assistant’s settings, or revoke the grant from your Genna account settings. Access grants expire automatically after 12 months, and idle refresh tokens after 90 days.
Permissions & security
- OAuth 2.1 with authorization-code flow and mandatory PKCE (S256), served over TLS with certificates from recognized authorities.
- Granular scopes:
mcp:read(view brands, posts, analytics),mcp:write(create and edit drafts, upload media),mcp:publish(publish or schedule to connected channels). Unknown or empty scopes are rejected. - Brand allowlist: each grant or API key can be restricted to specific brands; ownership is re-verified on every call.
- Short-lived tokens: access tokens expire after 30 minutes; refresh tokens rotate on every use, and reuse of an old token revokes the entire grant.
- Credentials hashed at rest: API keys and refresh tokens are stored only as SHA-256 hashes.
- Full audit trail: every tool call is recorded in your account’s activity history — identifiers only, never your conversation content.
What you can do
| Capability | What the connector does |
|---|---|
| Create posts (AI) | Draft posts from an idea, a link, a product, an image, trending news, or a reference post — in your brand’s formats, tones, and hooks. Drafts are text-first; you review before any visuals are produced, and you can have the slide texts or the caption rewritten from a simple instruction. |
| Create posts (manual) | Turn media you already have (photos, videos) into a post or carousel with a caption, ready to schedule. |
| Design & refine visuals | Render the slide images of a post design, then refine individual slides: ask for a small adjustment on the current image, fully re-render a slide with new ingredients (a style reference, your face, logo or product photos, colors, updated text), place your brand logo onto a slide, or swap in an image from your gallery. |
| Brand profile | Read and adjust how your brand is described: bio, business overview, target audience, industry, tone of voice, colors, and audience personas. |
| Products | Manage your brand’s product catalog — add, edit, or remove products and the categories they’re filed under — and use products as the source of new posts. |
| Manage the gallery | Upload images and videos to your brand’s media gallery, browse albums, look up a single item, and remove items from the gallery (the stored file is kept, so posts already published keep their media). When a file only exists in your chat, the assistant can give you a one-time link to upload it yourself. |
| Publish & schedule | With the publish permission and your confirmation: publish now, schedule for later on your connected channels, or cancel a schedule. |
| Delete drafts | Delete posts that haven’t been published yet. Published posts can’t be deleted through Genna — remove them on the social platform directly. The post’s credit is returned under the same rules as the Genna app — see Usage limits & credits. |
| Social connections | Connect or disconnect social accounts (Instagram, Facebook, and more) via each platform’s official authorization flow. |
| Analytics | Read your own connected pages’ performance: per-post reach, likes, saves, shares, views, interaction rates, daily time series, and how a single post’s metrics evolved since it went live. |
| News radar | Choose the topics your brand’s news radar follows, collect news for them on demand, search the news already collected, or run a live news search on any subject (those results are not saved). |
| Research | Keep a reference library of public accounts for inspiration and validate Instagram post URLs. |
| Content formats | Teach Genna new post formats from example posts, manage your brand’s format library, and discover the right format: search by topic, filter your favorites, or see what you used most recently. Open any format for its full breakdown — why it works and its quality score, how to use it, the slide-by-slide script, the emotions and tone it carries — plus a link to the example post it was learned from and a preview of its slides. |
Design rendering in the design workflow
The Genna connector is design-focused software: it produces social post designs — slides with your brand’s identity, typography, and layout:
- There is no standalone image generator. No tool takes a free-form prompt and returns an image.
- Images are only ever rendered for the slides of an existing post draft — the post’s title, caption, per-slide texts, format, and brand identity drive the visuals.
- Per-slide refinements (adjust, regenerate, replace) operate on one slide of one post and are bounded by revision limits. Placing your brand logo only adds your own logo onto an existing slide.
- Rewriting slide texts or a caption changes words in a draft, not images.
- Uploading media to the gallery ingests files you already have; it generates nothing.
In short
Genna generates images the way a slide-design tool does: as part of producing a designed asset you asked for — never as a general-purpose image generation service.
Publishing safeguards
- Publishing and scheduling require the separate
mcp:publishpermission. - Both tools are annotated as destructive, so compliant assistants confirm with you before calling them. So are the tools that remove something — deleting a post, product, product category, or gallery item, and removing radar topics.
- A scheduled post can be cancelled at any time before it goes out; it returns to your drafts.
- Publishing fails safely if the brand has no connected social account.
- Every publish is additionally recorded as a dedicated audit event in your account history.
- Scheduled posts can be reviewed and managed in the Genna app before they go out.
Data access & privacy
The connector accesses only the data needed to perform the action you asked for, within the brands you allowed:
- Accessed on request: your brand profiles, posts and drafts, media gallery, connected social accounts, your own pages’ analytics, your products and product categories, audience personas, saved reference accounts, your news radar topics and collected news items, and your plan and credit balance.
- Changed on request: posts and drafts, brand profile fields and personas, products and categories, radar topics, gallery items, social connections, and content formats — only when you ask your assistant to change them.
- Sent to third parties on request: when you ask for a live news search, the subject you asked about is sent to a news search service (Google News). Nothing from that search is saved to your brand.
- Never accessed: your conversations with your assistant, its memory, or uploaded files beyond the tool parameters the assistant sends; other users’ workspaces; private content of any third-party account.
- Logging: tool calls are audited with identifiers only — no conversation data and no generated content is stored in audit logs.
- Media uploads go through Genna’s own upload endpoint (so they work from sandboxed or proxied assistant environments) using single-use links; a link the assistant gives you to upload a file yourself stays valid for 45 minutes. Server-side URL fetches are validated to block private networks and unsafe schemes.
How Genna collects, uses, and retains personal information is described in the Genna Privacy Policy. For data-protection questions, contact privacy@genna.co.
Usage limits & credits
- Requests are rate-limited per credential to keep the service healthy.
- Rendering a post’s images debits one generation credit from your Genna plan, exactly as in the Genna app. The assistant is informed of this in the tool description, and the connector fails with a clear message if your plan has no credits left.
- Per-slide AI refinements and slide text rewrites draw on each slide’s revision allowance; swapping in a gallery image and placing your brand logo are always free.
- Deleting a draft returns its credit under the same rules as the Genna app: a credit comes back only if one was spent and the post’s media was never downloaded, and at most 3 deleted posts per account get their credit back in any 24 hours. Past that limit, deleting still works, but your assistant asks you first because the credit will not be returned. After every delete, the assistant is told whether the credit came back and why.
- Responses are kept compact by design; media previews are size-capped, and you can request a single slide instead of a full post to save tokens.
Example prompts
- “Create an Instagram carousel for my brand about our new product launch — suggest a few ideas first, then draft it and show me the images before anything is published.”
- “Here are three photos from today’s event — post them as a carousel on my Instagram with a caption you write, and schedule it for tomorrow at 9am.”
- “How did my last 10 posts perform? Which format got the best save rate, and what should I post next based on that?”
- “Make slide 2’s image warmer and remove the text overlay, then publish the post.”
- “Add our new Vanilla Cold Brew to my products under Drinks, make my radar follow ‘plant-based packaging’, and draft a post about the product using this week’s news.”
Troubleshooting
| Issue | What to do |
|---|---|
| Connection fails | Verify the endpoint is exactly https://mcp.genna.co/mcp and retry the OAuth flow. Remove and re-add the connector if the consent screen does not appear. |
| ”Unauthorized” errors | Your access grant may have been revoked or expired. Reconnect from your assistant’s connector settings. For API keys, confirm the key is active in the Genna app and sent as Authorization: Bearer. |
| Publish is refused | Publishing requires the mcp:publish permission — reconnect and grant it — and at least one social account connected to the brand in Genna. |
| ”Not enough credits” | Rendering post images requires generation credits on your Genna plan. Top up or upgrade in the Genna app, then retry. |
| Brand not found | The credential’s brand allowlist may exclude that brand. Reconnect and select the brands you want your assistant to access. |
| Pasted images aren’t uploaded | Images pasted directly into the chat are visible to the assistant, but chat platforms don’t pass the file’s bytes on to connectors — so they can’t be uploaded from the conversation (common on mobile). Ask the assistant for an upload link and drop the file there yourself, share the image as a public link, or upload it to your brand’s gallery in the Genna app and ask the assistant to use it from there. |
| Deleting a published post | Genna can only delete posts that haven’t been published yet. Once a post is live on a social network, delete it on that platform directly. |
| Credit not returned after deleting | A deleted draft keeps its credit spent if its media was downloaded, or if your account already got 3 credits back in the last 24 hours. Your assistant reports which one applied after the delete. |
| Radar shows no news for a new topic | New radar topics are collected on the next scheduled run. Ask your assistant to refresh the radar to collect news for them right away. |
| Long-running steps | Post creation and image rendering are asynchronous: the assistant receives a job id and polls it. If a wait times out, ask it to check the job again — the work continues server-side. Genna also guards against accidental duplicates: identical retries return the original post instead of creating a new one. |
Support & contact
Product & security support — support@genna.co
Privacy — privacy@genna.co
Entity — Genna Technologies, Inc., a Delaware corporation · 131 Continental Dr, Suite 305, Newark, DE 19713, United States
See also: Terms of Service · Privacy Policy