Docs

Kalen Docs

Last updated

Kalen is an X (Twitter) assistant that works inside your AI app. It researches what works in your niche, scores the drafts your AI writes, and schedules and publishes the posts you approve on your X account. Your AI writes the posts. Kalen does not run a writing model.

Before you connect

  • A Kalen account. You can create it with an email address or with Google during the first connection.
  • An X account to publish to. You connect it from Kalen, through X’s own sign-in screen.
  • A plan to schedule posts (Starter, Pro or Ultra, each with a 7-day free trial). Without a plan you can connect X, set up your profile and score drafts. Prices are on the home page.

Connect Kalen

The connector URL is https://kalen.si/mcp.

Claude (web, desktop and mobile)

  1. Open Settings → Connectors.
  2. Choose Add custom connector, name it Kalen and paste https://kalen.si/mcp.
  3. Click Connect, sign in to Kalen and choose Allow.
  4. In a chat, turn Kalen on from the tools menu and ask for your week of posts.

ChatGPT

  1. Open Plugins in the sidebar, click Add and choose Add custom MCP server.
  2. Name it Kalen, keep Server URL, paste https://kalen.si/mcp and leave Authentication on OAuth.
  3. Sign in to Kalen and choose Allow.

Claude Code

Create an API key on the Setup page in your Kalen account, then run once in a terminal:

claude mcp add --transport http kalen https://kalen.si/mcp --header "Authorization: Bearer <key>"

Cursor and VS Code

Add the server to ~/.cursor/mcp.json or .vscode/mcp.json with the URL above and an Authorization: Bearer <key> header that uses a key from your Setup page.

First steps

  1. Ask your AI to start with Kalen. It calls account, which reports your plan, your X connection and your profile.
  2. If X isn’t connected, open the link from connect_x and approve Kalen on X.
  3. Tell your AI your niche, keywords, reference accounts, time zone, posting window and tone. It saves them with setup_profile.
  4. Offer Kalen your voice: it can learn how you write from your posts and keep your stories (your numbers, what you shipped, your positions) with voice.

Example prompts

  • “Plan my week of posts on X and show me the table.”
  • “Write three posts about what I shipped this week, score them and schedule the best two.”
  • “Why did this post work? https://x.com/…”
  • “Turn this blog post into an X thread.”
  • “Review my X profile and rewrite my bio.”

Tools

Read tools only look things up. Write tools change something in your Kalen account or on X.

Tool Type What it does
account Read Your plan, credits, X connection and profile.
connect_x Read A link to connect your X account.
setup_profile Write Saves your niche, keywords, reference accounts, time zone, posting window and tone.
voice Write Reads or saves your voice profile and story bank.
get_briefing Read The day’s research for your niche: what is working and why.
refresh_moment Read Today’s news and trends in your niche.
plan_week Read Pillars, open slots and post shapes for a week, and a balance check of the plan.
get_slots Read Your open posting slots.
write_post Read The method for one post or thread, with shapes and skeletons.
write_article Write The method and the niche’s most-saved X Articles, and a score of your draft.
write_reply Write Context to write replies to a post, and a score of the options.
repurpose Read Turns a LinkedIn post, blog post, newsletter or video script into a post or thread.
score_posts Write Scores drafts against your niche and flags what reads as machine writing.
study_post Read Why a post worked, to write one like it.
insights Write What is working for you or for another account.
optimize_profile Write A review of your X profile with a new bio to paste on x.com.
upload_media Write A link to upload images, GIFs or videos for a post.
schedule_posts Write Schedules approved posts on your X account.
list_scheduled Read Your queue of scheduled and published posts.
update_post Write Changes a scheduled post’s text, time or media.
cancel_post Write Cancels a scheduled post.
inbox Write Comments on your posts, to answer them.

Approvals

Kalen never publishes without your approval. schedule_posts first returns the plan for you to check, and only schedules after you say yes. cancel_post asks before it cancels. Replies and X Articles are posted by you on x.com.

Credits and limits

Plans include monthly credits. Research and publishing spend them (a thread costs one credit a tweet). account shows your balance. Limits per plan are on the home page.

Disconnect

Remove the connector in your AI app, or revoke an app from the Setup page in your Kalen account. Disconnect X from your Profile page in Kalen, or from your X settings. See the Privacy Policy for what we store and how to delete it.

Support

Email support@kalen.si.

Questions? Contact support

Starter $9/mo · Pro $29/mo · Ultra $49/mo See the plans

Contact support

We reply by email, usually within one business day.