Claude Code setup

Add Reddit and social search to Claude Code in one command

Claude Code connects to remote MCP servers over HTTP. One command registers Reddinbox and sends your API key as a header. After that, Claude can search and read threads while it works.

Get your API keyI already have an account

Free trial. No credit card required.

Steps

Set up Claude Code step by step

  1. 1

    Create an API key

    Sign up, open Settings, then API keys. Create a key and copy it. It starts with rdb_ and is shown once.

  2. 2

    Run the add command

    Paste the command below into your terminal and replace the placeholder with your key.

  3. 3

    Confirm it connected

    Run claude mcp list, or type /mcp inside a Claude Code session. Reddinbox should show as connected with five tools.

  4. 4

    Ask for threads

    Ask Claude to search for a topic. It will call search_threads and return posts with links.

Where the config lives
  • Run the command in your terminal. Claude Code stores it in your local config for the current project by default.
  • Add --scope user to the command to make Reddinbox available in every project.

Check it works

First prompts to try

  • Use reddinbox to search Reddit for complaints about our latest release this week.
  • Fetch the full comment tree for this thread URL and list the feature requests.
  • List my Reddinbox Market Briefs.

Tools

What Claude Code can call

  • search_threads

    Search Reddit, X, Hacker News, Bluesky and Facebook. Spam and AI-generated noise is filtered out. Returns raw posts with links.

    querystringrequired
    What to search for.
    platformsstring[]
    Limit to specific platforms. Defaults to all your plan allows.
    communitystring
    Subreddit or community to search within.
    timestring
    Time range, e.g. day, week, month, year.
    limitnumber
    Max posts to return.
    Example response
    {
  "posts": [
    {
      "platform": "reddit",
      "title": "The new export flow is much slower after the update",
      "body": "Since the last release, exporting takes over a minute...",
      "url": "https://www.reddit.com/r/example/comments/abc123/",
      "author": "example_user",
      "community": "r/example",
      "engagement": {
        "upvotes": 214,
        "comments": 58
      },
      "created_at": "2026-09-30T14:12:00Z"
    }
  ]
}
  • get_thread

    Fetch a full Reddit or Hacker News thread with its nested comment tree.

    urlstringrequired
    Thread URL.
    max_commentsnumber
    Max comments to return (default 300, max 500).
    Example response
    {
  "post": {
    "title": "The new export flow is much slower",
    "url": "https://www.reddit.com/r/example/comments/abc123/"
  },
  "comments": [
    {
      "author": "another_user",
      "body": "Same here, started right after the update.",
      "score": 41,
      "replies": []
    }
  ]
}
  • summarize_feedback

    Summarize sentiment and themes from a query or from posts you already fetched.

    querystring
    Search and summarize. Provide this or posts.
    postsobject[]
    Posts from search_threads to summarize.
    focusstring
    What to focus on, e.g. a feature name.
    Example response
    {
  "summary": "Mostly negative on export speed; positive on the new dashboard.",
  "themes": [
    {
      "label": "Slow exports",
      "sentiment": "negative",
      "sources": [
        "https://www.reddit.com/r/example/comments/abc123/"
      ]
    }
  ]
}
  • list_briefs

    List your Reddinbox Market Briefs and the latest report for each.

    No parameters.

    Example response
    {
  "briefs": [
    {
      "id": "uuid",
      "niche_label": "Project management software",
      "platforms": [
        "reddit",
        "x"
      ]
    }
  ]
}
  • run_research

    Run a full Reddinbox research strategy on a topic: keyword and community selection, multi-platform search, filtering.

    topicstringrequired
    Topic to research.
    Example response
    {
  "strategy": {
    "keywords": [
      "export slow"
    ],
    "communities": [
      "r/example"
    ]
  },
  "posts": []
}

Troubleshooting

Claude Code troubleshooting

The server shows as failed or needs authentication
Check the header. It must read Authorization: Bearer rdb_..., with the word Bearer and a space. Remove and re-add the server with the corrected command.
Claude says the tool is not available
Run /mcp in the session to see the connection state. Start a new session after adding a server, since tool lists load at start.
I get an access or budget error
The key's account must have an active trial or paid plan with token budget left. Check usage under Settings, API keys.
Rate limit message
Each key allows 30 calls per minute. Ask Claude to batch searches or wait a minute.
I want to remove it
Run claude mcp remove reddinbox. Revoke the key in Settings if you no longer need it.

Frequently asked questions

Related pages

Back to the Reddinbox MCP overview

Connect Claude Code to real conversations

Create a key, paste the config and ask your first question.

Get your API keyI already have an account

Free trial. No credit card required.

Join 500+ practitioners already using Reddinbox

Stop Guessing What Your Audience Wants

Start your free trial today and discover real insights from millions of conversations. No credit card required.

No credit card required
Full access to all features
Cancel anytime