Contract
input_schema.json
{
"type": "object",
"required": [
"searchterm"
],
"properties": {
"params": {
"type": "object",
"properties": {
"newest": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Unix seconds; only articles published at or before this time."
},
"oldest": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Unix seconds; only articles published at or after this time."
},
"context": {
"type": "string",
"maxLength": 200,
"description": "Pagination cursor from the previous response's context field; resend the same search to get the next page."
},
"excludearticles": {
"type": "array",
"items": {
"type": "object",
"required": [
"id_site",
"id_article"
],
"properties": {
"id_site": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Opoint site id."
},
"id_article": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Article id, unique within the site."
}
},
"additionalProperties": false
},
"maxItems": 100,
"description": "Site/article id pairs to leave out of the results."
},
"requestedarticles": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Articles to return (1-100, default 10)."
},
"sort_oldest_first": {
"type": "boolean",
"description": "Oldest first instead of newest first."
}
},
"additionalProperties": false
},
"searchterm": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "Opoint search expression: keywords and 'quoted phrases', section prefixes (header:, summary:, body:, author:, url:), wildcards (spot*), proximity ('Trump Biden'~5), boolean AND / OR / ANDNOT, and filter ids from /suggest (lang:en, geo:1203, site:318, media:576). Example: \"header:spotify AND lang:en\"."
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"context": {
"type": "string",
"description": "Pagination cursor. Pass this back as params.context on a repeat call with the same searchterm to get the next page."
},
"document": {
"type": "array",
"items": {
"type": "object",
"properties": {
"author": {
"type": "string",
"description": "Byline on the source article, when the source publishes one -- observed present on some articles and absent on others in both captured fixtures, never null."
},
"header": {
"type": "string",
"description": "The article's headline."
},
"topics": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"text": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "Category/topic tags Opoint assigned to the article."
},
"id_site": {
"type": "integer",
"description": "The publishing site's id."
},
"language": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Article language code, e.g. 'en', 'fr'."
},
"encoding": {
"type": "string",
"description": "Always 'iso-639' on both captured fixtures."
}
},
"additionalProperties": true
},
"mediatype": {
"type": "object",
"properties": {
"clip": {
"type": "boolean"
},
"text": {
"type": "string",
"description": "e.g. 'WEB' on both captured fixtures."
},
"haslogo": {
"type": "boolean"
},
"hastext": {
"type": "boolean"
},
"paywall": {
"type": "boolean"
},
"timemap": {
"type": "boolean"
},
"fulltext": {
"type": "boolean"
}
},
"additionalProperties": true
},
"site_rank": {
"type": "object",
"properties": {
"rank_global": {
"type": "integer"
},
"rank_country": {
"type": "integer"
}
},
"additionalProperties": true
},
"id_article": {
"type": "integer",
"description": "The article's id, unique within its site."
},
"local_time": {
"type": "object",
"properties": {
"GMT": {
"type": "integer",
"description": "UTC offset in hours at publish time."
},
"text": {
"type": "string",
"description": "Local publish time, e.g. '20260922T21:35:43+0200'."
}
},
"additionalProperties": true
},
"similarweb": {
"type": "object",
"properties": {
"domain": {
"type": "string"
},
"readership": {
"type": "object",
"properties": {
"P": {
"type": "number",
"description": "Estimated share of domain traffic, 0-1."
},
"value": {
"type": "integer"
}
},
"additionalProperties": true
},
"article_readership": {
"type": "object",
"properties": {
"P": {
"type": "number"
},
"value": {
"type": "integer"
},
"DeltaP": {
"type": "number"
},
"ExpectedP": {
"type": "number"
},
"DeltaPValue": {
"type": "integer"
},
"StdExpectedP": {
"type": "number"
},
"ExpectedPValue": {
"type": "integer"
},
"StdExpectedPValue": {
"type": "integer"
}
},
"additionalProperties": true
}
},
"description": "Estimated readership from Similarweb. The article_readership sub-fields DeltaP/DeltaPValue/ExpectedP/ExpectedPValue/StdExpectedP/StdExpectedPValue are present on some articles and absent on others -- confirmed present on 2 of 5 apple-found articles and absent from every france-locale-oldest-first article, never null.",
"additionalProperties": true
},
"url_common": {
"type": "string",
"description": "The publishing site's bare domain, e.g. 'headtopics.com' -- not a clickable link."
},
"word_count": {
"type": "integer"
},
"countrycode": {
"type": "string",
"description": "ISO-ish country code of the publishing site."
},
"countryname": {
"type": "string"
},
"first_source": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"sitename": {
"type": "string"
}
},
"description": "The publishing site's own identity, not a clickable link (see usage.md).",
"additionalProperties": true
},
"unix_timestamp": {
"type": "integer",
"description": "Publish time, Unix seconds."
}
},
"additionalProperties": true
},
"description": "One entry per matching article, up to documents."
},
"documents": {
"type": "integer",
"description": "Number of articles returned in this call (up to requestedarticles)."
},
"range_count": {
"type": "integer",
"description": "Total number of articles matching the search across the whole result set, not just this page (e.g. 920 total matches when only 5 were returned in the apple-found fixture)."
},
"last_timestamp": {
"type": "integer",
"description": "Unix seconds of the oldest article in this page."
},
"first_timestamp": {
"type": "integer",
"description": "Unix seconds of the newest article in this page."
}
},
"description": "A page of matching news headlines, newest-first by default (oldest-first when the sort_oldest_first param is set).",
"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.0819 |
- 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