x-relay-mcp
v1.4.0
Published
Deep-research tool for X/Twitter — CLI (xrelay) + MCP shim + Claude Code skill. Live search, profiles, threads, and an incrementally-synced local cache of your bookmarks and posts. No paid X API.
Maintainers
Readme
x-relay
A read + archive + write tool for X/Twitter for AI agents — a TypeScript CLI (xrelay), an MCP server
(x-relay-mcp), and a Claude Code skill. Cast a wide net with live search, rank candidates cheaply on
engagement metadata, and read full threads only for the finalists — plus a local, incrementally-synced cache
of your own bookmarks and posts, full-fidelity archiving (bookmarks / user timelines / lists / likes /
feed to rich JSON), and write operations (post / reply / quote / like / bookmark / retweet / follow /
delete). No paid X API: a from-scratch engine on X's private GraphQL surface using your login cookies.
Status: complete read + archive + write surface. Design and engine research are in
PLAN.mdanddocs/ENGINE-RESEARCH.md. Built in the spirit of its siblingyoutube-relay-mcp: atomic capabilities, the agent composes the strategy, a generatedSKILL.mdteaches the funnel.
Why a CLI + skill (not just an MCP server)
The task is a search/fetch/rank pipeline. An agent shells out to xrelay, taught by the bundled SKILL.md.
The MCP shim is provided for parity and non-CLI hosts.
License
MIT © Tamas Gabor
