Start reading X

Turn a public X URL into Markdown. No API key, login, or SDK needed.

x.md turns a public X URL into Markdown your agent can read. The rule is one sentence: replace x.com with x.pcstyle.dev and keep the rest of the URL. Nothing to install, no key, no login.

To read an X (Twitter) post, thread, or profile, swap x.com for
x.pcstyle.dev in the URL and fetch it. For search, fetch
https://x.pcstyle.dev/search?q=<query>. The response is Markdown.

Summarize https://x.com/trq212/status/2052809885763747935 and its replies.

claude mcp add --transport http x-md https://x.pcstyle.dev/mcp

Reading it yourself

The same host swap works in a browser or a script. The API is documented in full under Posts and threads, Search, and Profiles; the short version:

# A post, as Markdown
curl -sS 'https://x.pcstyle.dev/trq212/status/2052809885763747935'

# Search, as JSON with fields instead of prose
curl -sS 'https://x.pcstyle.dev/search?q=typescript&feed=latest&format=json'

Search returns up to 20 results; pick Latest, Top, Photos, Videos, or Users with feed. JSON responses include the rendered markdown too. See response formats.

When to use x.md

Reach for x.md when the job is reading one piece of public X content right now:

• An agent needs the text of a public X post, thread, or X Article and cannot run a browser or log into X.
• You are resolving an x.com, twitter.com, or t.co link found in a document, issue, changelog, or chat log.
• You want a public profile’s bio and latest original posts without holding X credentials.
• You are checking who a public account follows, or who follows it.
• You need X search results as structured data rather than a rendered timeline.
• You are saving a post into notes or a vault — ?format=obsidian emits YAML frontmatter.

One plain GET, no key, no OAuth. Send Accept: text/markdown for Markdown or Accept: application/json for JSON.

When not to use it

• Anything that writes. x.md never posts, replies, follows, likes, bookmarks, or sends direct messages, and it accepts no X credentials.
• Private, protected, suspended, or deleted content. Never available; no parameter unlocks it.
• X Lists, direct messages, notifications, the home timeline, analytics. Not supported.
• Bulk or firehose collection. The service is rate limited and cached for interactive use; a page walk stops at ten pages of twenty.
• Guaranteed completeness. Results come from public upstream providers and can be delayed or truncated. Check warnings rather than inferring.
• Anything needing an SLA. x.md is a free, best-effort, MIT-licensed project.

For agents

Any documentation page can be fetched as Markdown: append .md to its URL, or send Accept: text/markdown.

Next steps