Eden

USE WHEN the user asks about a SPECIFIC creator's content by name, handle, or URL — "best tweets from @dankoe", "top videos from Ali Abdaal this quarter", "what does Naval post about". This is the right tool EVEN IF the user has saved that creator's posts to their workspace — it ranks against the full indexed corpus and the creator's own baseline, not the hand-picked swipe file (see server instructions for routing). WHEN THE CREATOR IS THE USER THEMSELVES asking about their own performance ("how did my posts do", "my top posts", "my engagement"), prefer `eden_get_analytics` / `eden_list_analytics_posts` — the analytics warehouse has their PRIVATE metrics (impressions, saves, watch time, email opens) plus period deltas that this public index can't see. Use this tool on their own handle only when analytics isn't set up, or when they explicitly want the public-index view of their account (outlier baseline, how their posts rank publicly). Returns a profile-level analysis: identity, totals (avg views, engagement, post count), topic/format breakdowns, and a curated set of ~8 best posts (real outliers >=1.2x the creator's own baseline, padded with recent posts when the outlier shelf is thin). The response includes a pre-rendered `text` field (markdown rollup) you can paraphrase from directly, plus structured `topPosts[]` entries each carrying a `contentId` for follow-up `eden_read_social_post` calls when you need the full body or transcript. FIRST-TIME CREATORS: when nobody on Eden has searched this creator before, the tool auto-pulls their recent posts inline (waits up to ~25s — never immediately re-call it). It then returns either `ok: true` with a `notice`, or `ok: false, status: "indexing"` with `recentPosts`, `etaLabel`, `estimatedTotalPosts`, `progress`, and a `partial` creator card. Then: render `recentPosts` immediately when present (as "what they've been posting lately", not "top posts"), show the `partial` card (bio, followers) so the reply isn't empty, prefer "we have N of ~M posts" from `progress` over `etaLabel` when `progress.synced > 0`, and use plain language with the user (never "backfill" / "sync" / "ingest" / "indexing").

eden_analyze_creator

Cancel a scheduled post or delete a draft in Eden by id, removing it from the publish queue. Use this to clean up a mistake or a throwaway draft. Find the id with eden_list_scheduled_posts. This cannot cancel a post that is already publishing (it returns a conflict) or one already posted. The cancel is permanent.

eden_cancel_scheduled_post

Check and set up the user's social account connections in Eden. Three actions: `status` lists what is connected right now (per platform, with handles; Substack includes its publication address). `get-link` mints a secure, personal account-linking link (an Eden-branded page) — give it to the user to open, where they click each network (X, LinkedIn, Instagram, Threads, TikTok) and authorize it. `sync` registers what they linked — ALWAYS call it after the user says they finished linking, or the new connections will not appear in Eden. Substack is the exception: it cannot be linked through this page; the user connects it in the Eden web app under Settings → Social accounts (https://app.eden.so/?settings=scheduling), ideally with the Eden browser extension or desktop app signed in to Substack. The linking link is tied to this user's workspace — never share it anywhere public.

eden_connect_social_accounts

Create a new empty board (a canvas) in the user's Eden workspace and pin it to the top of their sidebar. Use this when content needs a home that doesn't exist yet — e.g. before saving links, posts, or a note, when the user names a board you can't find with `eden_search_workspace_items`. Returns the board's `itemId` as `boardId`, which you pass to `eden_create_note`, `eden_save_links_to_board`, or `eden_save_posts_to_board`. Search for an existing board by title first with distinctive tokens (`"rock bottom"`, not only `"in rock bottom"` / `"my hooks board"`); only create when there's genuinely no match. Do NOT call this in the same tool batch as `eden_search_workspace_items` — wait for search results before creating. Server-side, same-titled boards are reused when found (`reused: true`); different titles still create distinct boards. When the result says `reused: true` and the user asked for a NEW or SEPARATE board, STOP before saving anything to it — that board already holds their content; tell them it exists and ask whether to use it or create one under a different name. FOLDERS: sidebar folders are visual organization for BOARDS only — items can NEVER live in a folder, only on a board. So "put these in my <folder> folder" always means a BOARD inside that folder: find the folder first (`eden_search_workspace_items` returns matching sidebar folders in `folders`, with the boards each holds), then pick one of its boards or create one here with `folder` set — never a parallel board pretending to be the folder. `folder` places the board (new OR reused — reuse + `folder` is how an existing board moves into a folder) inside the named folder, creating the folder when none matches. When the user names a folder but no board in it fits and none is implied, ask which board they want (or offer to create one) rather than guessing.

eden_create_board

Host an image, video, or PDF for a scheduled post from a link, without sending its bytes through the conversation. Pass `file` (a file from the chat, in clients that provide one) or a public https `url`. Eden downloads it (max 512 MB), hosts it, and returns a ready `asset` for the `media` array of eden_schedule_post or eden_publish_post_now. Supported types: image/jpeg, image/png, image/webp, image/gif, application/pdf, video/mp4, video/quicktime, video/webm. For a local file with no link, use eden_upload_scheduling_media instead.

eden_import_scheduling_media

List scheduled-post rows for the workspace or one schedule: drafts, scheduled, publishing, posted, partial, failed, or cancelled. Use this to inspect the queue, confirm what was just scheduled, find a post id for a later edit/cancel tool, or read recent source posts before repurposing them into another schedule/platform set.

eden_list_scheduled_posts

List the user's Eden posting schedules (social sets, grouped under brands), active connected accounts, text limits, timezone, recurring posting slots, and upcoming free queue slots. Use this before scheduling when you need a schedule id, connected platform list, timezone, or next open slot, and before eden_update_schedule to read the current slot times. MCP scheduling supports text-first posts for X, Threads, LinkedIn, and Substack notes; Instagram and TikTok require hosted media in the write tools. Substack accounts include captured publication tag names when available; reuse those exact names for article tags.

eden_list_schedules

List the Eden workspaces the authenticated user belongs to, with id, name, slug, and role. A client workspace (agencies keep one per client) carries `billingParentWorkspaceId`, the agency workspace it belongs to; match a client the user names ("save this to Acme") by `name`. Call this first when the user hasn't told you which workspace they want; the returned `id` is what every workspace-scoped tool needs as `workspaceId`. Tool routing from there is covered by the server instructions.

eden_list_workspaces

Immediately queue a social post for publishing in Eden. This is a real publish action, not a draft or proposal. Use only when the user explicitly asks to publish/post/send now. Composing: preserve the user's line breaks exactly in `text`; a media-only post may use an empty `text`. Text-only works on X (`twitter`), Threads, LinkedIn, and Substack notes. Instagram and TikTok need hosted media (TikTok also takes a photo or a photo carousel, up to 35 images). `media` takes already-hosted public URLs from the scheduling media upload tools, never local paths. Shared images go to EVERY selected platform, LinkedIn included; never strip them from one unless the user asked. A PDF on `linkedin` publishes as a document carousel. Media for SOME platforms only: mark the asset `scheduleMediaRole: "platformScoped"` AND list its id in each intended `perPlatform.<p>.mediaIds`; `perPlatform.<p>.mediaIds: []` makes one platform text-only. YouTube is Shorts only: one vertical video plus `perPlatform.youtube.title`. X / Threads threads: pass `segments` (too-long text without them is auto-split). X: `text` that is ONLY another post's x.com URL publishes as a native repost (needs X advanced automations; the response warns when they're off); commentary plus a post URL is a quote post. Long-form: `article` with explicit `platforms` from twitter / substack. Before targeting Substack, ask for audience, whether to send email, and whether to add a paywall; never infer them.

eden_publish_post_now

Read the full body (and transcript / carousel slide text, when available) of a single social post — by DB id (`contentId` + `platform` from a prior social tool result) OR by `url` (a saved link card, a pasted x.com / youtube.com / instagram.com / tiktok.com / linkedin.com / substack.com URL, or a loom.com video — hydrated server-side on a cache miss). Pass ONE of the two. Use after `eden_analyze_creator` or `eden_search_social_content` when you want to quote specific prose: those return ~400-500 char previews, this returns up to 24K chars of body and 180K chars of transcript. Transcripts only exist for YouTube / Instagram / TikTok; Instagram/TikTok PHOTO CAROUSELS return the slide text as `slideText` (the caption alone is usually just a promo blurb), and Instagram reels / TikTok videos return the verbatim captions and overlays burned into the video as `onScreenText` (the transcript only covers audio). Uncached transcripts/slide text/on-screen text trigger an on-demand vendor fetch (~1-8s, costs vendor quota) — set `attemptLiveFetch: false` when sweeping many posts. URL mode: unsupported URLs return `status: "unsupported"` (use your client's web fetch); a post still hydrating returns `status: "queued"` — ask the user to retry in a moment. NOT for Eden's own board links (`.../spaces/<id>`) — those go directly to `eden_read_board`.

eden_read_social_post