Skip to content

Reddit and X data in Claude Code

Run one claude mcp add command and Claude Code can search Reddit and X, read full threads and look up users and followers through ChatterAPI's hosted MCP server. Nothing runs on your machine. Every result shows what it cost.

MCP server URLhttps://api.chatterapi.com/mcp

What you get

  • Every live Reddit and X tool is available as an MCP tool: search, threads, subreddits, users, followers, timelines, leads and brand mentions.
  • Each result includes credits.charged and credits.remaining, so the agent can see what it spent.
  • Every key gets two free tools: chatterapi_account for your balance and chatterapi_list_tools for every tool and its cost.
  • You don't need a Reddit or X developer account. The same key works for REST calls and draws from the same credit balance.

Set it up

  1. Create an API key

    Sign in at chatterapi.com/signup with Google and create a key on the Keys page. You get 100 free credits. A ca_test_ key returns recorded samples for 0 credits, which is handy during setup.

  2. Add the server

    Run this once in your terminal. Set CHATTERAPI_KEY in your shell first, or paste the key in its place. Add --scope user to use it in every project, or --scope project to share it through the repo's .mcp.json.

    terminal
    claude mcp add --transport http chatterapi https://api.chatterapi.com/mcp \
  --header "Authorization: Bearer $CHATTERAPI_KEY"

  3. Check it connected

    Run claude mcp list and chatterapi should show as connected. Inside a session, /mcp lists its tools.

    terminal
    claude mcp list

  4. Or commit it to the project

    A project .mcp.json can read the key from the environment, so nobody has to commit it.

    .mcp.json
    {
  "mcpServers": {
    "chatterapi": {
      "type": "http",
      "url": "https://api.chatterapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${CHATTERAPI_KEY}"
      }
    }
  }
}

Try a search

Ask in plain words. Claude picks reddit_search and passes the arguments below. The response is a real recorded call.

Try this prompt

Search Reddit for posts from the past year asking which CRM a small business should use, and sum up what people recommend.

{
  "method": "tools/call",
  "params": {
    "name": "reddit_search",
    "arguments": {
      "q": "best crm for small business",
      "time": "year"
    }
  }
}
response, first 2 rows
{
  "data": [
    {
      "id": "1wdihhj",
      "fullname": "t3_1wdihhj",
      "title": "What CRM should a small business use?",
      "body": "We’re a small B2B business with 6 people and sales is still pretty founder led, but revenue has grown enough that keeping leads, follow ups and customer conversations spread across spreadsheets and inboxes is starting to…",
      "author": "NotedWhisky",
      "subreddit": "CRM",
      "permalink": "/r/CRM/comments/1wdihhj/what_crm_should_a_small_business_use/",
      "url": "https://www.reddit.com/r/CRM/comments/1wdihhj/what_crm_should_a_small_business_use/",
      "externalUrl": null,
      "score": 51,
      "numComments": 186,
      "upvoteRatio": null,
      "createdAt": "2026-09-11T14:52:16.000Z",
      "nsfw": false,
      "locked": null,
      "media": null
    },
    {
      "id": "1vmy4xb",
      "fullname": "t3_1vmy4xb",
      "title": "If You Had to Pick the Best CRM for Small Business Today, What Would It Be?",
      "body": "I've spent the last few days reading reviews and watching videos, and somehow I'm even more undecided than when I started.\n\nEvery CRM looks amazing on its website, but that doesn't tell you what it's like after you've be…",
      "author": "Living_Dependent242",
      "subreddit": "CRMSoftware",
      "permalink": "/r/CRMSoftware/comments/1vmy4xb/if_you_had_to_pick_the_best_crm_for_small/",
      "url": "https://www.reddit.com/r/CRMSoftware/comments/1vmy4xb/if_you_had_to_pick_the_best_crm_for_small/",
      "externalUrl": null,
      "score": 10,
      "numComments": 56,
      "upvoteRatio": null,
      "createdAt": "2026-08-13T02:25:31.000Z",
      "nsfw": false,
      "locked": null,
      "media": null
    }
  ],
  "page": {
    "nextCursor": "AX-v…",
    "hasMore": true
  }
}

Recorded from a live call on . Long text is shortened and the cursor is cut. A live key is charged 2 credits for this call. A test key returns this same sample for 0 credits.

Limits worth knowing

  • Claude Code warns when a single MCP tool output passes 10,000 tokens, and MAX_MCP_OUTPUT_TOKENS defaults to 25,000. Pass a small limit to keep results short. source
  • Requests to HTTP MCP servers time out after 60 seconds by default. Some Reddit reads take several seconds, so keep the default or raise it with MCP_TOOL_TIMEOUT. source
  • MCP_TIMEOUT sets the server startup timeout, which defaults to 30 seconds. source
  • The default scope is local, stored in ~/.claude.json. Project scope writes .mcp.json at the repo root. source

Last checked . Sources: Claude Code MCP docs, Claude Code environment variables.

Questions

Is there a Claude skill as well?
Yes. Run npx skills add Amplifyx-Labs/chatterapi-skill. It tells Claude which tool fits which job and to ask before an expensive run.
Does it cost more through Claude Code than through REST?
No. MCP and REST call the same tools, cost the same credits and draw from one balance.
Can I try it without spending credits?
Yes. Use a ca_test_ key. Every tool returns a recorded sample for 0 credits, whatever you ask.
Is ChatterAPI part of Reddit or X?
No. ChatterAPI is independent and not affiliated with Reddit, Inc. or X Corp.

What people build with it

AI coding and chat clients

Give your agent Reddit and X data

Sign up and get 100 free credits. No card required.

Get API keyRead the docs