find_subreddits
Locate subreddits by topic and verify names before browsing or searching Reddit; returns confirmed candidates, search suggestions, subscriber counts, NSFW flags, and status details.
Instructions
Find subreddits for a topic and check subreddit names before you use them. Call this before browse_subreddit or search_reddit with any subreddit you are not sure exists. Give query as 2 to 4 keywords (not a sentence) and up to 10 candidate names. results: your confirmed candidates first, then Reddit's own search suggestions, each with a url, subscribers with an as-of time, an nsfw flag, its type (restricted means most accounts cannot post there) and its source. not_found: candidates Reddit did not return, or that are not valid names. unavailable: names that exist but are private, quarantined or banned; do not browse those. If the name check itself fails, candidates come back with confirmed_exists false, meaning unchecked. NSFW subreddits and suggestions under min_subscribers are left out and counted. Needs Reddit API credentials.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "find_subreddits"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Default 10, range (1-50). Most Reddit search suggestions to return. Change ONLY IF user asks. | |
| query | Yes | 2 to 4 keywords for the topic, as you would type them in a search box (e.g., "budget cooking", "mechanical keyboards"). NOT a sentence: Reddit matches words, so long phrases return unrelated subreddits. | |
| candidates | No | Up to 10 subreddit names you think fit, without r/. Each is checked against Reddit; names Reddit does not return come back in not_found. | |
| include_nsfw | No | NSFW subreddits left out are counted in nsfw_hidden. Leave unset to follow the server setting (NSFW hidden unless the server owner chose otherwise). Set true ONLY IF the user asks for NSFW content; set false to hide it. No effect on a server set to never return NSFW. | |
| min_subscribers | No | Default 1000. Search suggestions with fewer subscribers are left out and counted in small_hidden; your candidates are never filtered by size. Lower it ONLY IF the user wants niche or new communities. |