oriiion

Save an angle card or brainstormed concept directly to the user's Idea Bank backlog for later use.

Schedule (or reschedule) a ready post for a date and time; it publishes itself then. Choose the networks with platforms — ['all'] for every connected network, or a subset like ['tiktok'] or ['linkedin','instagram']; omit to keep the post's current choice (else the account's publishing settings). instagramPlacement 'story' = Instagram story only; instagramTrialReel only when the user explicitly asks for a trial reel. Everything is checked now: the result lists the networks it will go to and any that can't publish, with the reason. For a NEW post on a date, use generate_posts with scheduledDate.

Search the user's own photo library (imported + scraped, vision-tagged) by keyword — e.g. 'coffee', 'team', 'outdoor'. Returns real photo URLs to use with change_image / add_image_to_post.

Trending or keyword-matched sounds from Instagram's audio catalog for a Reel — licensed music or original sounds. Returns audioIds to use with set_reel_audio.

Save the user's chosen brand images as visual references for post generation.

oriiion STAFF ONLY. Show the customer something on their onboarding page: kind website asks them to confirm their site (title and share image fetched by the server; confirming it starts the build), kind brand asks them to approve the logo, colours and fonts currently on their account — both pop up for the customer, who can also leave them for later. Kind note is a message in the chat beside the onboarding (also how you answer the customer's chat messages). A new website or brand card replaces an unanswered one.

Deliver, schedule or cancel a broadcast. THIS DMs REAL PEOPLE AND CANNOT BE UNDONE. Before calling with action send or schedule you MUST show the user the exact message text and the number of recipients, and get their explicit approval. You must also pass confirmRecipientCount matching the current recipient count (from add_broadcast_recipients) — the call is refused otherwise. action cancel stops a scheduled broadcast and needs no confirmation.

Send the exact approved personal email from the authenticated business mailbox to 1–5 explicit recipients. This sends real email. First show the sender, recipient addresses, subject and full body; send only when the user explicitly authorizes that message. Selecting CRM leads or preparing meeting/booking links never authorizes sending. Use verified addresses from get_business_mail_recipients, never guess them. Requires a verified sending domain and applies the same suppression, tracking, sender name, rate and storage protections as the dashboard. Reuse the same requestId UUID for the same approved message. The response confirms provider submission, not delivery. If stored is false, report that the accepted message is missing its saved copy; do not resend. On an uncertain outcome, check Sent and clarify instead of retrying with a new ID. This is personal correspondence, not a newsletter or bulk broadcast.

oriiion STAFF ONLY. Tell the customer their account exists and give them a way in. ALWAYS ASK which channel they should be contacted on — there is no default, and if the answer is SMS you must also ask for their phone number, which the tool will refuse to proceed without. Sends a link to choose their own password, valid for 7 days; a password is never put in a message. Sends once per customer — pass resend to issue a new link, which stops the old one working.

Send a direct message in an existing conversation on the user's behalf. ALWAYS show the user the exact text and get their approval before calling this — it goes to a real person immediately.

Email a password reset link to the address on an oriiion account. STAFF can name any customer by email; everyone else can only reset their own account. The link is only mailed, never shown, and replaces any earlier link. Use when someone cannot sign in or asks to change their password.

Set the user's account type. This affects which social platforms are required during onboarding.

oriiion STAFF ONLY. Change the logo, brand colours or fonts on the customer's account (not yours), e.g. after they asked for a change on the brand card. colors.background is the ground the posts are drawn on, colors.text the words on it — the brand card shows exactly that. Black, white or grey is the brand when the website's own background is that colour or the customer says so: keep it. Then send a new brand card so they can approve the result.

oriiion STAFF ONLY. Turn AI-generated pictures off (or on) for the customer's account (not yours) — when the customer says they do not want AI images, use false and say so in a note. With false, every post is made from their own photos (website, products, listings) and nothing draws a picture for them.

Save the user's confirmed brand identity. Only provided fields are updated.

Set image-bound destination cards on an unpublished owned Facebook post. Supply exactly one card for each current image, 2–10 images. Pass carousel:null to clear. Does not publish.

Set an automatic first comment for a post (posted right after publishing — commonly used for hashtags or links). Supported on Facebook, Instagram and LinkedIn. Pass an empty string to remove it.

Choose whether the user's posts use AI-created images (true) or real photos — their brand images, products and stock (false).

Add mentions/tags to a post. Instagram: photo tags (usernames) and collaborators (max 3). LinkedIn: mentions as { name, url } pairs — the caption must contain '@<name>' for each one. Applied when the post is published.

Mark an unpublished Instagram post as a paid partnership (required by law when a brand paid for it), tagging up to two sponsor usernames. Instagram shows the label on publish.

Attach a sound from search_trending_audio to an unpublished video post. Applies when it publishes as an Instagram Reel.

Save the user's confirmed social media profile URLs to their account.

Show products from the user’s connected Shopify store or website/feed as selectable cards with reference photos. Search for a product or supply 1-6 real IDs from list_products. One candidate asks “Do you mean this product?”; several let the user choose. Use when the requested product/reference is ambiguous or a likely match needs confirming. This only displays choices: STOP and wait for the user before generating or editing. When the user already clearly confirmed a product, use that selection without asking again. On text-only channels present the returned names/photos as choices in the user’s language and wait.

Run an interactive sparring turn with Oriiion's strategic Thought Partner. Brainstorms high-impact angles (contrarian, playbook, risk/opportunity, book analogies, personal story), formulates opening hooks, and delivers quick choices.

oriiion STAFF ONLY. Start building the customer's account (research, brand, images, sources, products, style guide, first posts — a few minutes, about $0.30) on a website, without waiting for the customer to confirm it. The build starts by itself when they confirm the website card, and on the typed address ten minutes after signup; use this when you have good reason not to wait. Runs once per onboarding.

SPENDS MONEY. Launch an approved draft using its exact approvalToken from create/edit/get_chatgpt_ads, or resume a paused campaign within its existing lifetime budget. State budget, fee, duration and shared advertiser identity first; confirmed=true requires user approval. A pending_review result is awaiting review, not delivering. Repeat the same campaign ID to reconcile an uncertain launch; never create another draft as a retry.

Mailbox housekeeping in the authenticated business mailbox, only when the user asks: mark messages read or unread, archive or unarchive. Sends nothing and deletes nothing. mark_read/mark_unread apply to received messages among the ids (sent mail has no read state). archive/unarchive move the whole conversation with each message’s other party, like the dashboard does. Every id must come from list_business_emails or get_business_email; one unknown or hidden id (MAIL_NOT_FOUND) rejects the whole call without changing anything. Takes 1–50 ids per call; any beyond 50 are returned as skipped. Returns the ids actually changed in updated (empty when they already were in that state). MAIL_UPDATE_REQUIRED means the business website needs its next update before this works.

Update the user's business profile information. All fields are optional — only provided fields will be updated.

Change a launched ChatGPT ad’s lifetime budget. First read get_chatgpt_ads. State the new total and additional reservation/fee and obtain approval. Additional charge = max(0, new budget - fundedBudgetCents) plus that increase × serviceFeePct (fee rounded to minor units). Send that exact additionalChargeCents and the current expectedBudgetCents. A reduction retains the existing reservation and paid fees until settlement. On an uncertain result reuse requestKey and the identical target; do not invent a fresh key.

Update a comment→DM automation, or pause/resume it. Passing isActive:false alone pauses it without changing anything else; isActive:true resumes it. Only the fields you pass are changed.

Save a standing rule the user states about their posts or images, one rule at a time, without rewriting the rest of their style guide. 'always' rules feed what every post must include or follow; 'never' rules feed what must never appear in an image or a caption. Use it the moment the user says things like 'never show measuring tools', 'the stakes must always be red' or 'stop using maps'. get_brand_identity shows what is currently saved.

Store a small file in the user's oriiion account by passing its bytes inline as base64, and get back a permanent URL for the post tools. HARD LIMIT 1MB — the whole file travels as tool-call text, so this is only for things like a logo or a one-page PDF. For anything bigger (video especially): create_media_upload_url → PUT the bytes → finalize_media_upload if you can make HTTP requests; import_media_from_url if the file is at a public link; otherwise create_upload_link. Clients that hold the raw API key may also POST up to 4MB to https://oriiion.ai/api/mcp/upload.

Resolve a person's saved character reference images within this account. Use when asked to include a named person (e.g. 'Tina ska stå på scenen') or the account's character. Pass the returned referenceImageUrls to create_image alongside the scene's imageUrl. If unresolved, ask which character or photo to use; never invent their likeness.