Company Search (by Name or Keyword)

omnial/search-companies

Given a search keyword or company name, returns a page of matching companies from the upstream review platform -- name, domain, website URL, trust score, star rating, review count, verification status, business categories, and location -- plus pagination totals. A query that matches nothing returns an empty list rather than an error.

activeper callv2

Price

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

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $0.50.

Data source

Trustpilot

Data from Trustpilot.

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.

Connect once and your AI can find and run this tool, and any other it needs.

Install it Create an account

agent

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

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/search-companies" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/search-companies" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/search-companies", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/search-companies", 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.041

Updated: Oct 25, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "description": "Page number"
    },
    "limit": {
      "type": "integer",
      "description": "Results per page (max 20)"
    },
    "query": {
      "type": "string",
      "description": "Search keyword or company name"
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "companies": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Opaque internal business identifier on the upstream review platform (a 24-character hex string). Not a phone number or any other contact detail."
              },
              "name": {
                "type": "string",
                "description": "The company's display name."
              },
              "stars": {
                "type": "number",
                "description": "0-5 star rating, observed in half-star increments."
              },
              "domain": {
                "type": "string",
                "description": "The company's registered domain, e.g. 'www.amazon.com'."
              },
              "location": {
                "type": "object",
                "properties": {
                  "city": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "street": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "country": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "postcode": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "coordinates": {
                    "type": "object",
                    "properties": {
                      "lat": {
                        "type": "number"
                      },
                      "lon": {
                        "type": "number"
                      }
                    },
                    "description": "Present on every company observed, even when the rest of `location` is null.",
                    "additionalProperties": true
                  },
                  "countryCode": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "approximateArea": {
                    "type": "array",
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "number"
                      }
                    },
                    "description": "A bounding box: two [longitude, latitude] corner pairs, observed on every company."
                  }
                },
                "description": "The company's registered business location on the upstream platform. City, street, postcode, country, and countryCode were all observed null for several companies in the same result set (location data is not always on file) -- treat every one of those fields as possibly absent, not guaranteed present.",
                "additionalProperties": true
              },
              "verified": {
                "type": "boolean",
                "description": "Whether the business has claimed/verified its profile."
              },
              "categories": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Business category tags. Observed as an empty array for at least one company."
              },
              "trust_score": {
                "type": "number",
                "description": "0-5 scale, observed with one decimal place."
              },
              "website_url": {
                "type": "string",
                "description": "Full https URL to the company's own website."
              },
              "review_count": {
                "type": "integer"
              }
            },
            "additionalProperties": true
          },
          "description": "Up to `limit` matching companies for the current page. Empty array when nothing matches the query, not omitted and not null."
        },
        "total_hits": {
          "type": "integer",
          "description": "Total matching companies across all pages, not just this page."
        },
        "total_pages": {
          "type": "integer"
        }
      },
      "additionalProperties": true
    },
    "status": {
      "type": "string",
      "description": "'success' on both real calls observed, including the zero-match case."
    }
  },
  "description": "The search result page. A query matching no companies still returns this same shape with an empty `data.companies` array and `total_hits`/`total_pages` at 0, not an error and not a differently-shaped response.",
  "additionalProperties": true
}