Docs
Kalen Docs
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)
- Open Settings → Connectors.
- Choose Add custom connector, name it Kalen and paste
https://kalen.si/mcp. - Click Connect, sign in to Kalen and choose Allow.
- In a chat, turn Kalen on from the tools menu and ask for your week of posts.
ChatGPT
- Open Plugins in the sidebar, click Add and choose Add custom MCP server.
- Name it Kalen, keep Server URL, paste
https://kalen.si/mcpand leave Authentication on OAuth. - 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
- Ask your AI to start with Kalen. It calls
account, which reports your plan, your X connection and your profile. - If X isn’t connected, open the link from
connect_xand approve Kalen on X. - Tell your AI your niche, keywords, reference accounts, time zone, posting window and tone. It saves them with
setup_profile. - 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.