English News Search by Expression Line (Newest 5 or 10 Articles)

omnial/structured-expression-news-query

Runs one required search line, with an English-language filter, over a worldwide news index and returns the newest matching articles (10 by default, or 5): for each its outlet and article IDs, headline, a short opening snippet, byline where the outlet gives one, publish time, language, word count, the outlet's name, section name, web domain and country, plus the number returned and the publish times of the newest and oldest result.

activeper callv1

Price

Up to $0.0819 per call; you pay what the call used

The price shown is the price you pay. No monthly minimum. Top-ups start at $5.

Data source

Opoint

Articles from the outlet named on each result, indexed by Opoint.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/structured-expression-news-query" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/structured-expression-news-query" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/structured-expression-news-query", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/structured-expression-news-query", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.0819

Updated: Oct 15, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "expressions"
  ],
  "properties": {
    "params": {
      "type": "object",
      "properties": {
        "requestedarticles": {
          "enum": [
            5,
            10
          ],
          "type": "integer",
          "default": 10,
          "description": "How many of the newest matching articles to return: 10 (the default) or 5."
        }
      },
      "description": "Result options.",
      "additionalProperties": false
    },
    "expressions": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "linemode",
          "searchline"
        ],
        "properties": {
          "linemode": {
            "enum": [
              "R"
            ],
            "type": "string",
            "description": "Only \"R\": the line is required (every result matches it)."
          },
          "searchline": {
            "type": "object",
            "required": [
              "searchterm",
              "filters"
            ],
            "properties": {
              "filters": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "type",
                    "id"
                  ],
                  "properties": {
                    "id": {
                      "enum": [
                        "en"
                      ],
                      "type": "string",
                      "description": "Only \"en\": English-language articles."
                    },
                    "type": {
                      "enum": [
                        "lang"
                      ],
                      "type": "string",
                      "description": "Only \"lang\", a language filter."
                    }
                  },
                  "additionalProperties": false
                },
                "maxItems": 1,
                "minItems": 1,
                "description": "Exactly one filter: the English-language filter."
              },
              "searchterm": {
                "type": "string",
                "maxLength": 2000,
                "minLength": 1,
                "description": "The search expression: keywords and quoted phrases, optionally limited to a section with a prefix such as header: (the headline) or body:, combined with AND, OR or ANDNOT."
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "maxItems": 1,
      "minItems": 1,
      "description": "Exactly one search line, which every article must match."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "document": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "author": {
            "type": "string",
            "description": "The byline, as published; absent when the outlet gives none."
          },
          "header": {
            "type": "string",
            "description": "The headline."
          },
          "id_site": {
            "type": "number",
            "description": "The outlet's ID."
          },
          "snippet": {
            "type": [
              "string",
              "null"
            ],
            "description": "A short plain-text excerpt from the article's opening, often cut off with an ellipsis; links and markup are removed."
          },
          "language": {
            "type": "object",
            "properties": {
              "text": {
                "type": "string",
                "description": "The article's language, as an ISO 639 code."
              }
            }
          },
          "id_article": {
            "type": "number",
            "description": "The article's ID within the outlet."
          },
          "url_common": {
            "type": "string",
            "description": "The outlet's web domain."
          },
          "word_count": {
            "type": "number",
            "description": "The article's length in words."
          },
          "countrycode": {
            "type": "string",
            "description": "The outlet's country, as a two-letter code."
          },
          "countryname": {
            "type": "string",
            "description": "The outlet's country name."
          },
          "first_source": {
            "type": "object",
            "properties": {
              "id": {
                "type": "number",
                "description": "The ID of the outlet section the article came from."
              },
              "name": {
                "type": "string",
                "description": "The outlet section's name."
              },
              "sitename": {
                "type": "string",
                "description": "The outlet's name."
              }
            }
          },
          "unix_timestamp": {
            "type": "number",
            "description": "Publish time, as Unix seconds."
          }
        }
      },
      "description": "The matching articles, newest first."
    },
    "documents": {
      "type": "number",
      "description": "The number of articles returned."
    },
    "last_timestamp": {
      "type": "number",
      "description": "The oldest returned article's publish time, as Unix seconds."
    },
    "first_timestamp": {
      "type": "number",
      "description": "The newest returned article's publish time, as Unix seconds."
    }
  },
  "description": "The newest matching English-language articles."
}