Skip to main content

X Platform

Read posts, search tweets, post updates, upload media. Built on the official @xdevplatform/xdk TypeScript SDK (v0.4.0, MIT, zero transitive deps). Four interfaces: CLI, Module, Connection Point, Skill.

Install

Open your AI and say:
Your AI will read the repo, explain the tool, and walk you through integration interactively.

Authentication

The tool resolves credentials automatically:
  1. 1Password (preferred) … vault “Agent Secrets”, item “X Platform API”
  2. Environment variables … as a fallback
Read-only (fetch posts, search, user lookup):
Read + Write (post tweets, bookmarks, upload media):
Get credentials at https://developer.x.com/en/portal/dashboard

Usage

CLI

As a Module

Connection Point

Add to your .mcp.json:
Exposes 7 tools: x_fetch_post, x_search_recent, x_get_bookmarks, x_get_user, x_post_tweet, x_delete_tweet, x_upload_media.

Functions

Sensor (Read)

Actuator (Write)

Bearer = read-only bearer token. OAuth = OAuth 1.0a with all four tokens.

wip-xai-x vs wip-xai-grok

Use wip-xai-x to read/write on X. Use wip-xai-grok for AI-powered search and media generation.

Attribution

Built on @xdevplatform/xdk v0.4.0 (official X TypeScript SDK).

License

MIT