get_company_by_name

Direct company lookup with intelligent name matching and automatic suffix handling.

TOOL

Overview

The get_company_by_name tool provides smart company lookup that automatically handles common company suffixes and returns either full company details for a single match or a selection list for multiple matches.

Parameters

Parameter	Type	Required	Description
name	string	Yes	Company name to look up

Response

Returns either:

• Single match: Full CompanyDetails object
• Multiple matches: Array of CompanySelection objects
• No matches: Empty result

Smart Matching Logic

1. Exact Match First: Searches for exact name (case-insensitive)
2. Suffix Stripping: Automatically removes:
   • LIMITED, LTD, LTD.
   • PLC, PLC.
   • LLP, LLP.
3. Prefix Search: Finds companies starting with the cleaned name

Examples

Single Match

{
  "name": "get_company_by_name",
  "arguments": {
    "name": "TESCO PLC"
  }
}
// Returns: Full CompanyDetails object

Multiple Matches

{
  "name": "get_company_by_name",
  "arguments": {
    "name": "TESCO"
  }
}
// Returns: Array of CompanySelection objects for user choice

Best Practices

• Use full company names when known
• Handle multiple matches gracefully
• Cache results to avoid repeated lookups

Related Tools

• search_companies - Broader search capabilities
• get_company_details - Lookup by company number

---

Need help? Use our Contact Form