ClimbX

Aggregate performance summary for the connected account: headline KPIs, a per-format breakdown and a daily series of posts and impressions over the last N days. Read-only.

get_analytics

When and how often the connected account posts: median views by hour posted, the best 3-hour window with its % lift and sample size, and 90 days of activity (active days, current streak, days at the daily goal, the goal, and the per-day grid). Hours use the `timezone` in the response: check `timezone_source` - 'account' means the user's ClimbX timezone, 'default_utc' means none is set and hours are UTC, so convert before advising. The activity grid is always UTC days. Read-only.

get_posting_habits

The connected account's highest- and lowest-reach posts over the last N days, each with post id, URL, text, format, impressions and its reach as a multiple of the period's median. Low posts are at least 24h old. Read-only.

get_posts_to_learn_from

Random outlier posts from ClimbX's outlier library, excluding creators the account already tracks (the app Surprise me discovery feed). Read-only.

get_surprise_outliers

Read today's existing 10 Ready Posts batch and its generation state. Each post includes ready_post_id (pass it to schedule_post to keep the post linked), is_scheduled and scheduled_posts with linked calendar IDs, text, scheduled_for timestamps, statuses, and edit_url for active entries. Use these links to identify already scheduled drafts; the batch status label alone may be historical. This tool never starts generation, rerolls a batch, spends credits, or changes a post. If posts is empty and generating is false, call prepare_ready_posts only when the user asked to prepare or review Ready Posts.

get_ready_posts

The connected account's voice persona, evidence-backed learnings, cadence targets, and posting schedule. Use it to draft in the owner's voice and time posts well. Read-only.

get_voice_profile

The connected account's latest weekly report, as the Weekly report screen shows it: the period, posts analyzed, average reach vs the previous period, the main takeaway, every strongest pattern (action, % lift, signal strength, explanation) and median reach by day of week. Serves the stored report; when none exists yet it says so. Read-only.

get_weekly_report

List the connected account's recent published posts with their latest metrics (impressions, likes, replies, reposts). Read-only.

list_posts

List upcoming scheduled posts (pending + publishing). Read-only. scheduled_for is the UTC instant; scheduled_for_local is the same time in the user's calendar timezone (top-level `timezone`), which is what the ClimbX calendar shows, so always present times to the user as scheduled_for_local. For 'today', 'tomorrow', or another calendar day, pass date; the account's configured schedule timezone is used unless timezone is provided, and each dated result includes edit_url. To change a post's text, call edit_scheduled_post once the user approves the new text: it keeps the same id and slot and does not use a daily-cap slot. Never cancel and re-create to change text. Also show edit_url as a clickable 'Open in Studio' link so the user can open the post themselves.

list_scheduled

Prepare today's first missing 10 Ready Posts batch. This invokes ClimbX's existing AI generation pipeline and may take around a minute. It is idempotent: an existing complete batch is returned unchanged, concurrent calls join the active run, and this tool can never request a paid reroll. Drafts are saved in ClimbX for the user to review and edit; nothing is posted to X. Use only when the user explicitly asks to prepare/generate Ready Posts, or asks to review them and today's batch does not exist.

prepare_ready_posts

Publish a post to X immediately from the connected ClimbX account. This posts publicly on X and cannot be undone from ClimbX. Only call it after the user has seen the exact final text and explicitly asked to publish it now; otherwise share the draft in chat or use schedule_post. Posts containing links are rejected. Counts against the 8 posts per day API cap. Not safe to retry after a success: a second call publishes a second post. Requires write access granted at connect time.

publish_post

Move a pending scheduled post to a new time. Overwrites the previous time. Only call it when the user asked to move that specific post. Requires write access granted at connect time.

reschedule_post

Schedule a post for a future time. Prefer the user's own wall-clock time with no offset (e.g. 2026-10-13T09:00): ClimbX reads it in the user's calendar timezone, so 9:00 means 9:00 on their ClimbX calendar. An ISO datetime with an offset also works. The response echoes scheduled_for_local; confirm that time to the user. At that time ClimbX publishes it publicly on X from the connected account. Only call it after the user has approved the exact text and time. Same rules as publish_post: no links, shares the 8 posts per day cap. Each call creates a new scheduled post, so do not retry after a success. The user can reschedule or cancel it before it goes out. When the text came from get_ready_posts, pass that post's ready_post_id so the Ready Post shows as scheduled and counts as the user's pick. Requires write access granted at connect time.

schedule_post

Draft ONE short reply, in the account owner's voice, to a post they are considering replying to. The draft is a SUGGESTION for the human to edit and send on X themselves - it is never posted. Locked (403) until the owner has written enough manual replies in the ClimbX Engage tab; each draft spends one shared daily AI credit. Requires write access granted at connect time.

suggest_reply