Contract
input_schema.json
{
"type": "object",
"required": [
"username"
],
"properties": {
"sort": {
"enum": [
"NEW",
"TOP",
"HOT",
"CONTROVERSIAL"
],
"type": "string",
"default": "NEW",
"examples": [
"NEW"
],
"description": "Sort method: NEW, TOP, HOT, CONTROVERSIAL"
},
"after": {
"type": "string",
"maxLength": 4096,
"description": "Pagination parameter"
},
"language": {
"type": "string",
"default": "en-US",
"pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$",
"maxLength": 16,
"minLength": 2,
"description": "Preferred response language as an IETF language tag; default: en-US"
},
"username": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"examples": [
"spez"
],
"maxLength": 20,
"minLength": 1,
"description": "Username"
},
"need_format": {
"type": "boolean",
"default": false,
"description": "Whether to clean and format the data"
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"identity": {
"type": "object",
"properties": {
"settings": {
"type": "object",
"properties": {
"postSetSettings": {
"type": "object",
"properties": {
"maxPostsPerPostSet": {
"type": "number",
"description": "An internal batching config value observed as `5` on both real calls made -- its exact effect on the returned feed is unconfirmed."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"postFeed": {
"type": [
"object",
"null"
],
"properties": {
"profile": {
"type": "object",
"properties": {
"stickyPosts": {
"type": "array",
"items": {},
"description": "Observed as an empty array `[]` on the one real account calibrated -- item shape UNCONFIRMED, no populated example was ever observed."
}
},
"additionalProperties": true
},
"elements": {
"type": "object",
"properties": {
"edges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"node": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Reddit's own post id, e.g. 't3_...'."
},
"url": {
"type": [
"string",
"null"
],
"description": "Withheld (returned as `null` regardless of the real destination) -- only whether the post has a link is observable, not the URL itself."
},
"flair": {
"type": [
"object",
"null"
],
"properties": {
"text": {
"type": "string"
},
"type": {
"type": "string"
},
"textColor": {
"type": "string"
}
},
"additionalProperties": true
},
"media": {
"type": [
"object",
"null"
],
"properties": {
"still": {
"type": "object",
"properties": {
"large": {
"type": [
"object",
"null"
],
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"dimensions": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"source": {
"type": [
"object",
"null"
],
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"dimensions": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"description": "A static image, at two of the sizes the endpoint returns.",
"additionalProperties": true
},
"video": {
"type": [
"object",
"null"
],
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"embedHtml": {
"type": [
"string",
"null"
]
},
"dimensions": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"additionalProperties": true
},
"attribution": {
"type": "object",
"properties": {
"title": {
"type": [
"string",
"null"
]
},
"authorUrl": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"authorName": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"providerUrl": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"providerName": {
"type": [
"string",
"null"
],
"description": "e.g. 'YouTube'."
}
},
"description": "Attribution for an embedded external video (e.g. YouTube).",
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"description": "`null` for a plain text/link post with no attached media.",
"additionalProperties": true
},
"score": {
"type": "number"
},
"domain": {
"type": "string",
"description": "e.g. 'self.spez', 'reddit.com'."
},
"isNsfw": {
"type": "boolean"
},
"content": {
"type": [
"object",
"null"
],
"properties": {
"html": {
"type": "string"
},
"markdown": {
"type": "string"
},
"richtextMedia": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"url": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"hlsUrl": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"status": {
"type": "string"
},
"dashUrl": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"mimetype": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "Images embedded inline in the post's own body text."
}
},
"description": "The post's own self-text, when it is a text post. `null` for a link/announcement post with no self-text (confirmed on a real post in the calibrated feed).",
"additionalProperties": true
},
"profile": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": "string",
"description": "e.g. 'u_spez'."
},
"isNsfw": {
"type": "boolean"
},
"subscribersCount": {
"type": "number"
}
},
"description": "Present when this post lives in the author's own profile ('u_username') rather than a community subreddit; mutually exclusive with `subreddit` in practice on every post observed.",
"additionalProperties": true
},
"editedAt": {
"type": [
"string",
"null"
]
},
"isLocked": {
"type": "boolean"
},
"postHint": {
"type": [
"string",
"null"
],
"description": "e.g. 'SELF' for a text post."
},
"createdAt": {
"type": "string",
"description": "ISO 8601 with UTC offset."
},
"isSpoiler": {
"type": "boolean"
},
"permalink": {
"type": "string",
"description": "Relative path on reddit.com."
},
"postStats": {
"type": [
"object",
"null"
],
"properties": {
"shareAllTotal": {
"type": "number"
},
"viewCountTotal": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": true
},
"postTitle": {
"type": "string"
},
"subreddit": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": "string"
},
"type": {
"type": "string",
"description": "e.g. 'PUBLIC', 'RESTRICTED'."
},
"title": {
"type": "string"
},
"isNsfw": {
"type": "boolean"
},
"prefixedName": {
"type": "string",
"description": "e.g. 'r/RDDT'."
},
"isQuarantined": {
"type": "boolean"
},
"subscribersCount": {
"type": "number"
}
},
"description": "Present when this post lives in a community subreddit rather than the author's own profile.",
"additionalProperties": true
},
"thumbnail": {
"type": [
"object",
"null"
],
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"dimensions": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"viewCount": {
"type": [
"number",
"null"
],
"description": "Observed `null` on every post in the one real feed calibrated."
},
"authorInfo": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The author's public Reddit username."
},
"profile": {
"type": "object",
"properties": {
"isNsfw": {
"type": "boolean"
}
},
"additionalProperties": true
},
"isBlocked": {
"type": "boolean"
},
"accountType": {
"type": "string",
"description": "e.g. 'USER'."
},
"isCakeDayNow": {
"type": "boolean"
}
},
"description": "The post's own author (may differ from the queried username on a shared/multi-user feed).",
"additionalProperties": true
},
"isArchived": {
"type": "boolean"
},
"isSelfPost": {
"type": "boolean"
},
"isStickied": {
"type": "boolean"
},
"authorFlair": {
"type": [
"object",
"null"
],
"properties": {
"text": {
"type": "string"
},
"textColor": {
"type": "string"
}
},
"additionalProperties": true
},
"upvoteRatio": {
"type": "number"
},
"commentCount": {
"type": "number"
},
"languageCode": {
"type": [
"string",
"null"
],
"description": "Observed `null` on at least one post in the calibrated feed."
},
"outboundLink": {
"type": [
"object",
"null"
],
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"expiresAt": {
"type": "string"
}
},
"additionalProperties": true
},
"crosspostRoot": {
"type": [
"object",
"null"
],
"properties": {
"post": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"url": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"score": {
"type": "number"
},
"domain": {
"type": "string"
},
"isNsfw": {
"type": "boolean"
},
"content": {
"type": [
"object",
"null"
],
"properties": {
"html": {
"type": "string"
},
"markdown": {
"type": "string"
},
"richtextMedia": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"url": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"hlsUrl": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"status": {
"type": "string"
},
"dashUrl": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"mimetype": {
"type": "string"
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
"editedAt": {
"type": [
"string",
"null"
]
},
"isLocked": {
"type": "boolean"
},
"postHint": {
"type": [
"string",
"null"
]
},
"createdAt": {
"type": "string"
},
"isSpoiler": {
"type": "boolean"
},
"permalink": {
"type": "string"
},
"postStats": {
"type": [
"object",
"null"
],
"properties": {
"shareAllTotal": {
"type": "number"
},
"viewCountTotal": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": true
},
"postTitle": {
"type": "string"
},
"subreddit": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": "string"
},
"type": {
"type": "string"
},
"title": {
"type": "string"
},
"isNsfw": {
"type": "boolean"
},
"prefixedName": {
"type": "string"
},
"isQuarantined": {
"type": "boolean"
},
"subscribersCount": {
"type": "number"
}
},
"additionalProperties": true
},
"thumbnail": {
"type": [
"object",
"null"
],
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"dimensions": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"viewCount": {
"type": [
"number",
"null"
]
},
"authorInfo": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The original post's author's public Reddit username."
},
"profile": {
"type": "object",
"properties": {
"isNsfw": {
"type": "boolean"
}
},
"additionalProperties": true
},
"isBlocked": {
"type": "boolean"
},
"accountType": {
"type": "string"
},
"isCakeDayNow": {
"type": "boolean"
}
},
"additionalProperties": true
},
"isArchived": {
"type": "boolean"
},
"isSelfPost": {
"type": "boolean"
},
"isStickied": {
"type": "boolean"
},
"upvoteRatio": {
"type": "number"
},
"commentCount": {
"type": "number"
},
"languageCode": {
"type": "string"
},
"outboundLink": {
"type": [
"object",
"null"
],
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld."
},
"expiresAt": {
"type": "string"
}
},
"additionalProperties": true
},
"isContestMode": {
"type": "boolean"
},
"postEventInfo": {
"type": [
"object",
"null"
],
"properties": {
"endsAt": {
"type": "string"
},
"startsAt": {
"type": "string"
},
"eventType": {
"type": "string",
"description": "e.g. 'AMA'."
},
"isEventAdmin": {
"type": "boolean"
},
"collaborators": {
"type": "array",
"items": {
"type": "object",
"properties": {
"redditor": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"displayName": {
"type": "string",
"description": "The co-host's public Reddit username."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "The event's other public co-hosts, when any."
},
"remindeesCount": {
"type": "number"
}
},
"description": "Present when the original post is a scheduled event/AMA announcement.",
"additionalProperties": true
},
"distinguishedAs": {
"type": [
"string",
"null"
]
},
"crowdControlLevel": {
"type": "string"
},
"removedByCategory": {
"type": [
"string",
"null"
]
},
"isCommercialCommunication": {
"type": "boolean"
}
},
"additionalProperties": true
}
},
"description": "Present when this feed entry is a repost/crosspost of another post -- the original post's own details. `null` for an original post.",
"additionalProperties": true
},
"isContestMode": {
"type": "boolean"
},
"distinguishedAs": {
"type": [
"string",
"null"
],
"description": "e.g. 'ADMIN' when the author posted with a special badge."
},
"crowdControlLevel": {
"type": "string",
"description": "e.g. 'OFF'."
},
"removedByCategory": {
"type": [
"string",
"null"
],
"description": "Moderation-removal reason, when removed. Observed `null` (not removed) on every post in the one real feed calibrated."
},
"isCommercialCommunication": {
"type": "boolean"
}
},
"description": "One post.",
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"pageInfo": {
"type": "object",
"properties": {
"endCursor": {
"type": [
"string",
"null"
],
"description": "Opaque paging token; pass back as `after` to fetch older posts."
},
"hasNextPage": {
"type": "boolean"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"description": "Observed `null` when the given `username` does not resolve to an existing Reddit account -- confirmed against the `nonexistent-user-empty` fixture.",
"additionalProperties": true
}
},
"description": "The post-feed record, as returned at routing.responseResultPath ($.output).",
"additionalProperties": true
}Pricing
Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.
Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.
| Charge | Rate |
|---|---|
Per call Flat, regardless of what comes back | $0.0020475 |
- Cost basis
- Not recorded
This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.
- Updated
- Sep 8, 2026