Contract
input_schema.json
{
"type": "object",
"anyOf": [
{
"required": [
"user_id"
]
},
{
"required": [
"username"
]
}
],
"properties": {
"user_id": {
"type": "string",
"examples": [
"18527"
],
"description": "User ID"
},
"username": {
"type": "string",
"examples": [
"instagram"
],
"description": "Username"
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"type": "object",
"required": [
"count",
"items"
],
"properties": {
"count": {
"type": "number",
"description": "Number of currently active stories on this account. 0 when none."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"code": {
"type": "string",
"description": "The story's own short share code."
},
"owner": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"username": {
"type": "string"
},
"full_name": {
"type": "string"
},
"is_private": {
"type": "boolean"
},
"is_verified": {
"type": "boolean"
},
"profile_pic_url": {
"type": [
"string",
"null"
],
"description": "Withheld, same as `data.additional_data.user.profile_pic_url`."
}
},
"description": "The story's own poster -- the same account being queried.",
"additionalProperties": true
},
"caption": {
"type": [
"string",
"null"
],
"description": "Observed `null` on both real stories calibrated."
},
"is_video": {
"type": "boolean"
},
"has_audio": {
"type": "boolean",
"description": "Present only on video stories -- absent (not `false`) on the one real image story calibrated."
},
"is_pinned": {
"type": "boolean"
},
"video_url": {
"type": [
"string",
"null"
],
"description": "Withheld, same as `data.additional_data.user.profile_pic_url`. Present only on video stories."
},
"media_name": {
"type": "string",
"description": "A content-category label, observed as the literal string 'story' on every real item calibrated."
},
"expiring_at": {
"type": "number",
"description": "Unix seconds this story expires."
},
"media_format": {
"type": "string",
"description": "'image' or 'video'."
},
"product_type": {
"type": "string",
"description": "e.g. 'story'."
},
"reel_mentions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"user": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"username": {
"type": "string"
},
"full_name": {
"type": "string"
},
"is_private": {
"type": "boolean"
},
"is_verified": {
"type": "boolean"
},
"profile_pic_url": {
"type": [
"string",
"null"
],
"description": "Withheld, same as `data.additional_data.user.profile_pic_url`."
}
},
"description": "The tagged account's own public profile summary.",
"additionalProperties": true
},
"display_type": {
"type": "string",
"description": "e.g. 'mention_username' or 'mention_reshare'."
}
},
"additionalProperties": true
},
"description": "Accounts the poster tagged in this story. Present only when the story tags at least one account."
},
"story_prompts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"prompt_sticker": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "The prompt's own text."
},
"prompt_type": {
"type": "number"
},
"participant_count": {
"type": "number",
"description": "How many accounts have participated so far."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "Interactive prompt stickers on the story (e.g. an 'Add Yours' invitation). Present only when the story has one."
},
"taken_at_date": {
"type": "string",
"description": "ISO 8601 posting timestamp."
},
"thumbnail_url": {
"type": [
"string",
"null"
],
"description": "Withheld, same as `data.additional_data.user.profile_pic_url`."
},
"image_versions": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld, same as `data.additional_data.user.profile_pic_url`."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"additionalProperties": true
},
"description": "The story's image at multiple resolutions."
}
},
"additionalProperties": true
},
"video_duration": {
"type": "number",
"description": "Seconds. Present only on video stories."
},
"is_paid_partnership": {
"type": "boolean"
},
"story_link_stickers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"story_link": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld, same as `data.additional_data.user.profile_pic_url`."
},
"link_type": {
"type": "string",
"description": "e.g. 'web'."
},
"link_title": {
"type": "string"
},
"display_url": {
"type": "string",
"description": "The link's own human-readable display text."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "Present only when the story has a link sticker attached."
}
},
"additionalProperties": true
},
"description": "One entry per currently active story, newest last on the one real multi-story account calibrated."
},
"additional_data": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The story reel's own id."
},
"user": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The account's numeric Instagram user ID."
},
"username": {
"type": "string"
},
"full_name": {
"type": "string"
},
"is_private": {
"type": "boolean"
},
"is_verified": {
"type": "boolean"
},
"profile_pic_url": {
"type": [
"string",
"null"
],
"description": "The account's profile picture. Value withheld (returned as `null` regardless of what the account has set) -- only whether the field is populated is observable, not the image itself."
}
},
"description": "The account's own public profile summary.",
"additionalProperties": true
},
"reel_type": {
"type": "string",
"description": "e.g. 'user_reel'."
},
"expiring_at": {
"type": "number",
"description": "Unix seconds when the whole reel expires."
},
"is_archived": {
"type": "boolean"
},
"latest_reel_media": {
"type": "number",
"description": "Unix seconds the most recent story in this reel was posted."
}
},
"description": "Metadata about the account's current story reel as a whole. Absent when the account has no active stories.",
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"description": "The current-stories record, as returned at routing.responseResultPath ($.output). `data.additional_data` is present only when the account has at least one active story right now -- confirmed against the `spacex-no-stories` fixture, where the upstream endpoint returns it as an empty array instead of an object and it is dropped from this tool's output entirely rather than shipped in that shape.",
"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.004095 |
- 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 23, 2026