Youanai for developers and AI agents.

Endpoint (Streamable HTTP): https://youanai.com/api/mcp

Authentication is OAuth 2.1 with the authorization code flow, PKCE (S256) and dynamic client registration, so a compatible client can register itself and needs no pre-shared key. An unauthenticated request receives 401 with a WWW-Authenticate header that points at the discovery documents.

OAuth discovery

• Protected resource metadata (RFC 9728): https://youanai.com/.well-known/oauth-protected-resource/api/mcp
• Authorization server metadata (RFC 8414): https://youanai.com/.well-known/oauth-authorization-server
• Authorization endpoint: https://youanai.com/api/mcp/oauth/authorize
• Token endpoint: https://youanai.com/api/mcp/oauth/token
• Dynamic client registration: https://youanai.com/api/mcp/oauth/register
• Revocation endpoint: https://youanai.com/api/mcp/oauth/revoke

Scopes

• workspace:read Read workspace details and membership context.
• business_dna:read Read Business DNA brand memory.
• business_dna:write Update Business DNA brand memory.
• social_accounts:read See which social accounts are connected.
• posts:read Read posts and drafts.
• posts:write Create and edit posts.
• posts:schedule Schedule posts.
• posts:publish Publish posts.
• campaigns:read Read campaigns.
• campaigns:write Create and edit campaigns.
• media:read Read the media library.
• media:write Upload and generate media.
• analytics:read Read analytics.
• reviews:read Read review and approval state.
• reviews:write Submit and update reviews.
• calendar:read Read the content calendar.
• calendar:write Edit the content calendar.
• automations:read Read automations.
• automations:write Create and edit automations.
• drafts:create Create draft posts.
• offline_access Receive a refresh token so the connection stays signed in.

Tools (21)

• workspaces_list Use this when the user needs to see which Youanai workspaces are available through the current connection. Scope: workspace:read, read-only.
• workspace_context Use this when an agent needs the active workspace, role, timezone, access level, or read-scope context before acting. Scope: workspace:read, read-only.
• social_accounts_list Use this when the user asks which social accounts are connected to the workspace. Scope: social_accounts:read, read-only.
• social_connection_status Use this before scheduling or diagnosing posting problems to summarize connected, missing, and expired providers with Youanai Social handoff links. Scope: social_accounts:read, read-only.
• feed_search Use this when the user asks about published social feed activity, top posts, weak posts, or content to repurpose. Scope: posts:read, read-only.
• feed_get Use this when a feed_search result needs full caption, media, permalink, or metrics before analysis or repurposing. Scope: posts:read, read-only.
• posts_search Use this when the user asks about draft, scheduled, or published Youanai post records and pipeline state. Scope: posts:read, read-only.
• posts_get Use this when an exact Youanai post needs a reviewable detail view, including caption, media previews, and links when available. Scope: posts:read, read-only.
• media_search Use this when choosing existing gallery media for a post, media reuse recommendation, or content analysis. Scope: media:read, read-only.
• media_get Use this when an exact gallery item needs preview details before attaching, reusing, or recommending it. Scope: media:read, read-only.
• media_upload Use this immediately when the user attaches an image or video file in ChatGPT. Upload the attachment to the selected Youanai workspace gallery and use the returned mediaId in drafts_create or posts_schedule; do not ask the user to provide a separate URL. Scope: media:write.
• images_generate Use this when a post needs a relevant image; normal post creation should generate or attach an image unless the user explicitly asks for text-only, no image, or no media. Scope: media:write.
• videos_generate Use this only when the user asks for video or the creative direction clearly calls for video; start an async generation job and poll with videos_get. Scope: media:write.
• videos_get Use this to poll or recover status for an async Youanai video generation job. Scope: media:read, read-only.
• analytics_summary Use this for read-only social performance summaries, trends, and recommendations before creating follow-up content. Scope: analytics:read, read-only.
• drafts_create Use this only after caption and media are ready to create draft-only Youanai posts. If the user attached an image or video directly in ChatGPT, call media_upload first and pass its mediaId here. For normal post creation, attach a relevant image first unless the user explicitly asks for text-only, no image, or no media. Scope: posts:write.
• posts_schedule Use this only after workspace timezone, future time, platforms, connection status, caption, and media are ready. If the user attached an image or video directly in ChatGPT, call media_upload first and pass its mediaId here. Use targets only for optional per-account Facebook or TikTok routing. For TikTok, treat privacy, interaction, and disclosure as thread-scoped user consent: use MCP_TIKTOK_SETTINGS_REQUIRED creator choices to ask the user once in the current chat thread with one combined question covering the privacy level with the parenthetical (Required for TikTok posting), commercial-content disclosure, and comment, Duet, and Stitch permissions. Present only account-specific choices. Treat the user's answers to those questions as confirmation, do not ask for a separate confirmation, and immediately retry with the exact settings once all required answers are present. Reuse the exact confirmed settings for every subsequent TikTok post in that thread; ask again only if the user changes a setting, selects a different account, or current creator choices no longer validate them. Never redirect the user to Youanai Social settings as a substitute, default a setting, or insert invisible or placeholder caption characters. Attach a relevant image first for normal posts unless the user explicitly asks for text-only, no image, or no media. Scope: posts:schedule.
• business_dna_get Use this before brand-aware content creation, post improvement, or recommendations to read saved audience, positioning, tone, colors, and business knowledge. If it is not ready, guide an in-chat Business DNA bootstrap before continuing. Scope: business_dna:read, read-only.
• business_dna_patch Use this only when the user explicitly asks to update brand memory or approves a Business DNA bootstrap proposal; apply a structured update or virtual-doc patch to Business DNA. Scope: business_dna:write.
• search Use this for ChatGPT-friendly discovery across allowed Youanai posts and media before fetching exact details. Scope: workspace:read, read-only.
• fetch Use this to fetch bounded, citable details for one resource id returned by search. Scope: workspace:read, read-only.

Add it to your assistant

ChatGPT, Claude and Codex each add Youanai as a custom connector or MCP server, then open a Youanai sign-in. The step-by-step guide with screenshots is on the MCP page. For Codex the command is codex mcp add youanai --url https://youanai.com/api/mcp.

Endpoint (Streamable HTTP): https://youanai.com/api/mcp/docs

codex mcp add youanai-docs --url https://youanai.com/api/mcp/docs

Base URL: https://youanai.com. The full contract is the OpenAPI 3.1 document.

• GET /api/v1/pricing Products, plans and USD prices, with a sign-up link per plan.
• GET /api/v1/products Every product, whether it is live or in development, and its URLs.
• GET /api/releases and GET /api/releases/{slug} Release notes.

Example

curl -s https://youanai.com/api/v1/pricing \
  | jq '.products[] | {product: .name, plans: [.plans[] | {code, interval, price}]}'

Behavior

• Responses are JSON with Access-Control-Allow-Origin: * and Cache-Control: public, max-age=300, s-maxage=3600. Honor the cache headers instead of polling.
• There is no published per-key rate limit. Requests are served from a shared cache, and abusive traffic may be throttled.
• Only GET, HEAD and OPTIONS are supported. Other methods return a JSON 405.
• Errors are JSON: { "error": { "code", "message", "docs" } }. Unknown /api/* paths return a JSON 404 with the code NOT_FOUND.

• /llms.txt Site summary and page index for language models.
• /llms-full.txt The same index with full page content.
• /AGENTS.md What Youanai is, when to use it and how to connect.
• /.well-known/ard.json Agentic resource discovery catalog.
• /.well-known/api-catalog RFC 9727 API catalog.
• /.well-known/agent-skills/index.json Agent Skills index.
• /.well-known/mcp/server-card.json MCP server card for the product server.
• /.well-known/mcp/server-cards.json MCP server cards for every Youanai MCP server.
• /openapi.json OpenAPI 3.1 for the public API.

Markdown for any page

Public pages are available as Markdown. Send Accept: text/markdown, or add .md to the URL:

curl -s -H "Accept: text/markdown" https://youanai.com/pricing
curl -s https://youanai.com/pricing.md

• /api/v1/pricing JSON plans and prices for agents and scripts.
• /pricing Pricing overview for people.