KissMyPost MCP Server

Use this when the user asks about Reddit as a whole: how many people are active, posts or comments per day, how many subreddits are active, or who Redditors are (gender, age, country, bots), e.g. "How many people are active on Reddit?". Returns, for the latest complete month: people who posted or commented (readers and logged-out visitors are not counted), accounts active over 12 months, posts and comments per day, active subreddits, gender split, median age, top country and the share of posts from known bots. No arguments; one call covers all of these. One subreddit is "Subreddit overview" (size) or "Subreddit audience" (people). No daily item limit. Access: works without sign-in; no kisses spent.

Use this when the user asks how often Reddit writes a word, phrase, product or name in posts and comments, or how that changed over time, e.g. "How often has Reddit mentioned Cursor IDE?", "How many times was GummySearch alternative written word for word?". Counts the name in text even without a link. Matching: match "exact" (default) = the words next to each other as one phrase, any case; quotes are not needed and change nothing. match "all" = every word anywhere in the same post or comment, any order: broader, for loose ideas ("onboarding feedback saas") or when the exact phrase finds little. Punctuation at the edges is ignored. Words that almost every post uses ("the", "how to") are refused on their own - add a specific word. Returns total posts and comments, first and peak month, the trend, every month of the period and the top 10 subreddits (no NSFW). period sets the window ("24m" default, up to "all" since 2005); subreddit limits the count to one community (then no subreddit breakdown). Links to a brand's website are a different measure: "Brand mentions". Daily limit: different phrases per UTC day - 6 without sign-in, 12 on a free account, 200 on a paid one; repeating the same one is free. Access: needs a signed-in KissMyPost account (free is enough); no kisses spent.

Use this when the user wants to read actual Reddit posts about a word or phrase, e.g. "show me posts asking for a GummySearch alternative", "what do people say about PDF editors in r/smallbusiness?". Returns up to 10 posts: title, FULL post text, subreddit, month, score, comments and reddit.com link, from the last 24 months. Reposts of the same post are shown once; posts where the query is only in the body are marked. Matching: match "exact" (default) puts posts with the exact phrase in the title first, then the phrase in the body, then (if fewer than 10) posts with all the words anywhere; match "all" skips the phrase step. Quotes are not needed. sort "relevance" (default) = on-topic titles first, then the strongest reaction; "new" = newest first. subreddit limits to one community. For counts and trends "Reddit mentions of a phrase" is the right tool; this one is for reading examples. Cost: 1 kiss per phrase, then that phrase is unlocked for 30 days (other match, sort or subreddit for it cost nothing). Empty results are not charged. Daily limit: different phrases per UTC day - 6 without sign-in, 12 on a free account, 200 on a paid one; repeating the same one is free. Access: part of paid KissMyPost plans; a new free account gets a one-time allowance of kisses to try it. Without access the answer names the plan that includes it - pass that on as a plain fact.

Use this when the user asks who is in ONE subreddit: demographics, gender split, age, or what else its people are into, e.g. "audience of r/SaaS by age", "demographics of r/fitness". Compares the regulars with all Reddit regulars: share of women, median age and every age group, where else they spend time on Reddit and what they talk about more than average. One call covers all of these. NSFW left out. Two subreddits or groups side by side: "Compare subreddits" (one call for both sides, so separate audience lookups add nothing). Size and growth: "Subreddit overview". Daily limit: different subreddits or pairs per UTC day - 50 without sign-in, 200 on a free account, 200 on a paid one; repeating the same one is free. Access: works without sign-in; no kisses spent.

Use this when the user asks how big ONE subreddit is, whether it is growing or how active it is, e.g. "How big is r/personalfinance and is it growing?". Returns members, 12-month member growth, posts and active authors per month, main topics and language, for the latest complete month in the KissMyPost archive (named in the answer) with a link to the full report. Not covered here: who the members are (gender, age, interests) - "Subreddit audience"; when to post - "Best time to post"; rules - "Subreddit posting rules"; communities like it - "Similar subreddits". Daily limit: different subreddits per UTC day - 6 without sign-in, 12 on a free account, 200 on a paid one; repeating the same one is free. Access: works without sign-in; no kisses spent. Errors: a misspelt name returns up to 3 suggested names; private and NSFW subreddits are not covered.

Use this when the user asks what is allowed in ONE subreddit or how likely a post is to be removed there, e.g. "What are the posting rules in r/Entrepreneur?", "Can I post links in r/SaaS?". Returns allowed post types, crossposts, karma or account-age gates and how often posts get removed there. Nothing is posted. Cost: 5 kisses per subreddit, then unlocked for 30 days. Daily limit: different subreddits per UTC day - 6 without sign-in, 12 on a free account, 200 on a paid one; repeating the same one is free. Access: part of paid KissMyPost plans; a new free account gets a one-time allowance of kisses to try it. Without access the answer names the plan that includes it - pass that on as a plain fact.

Use this when the user asks which subreddits exist for a topic, hobby, product category or audience, e.g. "where do people discuss pdf editors?", "subreddits for home espresso". Matching: whole words (not parts of words) in subreddit NAMES and DESCRIPTIONS, any language. Light English stemming: "editing" also matches "editor", "edits". Several words are NOT one phrase: each word counts on its own and rarer words weigh more ("espresso" outweighs "home"); a word in the name counts twice as much as in the description. Only the first 6 words that match anything are used; the answer lists the ignored ones. Communities with posts last month come first. Tips: 1-4 specific words ("pdf editor", "espresso grinder") beat a sentence; add a synonym rather than a long list. Quotes change nothing. Returns up to 10 with members, posts last month and a short description; NSFW left out. Neighbours: "Search subreddits" matches names only; "Top subreddits" ranks the biggest and fastest growing in a broad area; "Explore Reddit topics" finds what is discussed, by meaning. Daily limit: different searches per UTC day - 6 without sign-in, 12 on a free account, 200 on a paid one; repeating the same one is free. Access: works without sign-in; no kisses spent.

Use this when the user knows (part of) a subreddit NAME and wants the exact spelling or every community with that word in its name, e.g. "subreddits with keto in the name", "is it r/Entrepreneur or r/entrepreneurs?". Matching: names only, not descriptions. Ranked: exact name > name starts with the query > query at a word boundary inside the name > anywhere in the name > close misspellings; active communities first. Returns up to 10 with members and posts last month. NSFW and bot-only communities are left out. Not for topics: communities ABOUT something are found by "Find subreddits by topic" (names and descriptions, whole words); the biggest or fastest growing by "Top subreddits". Daily limit: different searches per UTC day - 6 without sign-in, 12 on a free account, 200 on a paid one; repeating the same one is free. Access: works without sign-in; no kisses spent.

Use this when the user asks when to post in ONE specific subreddit, e.g. "When should I post in r/startups?". Returns the best day of week and hour in UTC (convert to the user's time zone when answering), how much timing matters there, the time zones of its active audience and how much data the answer rests on. Reddit only, not other social networks. For a concrete post idea across several candidate subreddits, "Where and when to post" gives the best day and hour per subreddit for that topic. Daily limit: different subreddits per UTC day - 6 without sign-in, 12 on a free account, 200 on a paid one; repeating the same one is free. Access: works without sign-in; no kisses spent.

Use this when the user asks how often Reddit links to a brand, product or company website, or how a brand shows up on Reddit, e.g. "How often does Reddit link to notion.so?", "Nike as a brand on Reddit". Counts posts and comments that link to the domain or write the domain out ("notion.so"): totals, monthly for the last 12 months, top subreddits and topics. Input: a website domain ("nike.com", "notion.so") is matched exactly. A brand name ("Nike", "Notion") is matched to its tracked domain; if several brands share the name you get their domains - call again with one. Not every brand is tracked. Links vs words: this counts links and domains. The brand NAME written in text without a link ("Nike") is counted by "Reddit mentions of a phrase". For "how much does Reddit talk about X" both answers are useful; they measure different things. Daily limit: different brands per UTC day - 6 without sign-in, 12 on a free account, 200 on a paid one; repeating the same one is free. Access: works without sign-in; no kisses spent. NSFW brands are refused.

Use this when the user wants to compare the people of two subreddits or two groups of subreddits, e.g. "Compare r/cats and r/dogs", "r/python vs r/learnpython + r/javascript". One call returns both sides: how much they overlap, gender and age of each side, where each side spends time elsewhere and which topics each side is more into. NSFW left out. a and b are lists of names ("cats" or "r/cats"). One name per side works on every account; more than one name on a side compares a group and needs a paid account. Daily limit: different subreddits or pairs per UTC day - 50 without sign-in, 200 on a free account, 200 on a paid one; repeating the same one is free. Access: works without sign-in; no kisses spent.

Use this when the user asks what Reddit discusses around a subject or which narrower topics it splits into, e.g. "What topics come up around sourdough baking?", "What do people discuss about AI agents?". Searches the KissMyPost map of Reddit topics by MEANING, not exact words, so synonyms and rephrasings find the same topics; a made-up or too vague query returns no topics rather than random ones. Returns up to 10 topics with their place in the topic tree, size and the subreddits where each is discussed most. No post texts; NSFW left out. Neighbours: "Find subreddits by topic" lists communities by words in their names and descriptions; "Where and when to post" takes a concrete post idea or draft. Daily limit: different topic searches per UTC day - 6 without sign-in, 12 on a free account, 200 on a paid one; repeating the same one is free. Access: works without sign-in; no kisses spent.

Use this when the user wants fresh threads to reply to in specific subreddits, e.g. "find threads in r/SaaS and r/startups where I could help". Takes 1-10 subreddit names and returns up to 10 fresh threads worth replying to: full post text, age, score, link, and the full text of past replies that did well on similar threads (with their points). Nothing is posted. Cost: 10 kisses per run; the same set of subreddits again the same UTC day costs nothing. Daily limit: different subreddits per UTC day - 6 without sign-in, 12 on a free account, 200 on a paid one; repeating the same one is free. Access: part of paid KissMyPost plans; a new free account gets a one-time allowance of kisses to try it. Without access the answer names the plan that includes it - pass that on as a plain fact.

Use this when the user asks for studies or published data about how Reddit works, e.g. "Is there research on how often Reddit removes posts?". Searches KissMyPost studies of Reddit data (best time to post, removals, age and gender, brand mentions, first customers, subreddit counts and more) and returns each matching study's short answer, date and link with DOI. Leave query out to list all studies. Matches English words in titles, keywords and summaries; a study needs at least half of the query words, so 1-3 key words work best. Up to 5 matches. Live numbers for one subreddit, phrase or brand come from the data tools. No daily item limit. Access: works without sign-in; no kisses spent.

Use this when the user asks for subreddits like a given one, alternatives to it or communities with the same people, e.g. "subreddits like r/running", "alternatives to r/SaaS". Returns up to 10 subreddits with similar topics and up to 10 with an overlapping audience (the same regular authors). Small subreddits with few regulars get a note that the audience list is only a weak hint; subreddits with too few posts have no topic list. To measure overlap and differences between two named subreddits use "Compare subreddits"; to find communities for a topic, "Find subreddits by topic". Daily limit: different subreddits per UTC day - 6 without sign-in, 12 on a free account, 200 on a paid one; repeating the same one is free. Access: works without sign-in; no kisses spent.

Use this when the user asks for the biggest, fastest growing or most active subreddits, on all of Reddit or in a broad area, e.g. "fastest growing fitness subreddits", "biggest subreddits". Returns three monthly rankings, top 10 each: biggest (members), fastest growing (members gained in 12 months) and most active (people commenting per month), for the latest ranked month named in the answer. NSFW left out. topic is a broad area ("fitness", "programming", "cooking", "finance", "gaming"). A loose name is matched to the closest area (the answer says which); if nothing fits you get a list of the main areas - pick one and call again. A narrow niche ("home espresso") is better served by "Find subreddits by topic". No daily item limit. Access: works without sign-in; no kisses spent.

Use this when the user has a post idea, title or draft and asks where or when to post it on Reddit, e.g. "Where should I post: I built a free PDF editor?". Returns the subreddits where similar posts already live, how they scored (median), the best day and hour (UTC) in each, related subreddits, the peak hour for the topic and whether it is seasonal. Nothing is posted. Write the title as it would be posted; add body for a better match. A vague idea gets a weak match and the answer says so. Cost: 5 kisses per run; the same draft again the same UTC day costs nothing No daily item limit. Access: part of paid KissMyPost plans; a new free account gets a one-time allowance of kisses to try it. Without access the answer names the plan that includes it - pass that on as a plain fact.