Enrich a company

You are wiring up the superagnt "Lead APIs" API to use this endpoint: Enrich a company.

1. CONNECT over MCP (preferred). No token to paste either way.
   On Claude (claude.ai, the desktop app, or Claude Code signed in with a Claude
   account), the server is a connector: give the user this link, they click Add
   and approve:
     https://claude.ai/customize/connectors/yours?modal=add-custom-connector&connectorName=superagnt&connectorUrl=https%3A%2F%2Fmcp.superagnt.com%2Fmcp&open_in_browser=1
   Any other MCP client (or Claude Code signed in with an API key): add the server
   and let the client run the browser sign-in:
     claude mcp add --scope user --transport http superagnt https://mcp.superagnt.com/mcp
     claude mcp login superagnt
   MCP endpoint: https://mcp.superagnt.com/mcp
   After connecting, the tool you want is named exactly:
     data_agnt_companies_enrich
   Call agnt_tools_search or agnt_tools_list_enabled to confirm it is available.

2. REST fallback (if you are not using MCP):
     POST https://api.superagnt.com/companies/enrich
     Header: Authorization: Bearer <YOUR_AGNTDATA_API_KEY>
   Required parameters:
    - identifiers (object, required) — Unique handles to resolve the company. Provide AT LEAST ONE of `domain`, `name`/`company_name`, or `linkedin_url`/`company_linkedin_url`. A lookup that matches nothing is not an error: it returns the identifiers you sent with every other field null with `meta.empty: true` and is not charged. Retrying the same input will not find it.
   Optional parameters:
    - fields (array, optional) — Fields to fill. The waterfall stops calling providers once all of them are filled. Omit for the core set: name, domain, description, industry, employee_count_range, hq_location, linkedin_url. Every other field (employee_count, founded_year, twitter_url, technologies, funding, competitors) is looked up only when named here.
    - max_cost_cents (number, optional)

3. COST & KEY. This endpoint is metered — pricing varies by request, from $0.02 per call. Only successful calls are charged.
   Get a superagnt API key at https://app.superagnt.com.

4. TEST. Connect the server (or set the key), discover the tool
   (data_agnt_companies_enrich), run one minimal call with just the required parameters,
   and report back the shape of the JSON response (top-level fields).

Reference (machine-readable variant): https://www.superagnt.com/docs/apis/lead/agnt/endpoints/companies_enrich.md

{
  "name": "companies_enrich",
  "description": "Enrich a company with normalized firmographic fields (industry, headcount, HQ, founded year, technologies, funding, …). REQUIRES a `identifiers` object containing one or more of: `domain`, `name` (or `company_name`), `linkedin_url` (or `company_linkedin_url`). `domain` is the strongest signal — prefer it when available. Optional `fields[]` narrows the waterfall. Field-aware waterfall same as `/people/enrich`.",
  "parameters": {
    "type": "object",
    "properties": {
      "identifiers": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string",
            "minLength": 1,
            "description": "Company root domain (e.g. \"tesla.com\"). Strongest signal — prefer when available."
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "description": "Company name (e.g. \"Tesla\"). Use when domain is unknown."
          },
          "company_name": {
            "type": "string",
            "minLength": 1,
            "description": "Alias of `name`."
          },
          "linkedin_url": {
            "type": "string",
            "format": "uri",
            "description": "Full company LinkedIn URL (e.g. https://www.linkedin.com/company/tesla-motors)."
          },
          "company_linkedin_url": {
            "type": "string",
            "format": "uri",
            "description": "Alias of `linkedin_url`."
          }
        },
        "additionalProperties": false,
        "description": "Unique handles to resolve the company. Provide AT LEAST ONE of `domain`, `name`/`company_name`, or `linkedin_url`/`company_linkedin_url`. A lookup that matches nothing is not an error: it returns the identifiers you sent with every other field null with `meta.empty: true` and is not charged. Retrying the same input will not find it."
      },
      "fields": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "name",
            "domain",
            "description",
            "industry",
            "employee_count_range",
            "employee_count",
            "hq_location",
            "founded_year",
            "linkedin_url",
            "twitter_url",
            "technologies",
            "funding",
            "competitors"
          ]
        },
        "description": "Fields to fill. The waterfall stops calling providers once all of them are filled. Omit for the core set: name, domain, description, industry, employee_count_range, hq_location, linkedin_url. Every other field (employee_count, founded_year, twitter_url, technologies, funding, competitors) is looked up only when named here."
      },
      "max_cost_cents": {
        "type": "number",
        "minimum": 0
      }
    },
    "required": [
      "identifiers"
    ]
  }
}