Weir MCP server — Reddit and X (Twitter) data for AI agents
Weir is a remote MCP server that gives Claude, ChatGPT, Cursor, VS Code, Codex and any other MCP
client read-only access to public Reddit and X (Twitter) data: search, posts, comment threads,
profiles, followers, Lists, Spaces and long-form X Articles, plus monitors that report what is new.
https://api.weirapp.io/mcp
Streamable HTTP. Clients sign in with OAuth on first use, so there is no key to paste; headless
runs can send an API key as a bearer token instead. No Reddit or X account or API key is needed.
This repository holds a Claude Code plugin, a Gemini CLI extension, an agent skill and ready-made
client configurations, plus a Dify plugin (dify/weir) and Docker MCP Catalog entries (docker/),
both awaiting their marketplaces' review. The server itself is hosted; there is nothing to run.
Writing code against the API? A second server searches Weir's documentation, with no sign-in:
https://docs.weirapp.io/api/mcp
Its tools are search_docs, read_doc and list_docs. In Claude Code:
claude mcp add --transport http weir-docs https://docs.weirapp.io/api/mcp.
Install in one command
| Where | Command |
|---|
| Claude Code (plugin: the server plus a skill that tells Claude when to use it) | /plugin marketplace add tarun-khatri/weir-mcp, then /plugin install weir@weir |
Gemini CLI (extension: the server plus GEMINI.md) | gemini extensions install https://github.com/tarun-khatri/weir-mcp |
| Any agent that reads skills | npx skills add tarun-khatri/weir-mcp |
Each one signs you in with OAuth in the browser the first time a tool runs. Step-by-step guide: https://weirapp.io/integrations/agent-skills
Set it up by hand
| Client | How |
|---|
| Claude (web, desktop, mobile) | Customize → Connectors → + Add → Add custom connector, URL https://api.weirapp.io/mcp (Team/Enterprise: Organization settings → Connectors) |
| Claude Code | claude mcp add --transport http weir https://api.weirapp.io/mcp, then /mcp to sign in |
| ChatGPT | Plugins → Add custom MCP server, URL https://api.weirapp.io/mcp (plan permitting) |
| Cursor | configs/cursor.mcp.json in ~/.cursor/mcp.json |
| VS Code (Copilot) | configs/vscode.mcp.json in .vscode/mcp.json |
| Codex | configs/codex.config.toml in ~/.codex/config.toml, then codex mcp login weir |
| Devin Desktop | configs/devin-desktop.mcp_config.json |
| CI / headless (API key) | configs/claude-code.mcp.json with WEIR_API_KEY in the environment |
Full, current instructions for every client: https://docs.weirapp.io/mcp-coding-agents and
https://docs.weirapp.io/mcp-chat-apps
Check it works: ask your assistant "What's my Weir usage?" — it calls get_usage, which is free.
Tools
Every endpoint of the REST API is also a tool. Highlights:
- Reddit:
search_reddit, search_subreddit, get_reddit_post, get_reddit_comments,
get_subreddit, get_subreddit_posts, get_subreddit_comments, get_reddit_user, lookup_reddit
- X:
search_x, get_x_post, get_x_thread, get_x_replies, get_x_quotes, get_x_article,
get_x_user, get_x_user_posts, get_x_user_followers, get_x_list_posts, get_x_space
- Account and monitors:
get_usage, get_limits, list_monitors, list_monitor_results
All data tools are read-only and annotated as such. Tools accept pasted links as well as ids.
Example prompts
- "What are developers on r/SaaS saying about usage-based pricing this month? Summarise the top threads."
- "Read the replies to https://x.com/… and group the main objections."
- "Read this X Article and give me the key claims: https://x.com/…/status/…"
- "Find recent X posts from @OpenAI with at least 500 likes about agents."
Notes
Weir reads public data only and never posts, likes or messages. It is independent and not
affiliated with Reddit or X. Support: [email protected]
