AIsa Reddit

search

get_reddit_search

Read-onlyIdempotent

Searches every public subreddit for posts matching a query and returns posts plus an after token to page. Each post carries title, author, selftext, selftext_html, subreddit, score, ups, downs, upvote_ratio, num_comments, created_utc, created_at_iso, url, permalink, subreddit_subscribers, is_video, over_18 and spoiler. sort accepts relevance, new, top and comment_count, and timeframe narrows the window. Measured at 8 to 16 seconds and 8 to 26 KB, the slowest endpoint here. To stay inside one community use get_reddit_subreddit_search, which is faster and pages with cursor rather than after; to read one post's discussion use get_reddit_post_comments.

Usage-based billing; Default request estimate: $0.00188 USD (not a fixed price). Account-specific pricing and final settlement may differ.

Input Schema

Name	Required	Description
`sort`	No	Sort by Provider reference (supplier schema): `{"enum":["relevance","new","top","comment_count"],"type":"string"}`.
`time`	No
`trim`	No	Set to true for a trimmed down version of the response
`after`	No	Used to paginate to next page
`count`	No
`limit`	No
`query`	No	Search query
`filter`	No	Search posts or comments
`trimmed`	No
`timeframe`	No	Timeframe Provider reference (supplier schema): `{"enum":["all","day","week","month","year"],"type":"string"}`.

Output Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed6 schema fields changedOct 20, 2026

addedInput schema / properties / after

Added value: +{
+  "description": "Used to paginate to next page",
+  "type": "string"
+}

addedInput schema / properties / filter

Added value: +{
+  "description": "Search posts or comments",
+  "enum": [
+    "comments",
+    "posts"
+  ],
+  "type": "string"
+}

addedInput schema / properties / query / description
```
Added value: +"Search query"
```

addedInput schema / properties / sort / description

Added value: +"Sort by\n\nProvider reference (supplier schema): `{\"enum\":[\"relevance\",\"new\",\"top\",\"comment_count\"],\"type\":\"string\"}`."

addedInput schema / properties / timeframe / description

Added value: +"Timeframe\n\nProvider reference (supplier schema): `{\"enum\":[\"all\",\"day\",\"week\",\"month\",\"year\"],\"type\":\"string\"}`."

addedInput schema / properties / trim / description

Added value: +"Set to true for a trimmed down version of the response"

Changed16 schema fields changedOct 15, 2026

removedInput schema / properties / after

Removed value: -{
-  "description": "Used to paginate to next page",
-  "example": "t3_1i8z28z",
-  "type": "string"
-}

addedInput schema / properties / count
```
Added value: +{
+  "type": "string"
+}
```
addedInput schema / properties / limit
```
Added value: +{
+  "type": "string"
+}
```
removedInput schema / properties / query / description
```
Removed value: -"Search query"
```
removedInput schema / properties / sort / description
```
Removed value: -"Sort by"
```

removedInput schema / properties / sort / enum

Removed value: -[
-  "relevance",
-  "new",
-  "top",
-  "comment_count"
-]

removedInput schema / properties / sort / example
```
Removed value: -"relevance"
```
addedInput schema / properties / time
```
Added value: +{
+  "type": "string"
+}
```
removedInput schema / properties / timeframe / description
```
Removed value: -"Timeframe"
```

removedInput schema / properties / timeframe / enum

Removed value: -[
-  "all",
-  "day",
-  "week",
-  "month",
-  "year"
-]

removedInput schema / properties / timeframe / example
```
Removed value: -"all"
```

removedInput schema / properties / trim / description

Removed value: -"Set to true for a trimmed down version of the response"

removedInput schema / properties / trim / example
```
Removed value: -"false"
```

changedInput schema / properties / trim / type

Previous value: -"boolean"New value: +"string"

addedInput schema / properties / trimmed
```
Added value: +{
+  "type": "string"
+}
```

changedInput schema / required

Previous value: -[
-  "query"
-]New value: +[]

Changed4 schema fields changedSep 18, 2026
- addedInput schema / properties / after / example
```
Added value: +"t3_1i8z28z"
```
- addedInput schema / properties / sort / example
```
Added value: +"relevance"
```
- addedInput schema / properties / timeframe / example
```
Added value: +"all"
```
- addedInput schema / properties / trim / example
```
Added value: +"false"
```
First observedSep 15, 2026

TDQS

A4.3/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly/openWorld/idempotent/destructive=false, so safety is covered. The description adds substantial non-annotation behavior: latency (8-16s, slowest endpoint), payload size (8-26 KB), pagination via an after token, and the full returned field list. It stops short of documenting rate limits or failure behavior, but adds real context beyond the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the core action, then alternatives, then performance. The 19-field enumeration is verbose but informative for a search result. The pricing block is boilerplate appended by the platform rather than the author's prose, so it doesn't count against structure.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so the field list is somewhat redundant, yet the description still supplies pagination, performance expectations, sorting semantics and routing to siblings. It omits auth/prerequisite notes and does not flag that 'query' is practically required despite required=[], a minor gap for a 10-param tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 60%, so the description must compensate for some gaps. It meaningfully enriches 'sort' (relevance, new, top, comment_count) and 'timeframe' (narrows the window) and explains 'after' for paging, but leaves limit, count, trim/trimmed, filter and query semantics to the schema. Adequate but partial.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Searches every public subreddit for posts matching a query') with scope ('every public subreddit') and names what it returns. It explicitly distinguishes itself from get_reddit_subreddit_search and get_reddit_post_comments, so an agent can tell them apart without opening schemas.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Names two alternatives with the exact conditions that select them: use get_reddit_subreddit_search 'to stay inside one community' and get_reddit_post_comments 'to read one post's discussion'. This is explicit when-to-use-each guidance rather than implied context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All AIsa Reddit tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?