WEIR
Get a key
Theme

A Reddit and X (Twitter) MCP Server for Claude, ChatGPT, Cursor and VS Code

Connect a Reddit MCP server and Twitter MCP server to Claude, ChatGPT, Claude Code, Cursor or VS Code, compared with X's own MCP and local Reddit servers.

By Tarun Khatri · · 10 min read

If you want an AI assistant to read Reddit and X, the simplest route is a remote MCP server: you add one URL to Claude, ChatGPT, Claude Code, Cursor or VS Code, sign in, and the model can search posts, read threads and pull profiles itself. This guide gives the exact setup steps for each client using Weir's server (https://api.weirapp.io/mcp), shows which tools get called for typical prompts, and compares it honestly with X's official MCP and the open-source Reddit MCP servers, which are the better fit in some cases.

Disclosure: Weir is our product. The alternatives below are real options, and the comparison says when to pick them.

What an MCP server is

The Model Context Protocol is "an open-source standard for connecting AI applications to external systems." An MCP server publishes a list of tools, each with a name, a description and a JSON schema for its inputs. An MCP client (Claude, ChatGPT, an IDE agent) shows that list to the model, and the model decides when to call a tool and with what arguments.

There are two kinds of server:

  • Local (stdio). A program on your machine that the client launches. Most open-source Reddit and X servers work this way. You install it, give it your own API credentials, and it only works in clients that can launch local processes.
  • Remote (Streamable HTTP). A URL. Nothing to install, and it works in web clients like claude.ai and chatgpt.com, which can't start programs on your computer. Sign-in is usually OAuth.

Weir is a remote server. It exposes one tool per REST endpoint, named after the operation in snake_case: searchReddit becomes search_reddit, and getXArticle becomes get_x_article.

Reddit and X data for AI: what the tools cover

Every connection gets the read tools. A few of them:

Tool What it does Credits
search_reddit Search Reddit posts, optionally inside subreddits 1 + 3 per post
get_reddit_post, get_reddit_comments One post, and its comment tree 1 + 3 per item
get_subreddit_posts, search_subreddits Browse or find communities 1 + 3 per post / 1 per community
search_x Search X posts with filters (fromUsers, minLikes, since, language...) 1 + 1 per post
get_x_post, get_x_thread, get_x_replies, get_x_quotes A post and its conversation 1 + 1 per post
get_x_user, get_x_user_posts, get_x_user_followers Profiles, timelines, followers 1 + 2 per profile, + per item
get_x_article The full body of a long-form X Article 1 + 1
get_x_list_posts, get_x_space Lists and Spaces varies
get_usage, get_limits, get_identity Your balance and limits free

Monitor reads (list_monitors, list_monitor_results) are there by default too. Tools that create monitors or webhooks only appear on a connection that was explicitly granted that access when you approved it, because a monitor keeps spending credits after the chat ends. Weir is read-only: no tool posts, likes or follows.

Set it up in Claude (web, Desktop, mobile)

Claude calls these custom connectors, and Anthropic's guide says they're available on Free, Pro, Max, Team and Enterprise. Free accounts are limited to one.

Pro and Max:

  1. Open Customize, then Connectors.
  2. Click + Add, then Add custom connector.
  3. Name it Weir and paste https://api.weirapp.io/mcp.
  4. Keep the authentication Claude detects and click Add. Claude opens Weir's consent screen: sign in and approve.

Team and Enterprise: an Owner adds it under Organization settings, Connectors, Add, Custom, Web. On Team plans only Owners and Primary Owners can add one. Members then click Connect on it under Customize, Connectors.

The connector follows your account to Claude Desktop and the mobile apps. Don't put this URL in claude_desktop_config.json, which is for local servers only. Claude reaches remote connectors from Anthropic's cloud, not from your machine.

Check it works: in a new chat, ask "What's my Weir usage?" Claude should call get_usage, which is free.

Set it up in Claude Code

One command:

claude mcp add --transport http weir https://api.weirapp.io/mcp

Then run /mcp inside Claude Code, choose weir, and sign in in the browser that opens. For CI or claude -p, where no browser is available, pass a Weir API key instead:

claude mcp add --transport http weir https://api.weirapp.io/mcp \
  --header "Authorization: Bearer $WEIR_API_KEY"

Your shell expands $WEIR_API_KEY before Claude Code sees it, so the key ends up in Claude Code's settings. To keep it out of every file, use a project .mcp.json with "Authorization": "Bearer ${WEIR_API_KEY}": Claude Code expands that variable when it connects. claude mcp list should show weir as connected.

Set it up in ChatGPT

As of October 2026, OpenAI's help article says custom MCP connections with full MCP support are available on ChatGPT Business and Enterprise/Edu, on the web. Pro users "can connect custom MCP servers with read/fetch permissions". The article doesn't list Plus or Free. On Business, only admins and owners can create them. Mobile isn't supported.

The current steps, from OpenAI's connect guide:

  1. Go to chatgpt.com/plugins, click the + button, and choose Add custom MCP server.
  2. Name it Weir and enter https://api.weirapp.io/mcp as the public endpoint.
  3. Choose OAuth for authentication, review the risk warning, and tick I understand and want to continue.
  4. Select Create as a plugin, review the discovered tools, and install it. Sign in to Weir and approve when asked.
  5. In a new chat, type @ and pick Weir.

You don't need to turn on Developer Mode first. When Weir adds tools, open the plugin and use Refresh: ChatGPT keeps a snapshot of the tool list until someone refreshes it.

Set it up in Cursor

Add this to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "weir": {
      "url": "https://api.weirapp.io/mcp"
    }
  }
}

Cursor supports OAuth for remote servers and asks you to sign in the first time it connects. Cursor ignores an Authorization header in this file while the server offers sign-in, so don't bother adding a key here.

Set it up in VS Code (GitHub Copilot)

In .vscode/mcp.json, or your user mcp.json, the top-level key is servers and the transport has to be stated:

{
  "servers": {
    "weir": {
      "type": "http",
      "url": "https://api.weirapp.io/mcp"
    }
  }
}

Or from a terminal:

code --add-mcp '{"name":"weir","type":"http","url":"https://api.weirapp.io/mcp"}'

Start the server from the file and VS Code handles the OAuth flow, opening a browser on first connection. Then ask Copilot in agent mode "What's my Weir usage?"

Codex, Gemini CLI, Zed, Cline, Goose, Continue and the Claude Agent SDK are covered in Weir's coding agents docs.

Example prompts and the tools they call

These show what the model typically does. The exact calls depend on the model, and you can always see them in the client's tool-call view.

"What are people on r/selfhosted saying about Tailscale this month? Quote the most upvoted complaints." The model calls search_reddit with {"query": "tailscale", "subreddit": "selfhosted", "time": "month", "sort": "top"}, then get_reddit_comments on the two or three biggest threads to read the replies.

"Compare how Reddit and X reacted to the latest Next.js release." Two calls, because the platforms are searched separately: search_reddit with {"query": "next.js release", "sort": "new", "time": "week"} and search_x with {"query": "next.js", "minLikes": 20, "since": "2026-10-12T00:00:00Z"}.

"Summarise what @vercel posted this week." get_x_user_posts with {"user": "vercel", "limit": 20}.

"Read this thread and list the objections people raised: https://x.com/.../status/..." get_x_thread on the post id, then get_x_replies for the replies.

"Summarise this X Article: https://x.com/.../status/..." get_x_article, which returns the full body as Markdown. The post itself only contains a t.co link. There's more on that in reading X Articles via API.

Two habits keep costs down. Ask for small result counts first (the tools default to 10), and put filters in the prompt rather than asking the model to filter afterwards, because every returned result is billed. A 402 error means the account is out of credits, and retrying won't fix it.

How this compares with X's MCP and other Reddit MCP servers

X's official MCP (XMCP and the hosted X MCP)

X documents an MCP server for the X API, hosted at https://api.x.com/mcp. You reach it through X's open-source xurl bridge (npx -y @xdevplatform/xurl mcp https://api.x.com/mcp), or with an app-only bearer token. X also publishes xmcp, a local Python server that turns the X API's OpenAPI spec into tools.

  • Where it's better: it's X's own API. It can write: the hosted server can manage bookmarks and "create draft Articles and publish them", and xmcp includes tools such as createPosts and likePost. If your agent needs to post, Weir can't do that.
  • What it needs: your own X developer app ("X's OAuth requires your own developer app", say the docs) and credits on the X API's pay-per-usage pricing, which lists post reads at $0.005 each as of October 2026. The docs also note the server doesn't support native MCP OAuth discovery, so clients go through the local bridge or a static token. That makes it awkward in claude.ai or chatgpt.com.
  • Scope: X only.

Open-source Reddit MCP servers

Reddit doesn't offer an MCP server for reading Reddit content. Its only official one, devvit-mcp, is "an MCP server for writing Devvit applications", a coding aid for building apps on Reddit's platform. The community has filled the gap with local servers:

Server How it reaches Reddit Credentials Read / write
Arindam200/reddit-mcp PRAW (Python) Reddit client id and secret; username and password for writes Read and write (create_post, reply_to_post)
Hawstein/mcp-server-reddit redditwarp (Python) None in config Read-only
karanb192/reddit-mcp-buddy RSS when anonymous, or Reddit OAuth (TypeScript) Optional Read-only
adhikasp/mcp-reddit Python Not stated in the README Appears read-only
  • Where they're better: free and open source, you control the code, and some can post and reply. If you only use Claude Desktop or an IDE on your own machine and have Reddit API credentials, one of these may be all you need.
  • What they need: they run locally over stdio, so they don't work in claude.ai or chatgpt.com unless you host them yourself. The PRAW-based ones need your own Reddit API app, and getting one is now harder than it used to be. Reddit's Responsible Builder Policy says "You must request access and get explicit approval before accessing any Reddit data through our API." Once you're approved, the Data API Wiki limits free access to 100 queries per minute per OAuth client id. reddit-mcp-buddy's README says anonymous mode falls back to RSS at about 10 requests a minute, and that search and comments need credentials.
  • Scope: Reddit only.

Where Weir fits

Weir X MCP / xmcp Local Reddit servers
Platforms Reddit and X X Reddit
Runs Remote URL Hosted, via a local bridge / local Local
Works in claude.ai and chatgpt.com Yes (OAuth) Not directly Only if you host it
Your own platform API credentials No Yes, an X developer app Usually a Reddit app
Can post or like No Yes Some
Cost 5,000 free credits a month, then prepaid packs X API pay-per-usage Free software; Reddit API terms apply

Pick Weir if you want both platforms behind one sign-in, in web clients, with no developer apps to register. Pick X's MCP if you need to write to X or want a direct relationship with X. Pick a local Reddit server if you're comfortable running one and holding your own credentials.

On terms: any tool that reads platform data is subject to that platform's rules, and how you store or reuse what you read is up to you. Weir only reads public data. This isn't legal advice.

Doing this with Weir

Create a free account (5,000 credits a month, no card), add https://api.weirapp.io/mcp to your client, and ask "What's my Weir usage?" to confirm it works. Full per-client instructions are in Claude and ChatGPT and coding agents. Rates are on pricing. If you'd rather have mentions pushed to you than ask for them, see building a Reddit and X brand mention monitor.

Sources

Keep reading