Contract
input_schema.json
{
"type": "object",
"required": [
"tweet_id"
],
"properties": {
"cursor": {
"type": "string",
"description": "Cursor"
},
"tweet_id": {
"type": "string",
"examples": [
"1835124037934367098"
],
"description": "Tweet ID"
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"lang": {
"type": "string"
},
"text": {
"type": "string"
},
"likes": {
"type": "number"
},
"views": {
"type": "string",
"description": "View count returned as a numeric STRING (e.g. '57916860'), not a number."
},
"author": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"image": {
"type": [
"string",
"null"
],
"description": "Withheld -- a URL leaf per census.json, always returned null."
},
"rest_id": {
"type": "string",
"description": "The account's internal numeric user id."
},
"sub_count": {
"type": [
"number",
"null"
],
"description": "Observed `null` on every account in both real fixtures calibrated."
},
"description": {
"type": [
"string",
"null"
],
"description": "Bio text; null when unset."
},
"screen_name": {
"type": "string",
"description": "The @handle, without the leading @."
},
"blue_verified": {
"type": "boolean"
}
},
"description": "The original tweet's author.",
"additionalProperties": true
},
"cursor": {
"type": "string",
"description": "Pagination cursor for fetching further replies; pass back as `cursor` alongside the same `tweet_id` on a follow-up call."
},
"quoted": {
"type": "object",
"properties": {
"lang": {
"type": "string"
},
"text": {
"type": "string"
},
"media": {
"type": "object",
"properties": {
"photo": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"media_url_https": {
"type": [
"string",
"null"
],
"description": "Withheld -- a URL leaf, always returned null."
}
},
"additionalProperties": true
}
}
},
"description": "Photos attached to the quoted tweet.",
"additionalProperties": true
},
"views": {
"type": "string",
"description": "Numeric string, same convention as `views`."
},
"author": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"avatar": {
"type": [
"string",
"null"
],
"description": "Withheld -- a URL leaf per census.json, always returned null."
},
"can_dm": {
"type": "boolean"
},
"rest_id": {
"type": "string"
},
"screen_name": {
"type": "string"
},
"blue_verified": {
"type": "boolean"
}
},
"additionalProperties": true
},
"quotes": {
"type": "number"
},
"source": {
"type": "string"
},
"replies": {
"type": "number"
},
"retweets": {
"type": "number"
},
"tweet_id": {
"type": "string"
},
"bookmarks": {
"type": "number"
},
"favorites": {
"type": "number"
},
"sensitive": {
"type": "boolean",
"description": "Observed only `false` on the one real fixture with a quoted tweet."
},
"created_at": {
"type": "string"
},
"conversation_id": {
"type": "string"
}
},
"description": "The tweet this one quotes, when the original tweet quotes another tweet. Absent when there is no quoted tweet.",
"additionalProperties": true
},
"quotes": {
"type": "number"
},
"source": {
"type": "string",
"description": "Raw HTML anchor tag naming the client app used to post (e.g. '<a href=\"http://twitter.com/download/iphone\" rel=\"nofollow\">Twitter for iPhone</a>'), not a plain client name."
},
"status": {
"type": "string",
"description": "e.g. 'active' on every real tweet observed."
},
"thread": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"lang": {
"type": "string"
},
"text": {
"type": "string"
},
"likes": {
"type": "number"
},
"media": {
"type": [
"array",
"object"
],
"properties": {
"photo": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"media_url_https": {
"type": [
"string",
"null"
],
"description": "Withheld -- a URL leaf, always returned null."
}
},
"additionalProperties": true
}
},
"video": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"duration": {
"type": [
"number",
"null"
]
},
"variants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld -- a URL leaf, always returned null."
},
"bitrate": {
"type": [
"number",
"null"
]
},
"content_type": {
"type": "string"
}
},
"additionalProperties": true
}
},
"aspect_ratio": {
"type": "array",
"items": {
"type": "number"
}
},
"original_info": {
"type": "object",
"additionalProperties": true
},
"media_url_https": {
"type": [
"string",
"null"
],
"description": "Withheld -- a URL leaf, always returned null."
}
},
"additionalProperties": true
}
}
},
"description": "Media attached to the reply. Observed as an empty array `[]` on replies with no media, and as an object with `photo`/`video` subarrays on replies that carry media -- both shapes seen directly across replies in the one real fixture calibrated.",
"additionalProperties": true
},
"views": {
"type": "string",
"description": "Numeric string, same convention as `views`."
},
"author": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"image": {
"type": [
"string",
"null"
],
"description": "Withheld -- a URL leaf, always returned null."
},
"can_dm": {
"type": "boolean"
},
"rest_id": {
"type": "string"
},
"sub_count": {
"type": [
"number",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"screen_name": {
"type": "string"
},
"blue_verified": {
"type": "boolean"
}
},
"additionalProperties": true
},
"quotes": {
"type": "number"
},
"status": {
"type": "string"
},
"replies": {
"type": "number"
},
"entities": {
"type": "object",
"properties": {
"urls": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld -- a URL leaf, always returned null."
},
"display_url": {
"type": "string"
},
"expanded_url": {
"type": [
"string",
"null"
],
"description": "Withheld -- a URL leaf, always returned null."
}
},
"additionalProperties": true
}
},
"media": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld -- a URL leaf, always returned null."
},
"type": {
"type": "string"
},
"id_str": {
"type": "string"
},
"media_key": {
"type": "string"
},
"display_url": {
"type": "string"
},
"expanded_url": {
"type": [
"string",
"null"
],
"description": "Withheld -- a URL leaf, always returned null."
},
"ext_alt_text": {
"type": [
"string",
"null"
]
},
"media_url_https": {
"type": [
"string",
"null"
],
"description": "Withheld -- a URL leaf, always returned null."
}
},
"additionalProperties": true
},
"description": "Rich media metadata (display sizes, face-detection boxes, video variants) for media embedded in the reply text."
},
"user_mentions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"id_str": {
"type": "string"
},
"screen_name": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "Accounts @-mentioned in the reply's own text."
}
},
"description": "Structured mentions/links/media parsed out of the reply's own text, when any.",
"additionalProperties": true
},
"retweets": {
"type": "number"
},
"bookmarks": {
"type": "number"
},
"sensitive": {
"type": [
"boolean",
"null"
]
},
"created_at": {
"type": "string"
},
"display_text": {
"type": "string"
},
"conversation_id": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "The public reply thread beneath the tweet."
},
"replies": {
"type": "number"
},
"retweets": {
"type": "number"
},
"bookmarks": {
"type": "number"
},
"sensitive": {
"type": [
"boolean",
"null"
],
"description": "Observed `null` on the original tweet in the one real fixture calibrated, and both `true`-shaped-as-`false` and `null` across different replies in the same thread."
},
"created_at": {
"type": "string"
},
"display_text": {
"type": "string",
"description": "The tweet text with the leading @-mention(s) stripped off, when any."
},
"conversation_id": {
"type": "string"
}
},
"description": "The tweet-and-reply-thread record, as returned at routing.responseResultPath ($.output). Observed as an empty object `{}` when `tweet_id` does not resolve to an existing, commentable tweet -- confirmed against the `no-comments-tweet` fixture, which billed $0 for that outcome (the raw upstream response is literally `null` in that case).",
"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