integrations tools x-organic

X Organic MCP for your AI agent

Cogny's X Organic integration exposes 16 tools (8 read, 5 write, 3 destructive) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app.

8readonly reads data.
5writecreates or changes something.
3destructivedeletes, removes or replaces something.

Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations. Plans, approvals and limits

set it up.

Add Cogny to your AI client once, then connect X Organic in Cogny. Every X Organic tool below appears in the client.

Claude CodeRun claude mcp add --transport http cogny https://app.cogny.com/mcp, then authorise in the browser.
Claude.aiSettings → Connectors → Add custom connector, URL https://app.cogny.com/mcp, then log in and pick your workspace.
ChatGPTSettings → Apps → Advanced settings → Developer mode → Create app, URL https://app.cogny.com/mcp, authentication OAuth.
CursorIn Cogny, Settings → Data & Integrations → Connect AI Clients shows the block to paste into .mcp.json, with an API key.
CodexRun codex mcp add cogny --url https://app.cogny.com/mcp.

Full setup, and how to undo it

Connecting and limits

Connecting signs in to one X account, and the connection is that account: X's sign-in page is shown every time you connect, so you choose which account to connect there. There is no list of accounts to pick from afterwards; connecting a different account means reconnecting.

Every tool is metered per call, because X charges for its API per request and per post read.

Known gaps

One X account per workspace connection. A second account needs a second workspace.
non_public_metrics and organic_metrics (link clicks, profile clicks) exist only for the connected account's own posts from the last 30 days.

what each tool does.

Read 8 · only reads data

tool_check_post_lengthReadCount a draft post the way X does, before you publish it.
tool_get_meReadThe connected X account: id, username, bio, follower/following/post counts.
tool_get_userReadLook up any public X account by @username (profile + follower counts).
tool_get_user_postsReadRecent posts from the connected account (or another public @username), newest first, with metrics.
tool_get_postsReadFetch up to 100 posts by id with text, links, media and metrics.
tool_get_mentionsReadPosts mentioning the connected account, newest first.
tool_search_recent_postsReadSearch public posts from the last 7 days.
tool_get_post_repliesReadReplies in a post's conversation (last 7 days only — older replies are not reachable on this API tier).

Write 5 · creates or changes something

tool_create_postWritePublish a post (publicly, immediately) as the connected account.
tool_create_threadWritePublish a thread: each post replies to the previous one.
tool_upload_mediaWriteUpload an image, GIF or video to X and return a media_id for create_post.
tool_like_postWriteLike a post as the connected account.
tool_repostWriteRepost (retweet) a post as the connected account.

Destructive 3 · deletes, removes or replaces something

tool_delete_postDestructiveDelete one of the connected account's posts.
tool_unlike_postDestructiveRemove the connected account's like from a post.
tool_undo_repostDestructiveUndo the connected account's repost of a post.

Exact input schemas come from tools/list once X Organic is connected; the free plan is enough to check. Missing something? Your agent can ask for it with request_feature.

This page as markdown All integrations