[ model_context_protocol ]
// MCP_SERVER

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 ]
01

› get_your_api_key

› sign up and subscribe to a paid plan, then generate an api key from your account dashboard.

02

› add_server_config

› add the following mcp server config to your ai client · works with claude desktop, cursor, windsurf, and others

› language::json[ readonly ]
{
  "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

03

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

› sign up or log in to your account · [sign up]

02

› subscribe to a paid plan (api access requires a paid subscription) · [paid plan]

03

› go to your account dashboard · [account]

04

› find the api key section and click "generate api key"

05

› 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_response.json [ readonly ] 
{
  "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
// EXAMPLE_PROMPT

› "List all programming-related subreddits"

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 ]

› Get trending keywords from Reddit, sorted by popularity.

// 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] Time filter - "latest", "today", "week", "month"
category string [opt] Category filter (e.g. Technology, Health, Sports)
// 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

› conversation.log [ example ] 
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

› conversation.log [ example ] 
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

› conversation.log [ example ] 
You: What's trending in tech on Reddit this week?

AI: [Uses reddit_get_trends tool with filter "week"]

Reddit Trends (Filter: week, Category: technology)
Page 1 of 3, Total: 28 articles

1. AI Coding Assistants: Are They Replacing Junior Developers?
   By Sarah Chen | technology
   Published: 2024-01-15 | Views: 12,453
   Tags: ai, coding, career, tools
// 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 [ 3 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

› free tier allows 10 req/min · wait or upgrade to a paid plan for higher limits

// RESOURCES [ 6 links ]
› mcp_documentation

official protocol specification
› anthropic_docs

claude and mcp client docs
› rest_api

direct api integration
› llms.txt

llm-friendly documentation
› agent_skill

full api & mcp skill definition
› openclaw_marketplace

install via openclaw
// CTA · GET_STARTED

Ready to connect your AI?

› connect your ai assistant to reddit search api and start exploring

▶ get_api_key /view_rest_api