Company Brand Profile Lookup (by Domain, Name, or Ticker)

omnial/brand-retrieve

Given a company's domain, name, or stock ticker, returns its brand profile: display name, description, slogan, brand colors, logo metadata, headquarters address, employee count, industry classification, and which social platforms it maintains a presence on.

activeper callv4

Price

$0.0346 per call

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.

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/brand-retrieve" })

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

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

Updated: Oct 25, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "anyOf": [
    {
      "required": [
        "domain"
      ]
    },
    {
      "required": [
        "name"
      ]
    },
    {
      "required": [
        "ticker"
      ]
    }
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 30,
      "minLength": 3,
      "description": "Company name to resolve, e.g. 'Apple Inc'. Mutually exclusive with domain and ticker."
    },
    "domain": {
      "type": "string",
      "minLength": 3,
      "description": "Domain to retrieve brand data for, e.g. 'example.com'. Mutually exclusive with name and ticker."
    },
    "ticker": {
      "type": "string",
      "maxLength": 15,
      "minLength": 1,
      "description": "Stock ticker to resolve, e.g. 'AAPL'. Mutually exclusive with domain and name."
    },
    "maxAgeMs": {
      "type": "integer",
      "default": 7776000000,
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Maximum age in milliseconds of cached brand data before the upstream service hard-refreshes it. Default 7776000000 (3 months); values are clamped to [86400000 (1 day), 31536000000 (1 year)]."
    },
    "maxSpeed": {
      "type": "boolean",
      "default": false,
      "description": "Optimize for speed: the upstream service skips time-consuming enrichment for a faster response at the cost of less comprehensive data. Default false."
    },
    "timeoutMS": {
      "type": "integer",
      "maximum": 300000,
      "minimum": 1000,
      "description": "Upstream timeout in milliseconds (max 300000). The upstream service aborts the call with a 408 when exceeded. Keep it below the endpoint's requestTimeoutMs so the provider answers before the platform's own budget expires."
    },
    "force_language": {
      "type": "string",
      "minLength": 2,
      "description": "Force the language of the returned brand copy (a language NAME, e.g. 'english', 'french', 'japanese')."
    },
    "ticker_exchange": {
      "type": "string",
      "maxLength": 10,
      "minLength": 2,
      "description": "Exchange code disambiguating the ticker, e.g. 'NASDAQ', 'NYSE', 'LSE', 'XETRA'."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "required": [
    "status",
    "brand",
    "code",
    "cache_metadata"
  ],
  "properties": {
    "code": {
      "type": "integer",
      "description": "HTTP-style status code echoed by the vendor; 200 on both real calls."
    },
    "brand": {
      "type": "object",
      "required": [
        "domain",
        "title",
        "description",
        "primary_language",
        "is_nsfw",
        "colors",
        "logos",
        "backdrops",
        "socials",
        "industries",
        "address",
        "stock"
      ],
      "properties": {
        "links": {
          "type": "object",
          "properties": {
            "blog": {
              "type": "null",
              "description": "Always null on the real calls observed; never seen populated. Stripped."
            },
            "terms": {
              "type": "null"
            },
            "careers": {
              "type": "null"
            },
            "contact": {
              "type": "null"
            },
            "pricing": {
              "type": "null",
              "description": "Always null on the real calls observed; never seen populated. Stripped."
            },
            "privacy": {
              "type": "null"
            }
          },
          "description": "Page-link fields. `blog` and `pricing` were observed null on both real calls (a populated value was never seen, so its shape is unconfirmed); `careers`, `contact`, `privacy`, and `terms` are always redacted to null here regardless of the vendor's real value (they parsed as URLs on at least one real call).",
          "additionalProperties": true
        },
        "logos": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "mode": {
                "type": "string",
                "description": "e.g. 'light', 'dark', 'has_opaque_background'."
              },
              "type": {
                "type": "string",
                "description": "e.g. 'logo', 'icon'."
              },
              "colors": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "hex": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": true
                }
              },
              "resolution": {
                "type": "object",
                "properties": {
                  "width": {
                    "type": "integer"
                  },
                  "height": {
                    "type": "integer"
                  },
                  "aspect_ratio": {
                    "type": "number"
                  }
                },
                "additionalProperties": true
              }
            },
            "additionalProperties": true
          },
          "description": "Logo metadata (no image URL is included). 1-2 entries observed per company."
        },
        "phone": {
          "type": "string",
          "description": "The company's public switchboard number. Observed for Apple only on the two real calls -- not always present."
        },
        "stock": {
          "type": "object",
          "properties": {
            "ticker": {
              "type": "string"
            },
            "exchange": {
              "type": "string"
            }
          },
          "additionalProperties": true
        },
        "title": {
          "type": "string",
          "description": "The company's public display name."
        },
        "colors": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "hex": {
                "type": "string"
              },
              "name": {
                "type": "string",
                "description": "A human-readable color name, e.g. 'Hard Coal'."
              },
              "source": {
                "type": "string",
                "description": "Where the color was extracted from, e.g. 'logo'."
              }
            },
            "additionalProperties": true
          },
          "description": "The brand's overall color palette."
        },
        "domain": {
          "type": "string",
          "description": "The resolved company's primary domain."
        },
        "slogan": {
          "type": "string",
          "description": "Observed on both real calls; the vendor may not always have one for every company."
        },
        "address": {
          "type": "object",
          "properties": {
            "city": {
              "type": "string"
            },
            "street": {
              "type": "string",
              "description": "Observed for Apple, absent for Microsoft on the two real calls -- not always present."
            },
            "country": {
              "type": "string"
            },
            "state_code": {
              "type": "string"
            },
            "postal_code": {
              "type": "string"
            },
            "country_code": {
              "type": "string"
            },
            "state_province": {
              "type": "string"
            }
          },
          "description": "The company's self-published headquarters address, as the vendor has it on file.",
          "additionalProperties": true
        },
        "is_nsfw": {
          "type": "boolean"
        },
        "socials": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "description": "e.g. 'x', 'linkedin', 'youtube', 'facebook', 'appstore'."
              }
            },
            "additionalProperties": true
          },
          "description": "Which social/app platforms the company maintains a presence on (no link URL included)."
        },
        "backdrops": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "colors": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "hex": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": true
                }
              },
              "resolution": {
                "type": "object",
                "properties": {
                  "width": {
                    "type": "integer"
                  },
                  "height": {
                    "type": "integer"
                  },
                  "aspect_ratio": {
                    "type": "number"
                  }
                },
                "additionalProperties": true
              }
            },
            "additionalProperties": true
          },
          "description": "Backdrop/hero-image metadata (no image URL included). Can be empty -- observed empty for Microsoft and 3 entries for Apple on the two real calls."
        },
        "employees": {
          "type": "object",
          "properties": {
            "exact": {
              "type": "integer"
            },
            "range": {
              "type": "string",
              "description": "e.g. '10001+'."
            }
          },
          "description": "Observed for Apple only on the two real calls -- not always present.",
          "additionalProperties": true
        },
        "industries": {
          "type": "object",
          "properties": {
            "eic": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "industry": {
                    "type": "string"
                  },
                  "subindustry": {
                    "type": "string"
                  }
                },
                "additionalProperties": true
              }
            }
          },
          "additionalProperties": true
        },
        "description": {
          "type": "string"
        },
        "primary_language": {
          "type": "string",
          "description": "e.g. 'english'."
        }
      },
      "additionalProperties": true
    },
    "status": {
      "type": "string",
      "description": "'ok' on both real calls observed."
    },
    "cache_metadata": {
      "type": "object",
      "properties": {
        "age_ms": {
          "type": "integer",
          "description": "Age of the cached record in milliseconds."
        },
        "status": {
          "type": "string",
          "description": "'hit' on both real calls observed."
        }
      },
      "additionalProperties": true
    }
  },
  "description": "The brand record. In testing (apple.com by domain, MSFT by ticker), lookups resolved successfully; a not-found/no-match case is not described here.",
  "additionalProperties": true
}