reddapi.dev MCP

Remote MCP server for semantic Reddit search, trending topics and lead discovery. Requires a reddapi.dev API key; limited free plan available.

View on reddapi.devTry this MCPSponsored

Documentation

[ model_context_protocol ]

MCP Server

› connect your ai assistant directly to reddit search api · search millions of conversations through natural language

// WHAT_IS_MCP [ overview ]

› 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.

// QUICK_SETUP [ 3 steps ]

› 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.

// OK · COMPATIBLE_CLIENTS

› works with claude desktop, cursor, windsurf, cline, and more. check modelcontextprotocol.io for the full list.

// AUTHENTICATION [ required ]

› the mcp server requires an api key to execute tools · without a valid key, tool execution will fail.

// HOW_TO_GET_API_KEY

› 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

// WARN · KEEP_KEY_SECRET

› never share your api key publicly or commit it to version control. if compromised, regenerate it from your account dashboard.

// ERROR_WITHOUT_AUTH

› 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..."
  }
}

// AVAILABLE_TOOLS

MCP Tools

› 6 tools available for ai assistants

TOOL 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.

// PARAMETERS

name	type	required	description
query	string	[req]	Natural language search query
limit	number	[opt]	Number of results (default: 20, max: 100)

// EXAMPLE_PROMPT

› "What do developers think about Rust vs Go for backend services?"

TOOL reddit_vector_search [ Requires API key ]

› Fast vector similarity search. Directly converts query to embeddings and finds similar posts. No LLM processing, much faster.

// PARAMETERS

name	type	required	description
query	string	[req]	Search query
limit	number	[opt]	Number of results (default: 30, max: 30)

// EXAMPLE_PROMPT

› "Find posts about mechanical keyboards for programming"

TOOL reddit_list_subreddits [ Requires API key ]

› Get a paginated list of available subreddits with metadata.

// PARAMETERS

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

TOOL reddit_get_subreddit [ Requires API key ]

› Get detailed information about a specific subreddit.

// PARAMETERS

name	type	required	description
subreddit	string	[req]	Subreddit name (without r/ prefix)

// EXAMPLE_PROMPT

› "Get details about the typescript subreddit"

TOOL 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.

// PARAMETERS

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

// EXAMPLE_PROMPT

› "What's trending in tech on Reddit this week?"

TOOL reddit_find_leads [ Requires API key ]

› Find business leads and opportunities from Reddit discussions with AI-powered lead scoring

// PARAMETERS

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)

// EXAMPLE_PROMPT

› "Find people actively looking for a better project management tool"

// USAGE_EXAMPLES [ 3 scenarios ]

› 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

// TECHNICAL_DETAILS [ specs ]

// PROTOCOL

› MCP Streamable HTTP Transport (2025-11-25)

// ENDPOINT

https://reddapi.dev/api/mcp

// HTTP_METHODS

method	purpose
POST	handles client json-rpc requests
GET	opens sse stream for server messages
DELETE	terminates sessions

// TROUBLESHOOTING [ 5 issues ]

› 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

// RESOURCES [ 6 links ]

[

› mcp_documentation

official protocol specification

](https://modelcontextprotocol.io/)[

› anthropic_docs

claude and mcp client docs

](https://docs.anthropic.com/)[

› rest_api

direct api integration

](https://reddapi.dev/developers)[

› llms.txt