MCP Server
› connect your ai assistant directly to reddit search api · search millions of conversations through natural language
› the Model Context Protocol (MCP) is an open standard that enables ai assistants to securely connect to external data sources and tools. instead of copying and pasting data, your ai can directly access and analyze information in real-time.
› with our mcp server, any compatible ai client gains the ability to search reddit's vast conversation database through natural conversation.
› get_your_api_key
› sign up (free - no card required), then generate an api key from your account dashboard. free accounts get 3 tool calls every 7 days · paid plans raise the limit.
› add_server_config
› add the following mcp server config to your ai client · works with claude desktop, cursor, windsurf, and others
{
"mcpServers": {
"reddit-search-api": {
"transport": {
"type": "http",
"url": "https://reddapi.dev/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
} › replace YOUR_API_KEY with your actual key
› restart_client
› after saving the config file, restart your ai client. the reddit search api tools will be available in your conversations.
› works with claude desktop, cursor, windsurf, cline, and more. check modelcontextprotocol.io for the full list.
› the mcp server requires an api key to execute tools · without a valid key, tool execution will fail.
› sign up or log in to your account · [sign up]
› no subscription needed - free accounts can mint a key (3 tool calls / 7 days); upgrade only for a higher limit · [plans]
› go to your account dashboard · [account]
› find the api key section and click "generate api key"
› copy the key and replace YOUR_API_KEY in your mcp config
› never share your api key publicly or commit it to version control. if compromised, regenerate it from your account dashboard.
› if you try to use mcp tools without a valid api key, you'll see this error:
{
"error": {
"code": -32001,
"message": "Authentication required. Please provide a valid API key..."
}
}MCP Tools
› 6 tools available for ai assistants
reddit_semantic_search [ Requires API key ] › AI-powered semantic search. Extracts keywords via LLM, performs vector search, and generates an AI summary. Slower but more comprehensive.
| name | type | required | description |
|---|---|---|---|
| query | string | [req] | Natural language search query |
| limit | number | [opt] | Number of results (default: 20, max: 100) |
› "What do developers think about Rust vs Go for backend services?"
reddit_vector_search [ Requires API key ] › Fast vector similarity search. Directly converts query to embeddings and finds similar posts. No LLM processing, much faster.
| name | type | required | description |
|---|---|---|---|
| query | string | [req] | Search query |
| limit | number | [opt] | Number of results (default: 30, max: 30) |
› "Find posts about mechanical keyboards for programming"
reddit_list_subreddits [ Requires API key ] › Get a paginated list of available subreddits with metadata.
| name | type | required | description |
|---|---|---|---|
| page | number | [opt] | Page number (default: 1) |
| limit | number | [opt] | Results per page (default: 20, max: 100) |
| search | string | [opt] | Search filter for subreddit name/title/description |
› "List all programming-related subreddits"
reddit_get_subreddit [ Requires API key ] › Get detailed information about a specific subreddit.
| name | type | required | description |
|---|---|---|---|
| subreddit | string | [req] | Subreddit name (without r/ prefix) |
› "Get details about the typescript subreddit"
reddit_get_trends [ Requires API key ] › What Reddit is talking about: named entities (products, people, games, shows, events) extracted daily from the top posts, ranked by engagement, with the change in mentions versus the previous window.
| name | type | required | description |
|---|---|---|---|
| page | number | [opt] | Page number (default: 1) |
| limit | number | [opt] | Results per page (default: 12, max: 50) |
| filter | string | [opt] | "today" = latest computed day, "latest" / "week" = last 7 days, "month" = last 30 days |
| category | string | [opt] | Technology, Health, Markets & Investing, Politics & Activism, Entertainment, Sports, Gaming, Science, World News, Lifestyle, Other |
› "What's trending in tech on Reddit this week?"
reddit_find_leads [ Requires API key ] › Find business leads and opportunities from Reddit discussions with AI-powered lead scoring
| name | type | required | description |
|---|---|---|---|
| query | string | [req] | Natural language query for finding leads (e.g., "people looking for project management tools") |
| limit | number | [opt] | Number of leads to return (default: 5, max: 20) |
› "Find people actively looking for a better project management tool"
› research_a_topic
You: What are developers saying about React Server Components?
AI: Let me search Reddit for discussions about React Server Components.
[Uses reddit_semantic_search tool]
Found 45 results for "React Server Components developer opinions"
Keywords: react, server components, next.js, performance, ssr
AI Summary:
Developers generally praise RSC for performance benefits in large applications...
Some express concerns about the learning curve and tooling complexity...
Top Results:
1. React Server Components: A year in production
r/webdev | 1247 upvotes | 89 comments
Relevance: 94.3%› explore_a_subreddit
You: Tell me about the r/typescript community
AI: [Uses reddit_get_subreddit tool]
r/typescript - TypeScript
Subscribers: 285,432
Created: 2012-10-01
Description: A community for discussing TypeScript, a typed superset...
Recent Posts:
1. TypeScript 5.4 released with new features
567 upvotes | 45 comments
2. Help: How to type this complex nested object?
234 upvotes | 12 comments› find_trending_topics
You: What's trending in tech on Reddit this week?
AI: [Uses reddit_get_trends tool with filter "week", category "Technology"]
Reddit trends, last 7 days, Technology (page 1 of 4, 41 entities)
1. Claude Code (product) - 23 top posts, +188% vs the previous 7 days
r/ClaudeAI, r/programming, r/LocalLLaMA - first seen 2026-08-19
2. GPT-5 (product) - 17 top posts, -32% vs the previous 7 days
r/OpenAI, r/singularity - active 6 of 7 days
3. Framework Laptop 16 (product) - 6 top posts, new this window
r/framework, r/linux› MCP Streamable HTTP Transport (2025-11-25)
https://reddapi.dev/api/mcp | method | purpose |
|---|---|
| POST | handles client json-rpc requests |
| GET | opens sse stream for server messages |
| DELETE | terminates sessions |
› tools_not_showing_up
› check that your config file has valid json syntax · try copying exactly · restart your client completely
› connection_errors
› verify the url is exactly https://reddapi.dev/api/mcp · check internet & firewall
› rate_limit_exceeded
› error -32002 (http 429) · free tier allows 3 tool calls / 7 days and 3 req/min; lite and above start at 50 req/min · the error message carries the reset time — wait for it or upgrade. do not hot-retry: retries during a 429 are refunded, but a retry loop still gets you nothing until the window resets.
› error_codes
› -32001 (401) missing / invalid api key · -32003 (403) key is valid but your plan has no api access — waiting won't help · -32002 (429) out of quota, retry after the reset time in the message
› quota_accounting
› only tools/call counts · initialize / tools/list / resources/list / prompts/list are free · mcp shares one pool with the web ui and the rest api, it does not get a separate allowance · a failed tool call refunds your daily and cycle allowance but not the per-minute gate
Ready to connect your AI?
› connect your ai assistant to reddit search api and start exploring