Reddit COM: Real-time data, unofficial API reddit.com. On the JoJ API marketplace.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
auto-complete Billing per call: 1 Credits.
- Whether to retrieve content that is not safe for work (e.g., 18+ content) - Default: `false` - The `true` is yes, the `false` is no
- Limit - Default: `5` - The `limit` has a value from 1 to 10
- Required: true - Ex: `gaming`
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
auto-complete Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| nsfw | string | - Whether to retrieve content that is not safe for work (e.g., 18+ content) - Default: `false` - The `true` is yes, the `false` is no |
| limit | string | - Limit - Default: `5` - The `limit` has a value from 1 to 10 |
| query | string | - Required: true - Ex: `gaming` |
{
"type": "object",
"properties": {
"nsfw": {
"type": "string",
"description": "- Whether to retrieve content that is not safe for work (e.g., 18+ content)\n- Default: `false`\n- The `true` is yes, the `false` is no"
},
"limit": {
"type": "string",
"title": "Limit",
"description": "- Limit\n\n- Default: `5`\n\n- The `limit` has a value from 1 to 10"
},
"query": {
"type": "string",
"title": "query",
"example": "gaming",
"description": "- Required: true\n- Ex: `gaming`"
}
},
"additionalProperties": false
}posts/comments Group: Posts. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| sort | string | - Sort by - Default: `CONFIDENCE` - Choose one of the values below - `confidence`: Best - `top`: Top - `new`: New - `controversial`: Controversial - `old`: Old - `qa`: Q&A |
| postId | string | - Required: true - The `postId` can be retrieved from /posts/search-posts (data->id) - Ex: `t3_178zwq0` |
{
"type": "object",
"properties": {
"sort": {
"type": "string",
"description": "- Sort by\n- Default: `CONFIDENCE`\n- Choose one of the values below\n- `confidence`: Best\n- `top`: Top\n- `new`: New\n- `controversial`: Controversial\n- `old`: Old\n- `qa`: Q&A"
},
"postId": {
"type": "string",
"example": "t3_178zwq0",
"description": "- Required: true\n- The `postId` can be retrieved from /posts/search-posts (data->id)\n- Ex: `t3_178zwq0`"
}
},
"additionalProperties": false
}posts/search-posts Group: Posts. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| nsfw | string | - Whether to retrieve content that is not safe for work (e.g., 18+ content) - Default: `false` - The `true` is yes, the `false` is no |
| sort | string | - Sort by - Default: `relevance` - Choose one of the values below - `relevance`: Relevance - `hot`: Hot - `top`: Top - `new`: New - `comments`: Comment count |
| time | string | - Time - Default: `all` - Choose one of the values below - `all`: All time - `year`: Past year - `month`: Past month - `week`: Past week - `day`: Today - `hour`: Past hour |
| query | string | - Required: true - Ex: `gaming` |
| nextPage | string | - The page index, for paging purpose - Leave it blank for the first time - The `nextPage` can be retrieved from response of this endpoint(meta->nextPage) - Ex: `MjQ=` |
{
"type": "object",
"properties": {
"nsfw": {
"type": "string",
"description": "- Whether to retrieve content that is not safe for work (e.g., 18+ content)\n- Default: `false`\n- The `true` is yes, the `false` is no"
},
"sort": {
"type": "string",
"description": "- Sort by\n- Default: `relevance`\n- Choose one of the values below\n- `relevance`: Relevance\n- `hot`: Hot\n- `top`: Top\n- `new`: New\n- `comments`: Comment count"
},
"time": {
"type": "string",
"description": "- Time\n- Default: `all`\n- Choose one of the values below\n- `all`: All time\n- `year`: Past year\n- `month`: Past month\n- `week`: Past week\n- `day`: Today\n- `hour`: Past hour"
},
"query": {
"type": "string",
"example": "gaming",
"description": "- Required: true\n- Ex: `gaming`"
},
"nextPage": {
"type": "string",
"description": "- The page index, for paging purpose\n- Leave it blank for the first time\n- The `nextPage` can be retrieved from response of this endpoint(meta->nextPage)\n- Ex: `MjQ=`"
}
},
"additionalProperties": false
}search-comments Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| nsfw | string | - Whether to retrieve content that is not safe for work (e.g., 18+ content) - Default: `false` - The `true` is yes, the `false` is no |
| sort | string | - Sort by - Default: `relevance` - Choose one of the values below - `relevance`: Relevance - `top`: Top - `new`: New |
| query | string | - Required: true - Ex: `gaming` |
| nextPage | string | - The page index, for paging purpose - Leave it blank for the first time - The `nextPage` can be retrieved from response of this endpoint(meta->nextPage) - Ex: `MjU=` |
{
"type": "object",
"properties": {
"nsfw": {
"type": "string",
"description": "- Whether to retrieve content that is not safe for work (e.g., 18+ content)\n- Default: `false`\n- The `true` is yes, the `false` is no"
},
"sort": {
"type": "string",
"description": "- Sort by\n- Default: `relevance`\n- Choose one of the values below\n- `relevance`: Relevance\n- `top`: Top\n- `new`: New"
},
"query": {
"type": "string",
"example": "gaming",
"description": "- Required: true\n- Ex: `gaming`"
},
"nextPage": {
"type": "string",
"description": "- The page index, for paging purpose\n- Leave it blank for the first time\n- The `nextPage` can be retrieved from response of this endpoint(meta->nextPage)\n- Ex: `MjU=`"
}
},
"additionalProperties": false
}search-communities Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| nsfw | string | - Whether to retrieve content that is not safe for work (e.g., 18+ content) - Default: `false` - The `true` is yes, the `false` is no |
| query | string | - Required: true - Ex: `gaming` |
| nextPage | string | - The page index, for paging purpose - Leave it blank for the first time - The `nextPage` can be retrieved from response of this endpoint(meta->nextPage) - Ex: `MjQ=` |
{
"type": "object",
"properties": {
"nsfw": {
"type": "string",
"description": "- Whether to retrieve content that is not safe for work (e.g., 18+ content)\n- Default: `false`\n- The `true` is yes, the `false` is no"
},
"query": {
"type": "string",
"example": "gaming",
"description": "- Required: true\n- Ex: `gaming`"
},
"nextPage": {
"type": "string",
"description": "- The page index, for paging purpose\n- Leave it blank for the first time\n- The `nextPage` can be retrieved from response of this endpoint(meta->nextPage)\n- Ex: `MjQ=`"
}
},
"additionalProperties": false
}search-media Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| nsfw | string | - Whether to retrieve content that is not safe for work (e.g., 18+ content) - Default: `false` - The `true` is yes, the `false` is no |
| sort | string | - Sort by - Default: `relevance` - Choose one of the values below - `relevance`: Relevance - `hot`: Hot - `top`: Top - `new`: New - `comments`: Comment count |
| time | string | - Time - Default: `all` - Choose one of the values below - `all`: All time - `year`: Past year - `month`: Past month - `week`: Past week - `day`: Today - `hour`: Past hour |
| query | string | - Required: true - Ex: `gaming` |
| nextPage | string | - The page index, for paging purpose - Leave it blank for the first time - The `nextPage` can be retrieved from response of this endpoint(meta->nextPage) - Ex: `MjQ=` |
{
"type": "object",
"properties": {
"nsfw": {
"type": "string",
"description": "- Whether to retrieve content that is not safe for work (e.g., 18+ content)\n- Default: `false`\n- The `true` is yes, the `false` is no"
},
"sort": {
"type": "string",
"description": "- Sort by\n- Default: `relevance`\n- Choose one of the values below\n- `relevance`: Relevance\n- `hot`: Hot\n- `top`: Top\n- `new`: New\n- `comments`: Comment count"
},
"time": {
"type": "string",
"description": "- Time\n- Default: `all`\n- Choose one of the values below\n- `all`: All time\n- `year`: Past year\n- `month`: Past month\n- `week`: Past week\n- `day`: Today\n- `hour`: Past hour"
},
"query": {
"type": "string",
"example": "gaming",
"description": "- Required: true\n- Ex: `gaming`"
},
"nextPage": {
"type": "string",
"description": "- The page index, for paging purpose\n- Leave it blank for the first time\n- The `nextPage` can be retrieved from response of this endpoint(meta->nextPage)\n- Ex: `MjQ=`"
}
},
"additionalProperties": false
}search-people Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| nsfw | string | - Whether to retrieve content that is not safe for work (e.g., 18+ content) - Default: `false` - The `true` is yes, the `false` is no |
| query | string | - Required: true - Ex: `gaming` |
| nextPage | string | - The page index, for paging purpose - Leave it blank for the first time - The `nextPage` can be retrieved from response of this endpoint(meta->nextPage) - Ex: `MjQ=` |
{
"type": "object",
"properties": {
"nsfw": {
"type": "string",
"description": "- Whether to retrieve content that is not safe for work (e.g., 18+ content)\n- Default: `false`\n- The `true` is yes, the `false` is no"
},
"query": {
"type": "string",
"example": "gaming",
"description": "- Required: true\n- Ex: `gaming`"
},
"nextPage": {
"type": "string",
"description": "- The page index, for paging purpose\n- Leave it blank for the first time\n- The `nextPage` can be retrieved from response of this endpoint(meta->nextPage)\n- Ex: `MjQ=`"
}
},
"additionalProperties": false
}subreddit/awarding-totals Group: Subreddit. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| groupId | string | - Required: true - Ex: `t3_54z4f7` |
{
"type": "object",
"properties": {
"groupId": {
"type": "string",
"example": "t3_54z4f7",
"description": "- Required: true\n- Ex: `t3_54z4f7`"
}
},
"additionalProperties": false
}subreddit/comments Group: Subreddit. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| sort | string | - Sort by - Default: `confidence` - Choose one of the values below - `confidence`: Best - `top`: Top - `new`: New - `controversial`: Controversial - `old`: Old - `qa`: Q&A |
| groupId | string | - Required: true - Ex: `t3_54z4f7` |
| nextPage | string | - The page index, for paging purpose - Leave it blank for the first time - The `nextPage` can be retrieved from response of this endpoint(meta->nextPage) - Ex: `dDNfZXJ4dXdt` |
{
"type": "object",
"properties": {
"sort": {
"type": "string",
"description": "- Sort by\n- Default: `confidence`\n- Choose one of the values below\n- `confidence`: Best\n- `top`: Top\n- `new`: New\n- `controversial`: Controversial\n- `old`: Old\n- `qa`: Q&A"
},
"groupId": {
"type": "string",
"example": "t3_54z4f7",
"description": "- Required: true\n- Ex: `t3_54z4f7`"
},
"nextPage": {
"type": "string",
"description": "- The page index, for paging purpose\n- Leave it blank for the first time\n- The `nextPage` can be retrieved from response of this endpoint(meta->nextPage)\n- Ex: `dDNfZXJ4dXdt`"
}
},
"additionalProperties": false
}subreddit/search Group: Subreddit. Billing per call: 1 Credits.
| Argument | Type | Description |
|---|---|---|
| sort | string | - Sort by - Default: `top` - Choose one of the values below - `hot`: Hot - `new`: New - `top`: Top - `controversial`: Controversial - `rising`: Rising |
| time | string | - Time - Default: `all` - Choose one of the values below - `all`: All time - `hour`: Past hour - `day`: Past 24 hours - `week`: Past week - `month`: Past month - `year`: Past year |
| query | string | - Required: true - Ex: `gaming` |
| nextPage | string | - The page index, for paging purpose - Leave it blank for the first time - The `nextPage` can be retrieved from response of this endpoint(meta->nextPage) - Ex: `dDNfZXJ4dXdt` |
{
"type": "object",
"properties": {
"sort": {
"type": "string",
"description": "- Sort by\n- Default: `top`\n- Choose one of the values below\n- `hot`: Hot\n- `new`: New\n- `top`: Top\n- `controversial`: Controversial\n- `rising`: Rising"
},
"time": {
"type": "string",
"description": "- Time\n- Default: `all`\n- Choose one of the values below\n- `all`: All time\n- `hour`: Past hour\n- `day`: Past 24 hours\n- `week`: Past week\n- `month`: Past month\n- `year`: Past year"
},
"query": {
"type": "string",
"example": "gaming",
"description": "- Required: true\n- Ex: `gaming`"
},
"nextPage": {
"type": "string",
"description": "- The page index, for paging purpose\n- Leave it blank for the first time\n- The `nextPage` can be retrieved from response of this endpoint(meta->nextPage)\n- Ex: `dDNfZXJ4dXdt`"
}
},
"additionalProperties": false
}