Reddit and X tools for your AI agent
A hosted MCP server. Paste one config and Claude Code, Cursor, Codex, Windsurf, VS Code or Claude Desktop can search Reddit and X. Every result includes what that call cost.
https://api.chatterapi.com/mcpInstall
Pick your client, paste the snippet with your key, and restart. Each tab tells you where the config lives and how to check that it worked.
Where: Run once in your terminal
claude mcp add --transport http chatterapi https://api.chatterapi.com/mcp \
--header "Authorization: Bearer $CHATTERAPI_KEY"Set CHATTERAPI_KEY in your shell first, or paste the key in place of $CHATTERAPI_KEY.
Check it worked: Run claude mcp list. chatterapi shows as connected. Then ask Claude to search Reddit for something.
Format checked Oct 14, 2026 against Claude Code's docs.
Tools your agent gets
The names your agent sees, what each tool does and what one call costs. Only live tools can be called.
| MCP tool | What it does | Credits | Status |
|---|---|---|---|
| reddit_search | Posts by keyword | 1 credit | Live |
| reddit_nsfw_search | Mature posts by keywordYour agent sees these only after you turn on 18+ tools in Settings. | 2 credits | Live |
| reddit_search_comments | Comments by keyword or author | 2 credits | Live |
| reddit_search_media | Images, videos and galleries | 2 credits | Live |
| reddit_scrape | Posts, threads and users to CSV or JSON | 1 credit | Live |
| reddit_thread | A full thread to CSV, JSON or PDF | 3 credits | Live |
| reddit_communities | Communities for any topic | 2 credits | Live |
| reddit_nsfw_communities | Mature communitiesYour agent sees these only after you turn on 18+ tools in Settings. | 2 credits | Live |
| reddit_subreddit | Size, rules, mods and posting settings | 2 credits | Live |
| reddit_subreddit_posts | Hot, new, top and rising feeds | 1 credit | Live |
| reddit_user | Profile, karma, age and badges | up to 2 credits | Live |
| reddit_user_status | Active, suspended or shadowbanned | 2 credits | Live |
| reddit_user_comments | Every comment an account made | 2 credits | Live |
| reddit_user_posts | Every post an account submitted | 1 credit | Live |
| reddit_user_search | Accounts by keyword | 2 credits | Live |
| reddit_leads | People asking for what you sell | 3 credits | Live |
| reddit_monitor | Keyword and brand alerts | 1 credit per check | Planned |
X
| MCP tool | What it does | Credits | Status |
|---|---|---|---|
| x_user | Profile, followers and bio by handle | 3 credits | Live |
| x_user_search | Accounts by keyword | 3 credits | Live |
| x_followers | Anyone's followers to CSV | 3 credits per page (20 rows by default) | Live |
| x_following | Who an account follows | 3 credits per page (20 rows by default) | Live |
| x_verified_followers | Only the blue-check followers | 4 credits per 20 rows | Live |
| x_tweets | Every tweet from an account | 3 credits | Live |
| x_mentions | Who is talking about a handle | 3 credits | Live |
| x_search | Tweets by keyword, with operators | 3 credits | Live |
| x_tweet_detail | One tweet with its stats | 3 credits | Live |
| x_replies | Every reply to a tweet | 3 credits | Live |
| x_retweeters | Who amplified a tweet | 3 credits | Live |
| x_list_members | Everyone on a list | 3 credits | Live |
| x_leads | People asking for what you sell | 3 credits | Live |
| x_dm_send | From an account you connected | 10 credits | Coming |
| x_follow | From an account you connected | 5 credits | Coming |
| x_like | From an account you connected | 5 credits | Coming |
| x_tweet | From an account you connected | 5 credits | Coming |
Reddit and X together
| MCP tool | What it does | Credits | Status |
|---|---|---|---|
| everywhere_search | One keyword across Reddit and X | up to 4 credits | Live |
| everywhere_leads | Buyers asking for your category, ranked | up to 5 credits | Live |
| everywhere_mentions | Every mention of your brand | up to 6 credits | Live |
Two free tools on every key
chatterapi_account: your balance, plan, reset date and rate limit. 0 credits.chatterapi_list_tools: every tool you can call and its cost, as a short table. 0 credits.
Credits in every result
Every tool result includes credits.charged and credits.remaining, so the agent always knows what it spent. When the balance runs out, the result carries instructionsForAgent, and the agent tells you to top up instead of retrying.
{
"method": "tools/call",
"params": {
"name": "reddit_search",
"arguments": {
"q": "best crm for small business",
"time": "year"
}
}
}{
"content": [
{
"type": "text",
"text": "{\"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 fall apart. I’m trying to figure out what the best CRM for a small business looks like when you need something the whole team can use without spending weeks setting it up. \\n \\nI keep finding everything from really basic small business CRM tools to newer AI native CRM platforms, and I’m more interested in something that can take some of the sales work off the team rather than just becoming another database we have to maintain. Main thing is finding a CRM we can grow into without needing a dedicated ops person just to keep it running.\",\"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 been using it for six months.\\n\\nI'm more interested in hearing from people who rely on one every day. Which CRM are you using, and what keeps you from switching? Is there anything about it that drives you crazy, or do you feel like it's been worth every dollar?\\n\\nMy main goal is to stay on top of leads, keep follow-ups organized, and automate the routine work without ending up with a system that's harder to manage than the business itself.\\n\\nI'd appreciate hearing some live experiences. If you've found a CRM you'd choose again, I'd love to know which one and why.\",\"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\":\"eyJ2IjoxLCJwIjoiYW55YXBpIiwiYyI6ImN1cl9qWGJYVzlhZ3E1NXBDdHI4d3VCeG9nIiwibyI6MCwiaCI6ImQ4ZmU3ZjZiNjM0OSJ9\",\"hasMore\":true},\"credits\":{\"charged\":1,\"remaining\":24999}}"
}
],
"structuredContent": {
"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 fall apart. I’m trying to figure out what the best CRM for a small business looks like when you need something the whole team can use without spending weeks setting it up. \n \nI keep finding everything from really basic small business CRM tools to newer AI native CRM platforms, and I’m more interested in something that can take some of the sales work off the team rather than just becoming another database we have to maintain. Main thing is finding a CRM we can grow into without needing a dedicated ops person just to keep it running.",
"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 been using it for six months.\n\nI'm more interested in hearing from people who rely on one every day. Which CRM are you using, and what keeps you from switching? Is there anything about it that drives you crazy, or do you feel like it's been worth every dollar?\n\nMy main goal is to stay on top of leads, keep follow-ups organized, and automate the routine work without ending up with a system that's harder to manage than the business itself.\n\nI'd appreciate hearing some live experiences. If you've found a CRM you'd choose again, I'd love to know which one and why.",
"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": "eyJ2IjoxLCJwIjoiYW55YXBpIiwiYyI6ImN1cl9qWGJYVzlhZ3E1NXBDdHI4d3VCeG9nIiwibyI6MCwiaCI6ImQ4ZmU3ZjZiNjM0OSJ9",
"hasMore": true
},
"credits": {
"charged": 1,
"remaining": 24999
}
}
}Example built from a recorded live response captured 2026-10-07, with the first two rows. Your remaining balance will differ.
For agents
You can also let your agent set itself up. Paste this line with your key:
Set up ChatterAPI from https://chatterapi.com/llms.txt with my API key.Budget your agent
Build with a test key
It returns recorded samples and costs 0, so a prompt that loops while you tune it spends nothing.
Ask it to check the balance
Tell the agent to read
credits.remainingand stop below a number you pick.Keep pages small
Pass a
limit. Each page is one charge, and short pages keep the agent's context clean.
Troubleshooting
- 401 invalid_key or missing_key
- The header is missing or the key is wrong. Keys start with
ca_live_orca_test_. Create one on the Keys page. - My client has no place for headers
- Use the
mcp-remotebridge shown in the Claude Desktop tab. It runs locally and adds the header for you. - Tools do not appear
- Restart the client after editing the config, and check the JSON is valid. Then check
curl -I https://api.chatterapi.com/mcpanswers instead of timing out. - 402 insufficient_credits
- The balance is empty. Top up or upgrade on the Billing page.
- The 18+ tools are missing
- They appear only after you turn on 18+ tools in Settings. Restart the client so it lists tools again.
- npx fails
- Install Node 18 or newer.
- Behind a corporate proxy
- Set
HTTPS_PROXYfor the client.
Full reference: MCP server docs.
Questions
What is MCP?
Does it cost more than REST?
Can I use a test key?
Which transport does it use?
Can I restrict which tools the agent sees?
Give your agent Reddit and X.
Sign up and get 1,000 free credits. No card required.