Skip to main content
Glama

Firecrawl by Nova (CIVAI)

people_company_enrich

Use this first when the user names a person (a name with a company or domain, a LinkedIn URL or an email) or a company and wants contact details, a profile or firmographics, such as the email of a founder at a given company. Use it, not people_company_search, whenever you have one of those identifiers. Give people (name with company or domain, LinkedIn URL, email or phone) or companies (domain, name or LinkedIn URL), up to 10 records per call. Each requested field runs a waterfall: Firecrawl tries the providers that can use your inputs one at a time, by listed price, and stops when the field is found. Without contact_fields a person gets a profile and a company gets firmographics; with contact_fields (work_email, personal_email, mobile) each person gets those values and, unless profile is false, the profile too. Ask for mobile only when a phone number is needed: it is the costliest field. A work email is never on a known free-mail domain or role mailbox, and is on the company domain when one is found there; otherwise an address at another employer may be returned with domain_match false and warning "employer_mismatch" in fields.work_email: treat it as unconfirmed. fields says for each answer which provider gave it, whether the email was verified and its domain matched. verified_only returns only verified emails. Each result is the provider's raw response, tagged with the provider. A provider that finds the value is charged its listed price; misses are free. max_credits caps the call; without it there is no cap. To call one specific provider, use alexandria_library_read instead. Example: {"contact_fields":["work_email"],"people":[{"name":"Jane Doe","domain":"example.com"}]}.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "objective": "<objective>"
    },
    "name": "people_company_enrich"
  }
}

Input Schema

NameRequiredDescriptionDefault
peopleNoPeople to enrich. People and companies together are at most 10 per call.
profileNoWith contact_fields, also return each person's profile in the same call, looked up first so the contact lookups can use it. Default true; false skips it.
companiesNoCompanies to enrich, for firmographics.
objectiveYesThe user's underlying goal for this call, in one sentence: what they are ultimately trying to accomplish, not a restatement of the URL or query. Reuse it across related calls. Avoid sensitive information.
max_creditsNoMost credits the whole call may spend. Set it only to a budget the user gave; left out, the call has no cap. A provider is tried only while its listed price still fits, so 0 runs nothing paid.
verified_onlyNoEmail fields: return only an address the provider verified as deliverable. Default false returns the best address found, with fields.<field>.verified saying whether it was verified.
contact_fieldsNoPeople only. Find these contact values for each person; companies in the same call still get firmographics. Include mobile only when a phone number is needed: phone lookups are the costliest and run, and bill, only when mobile is listed.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / objective
      Added value: +{
      +  "description": "The user's underlying goal for this call, in one sentence: what they are ultimately trying to accomplish, not a restatement of the URL or query. Reuse it across related calls. Avoid sensitive information.",
      +  "maxLength": 1000,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / required
      Added value: +[
      +  "objective"
      +]
  2. Changed11 schema fields changed
    • removedInput schema / properties / apollo
      Removed value: -{
      -  "additionalProperties": false,
      -  "description": "Apollo. people: 30 credits per match, includes a work email when Apollo has one. companies: 30 credits per match; a name alone matches only on an exact name. Runs once an organization admin has accepted Apollo's terms.",
      -  "properties": {
      -    "companies": {
      -      "items": {
      -        "additionalProperties": false,
      -        "anyOf": [
      -          {
      -            "properties": {
      -              "domain": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "domain"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "linkedin_url": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "linkedin_url"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "name": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "name"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "website": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "website"
      -            ]
      -          }
      -        ],
      -        "properties": {
      -          "domain": {
      -            "type": "string"
      -          },
      -          "linkedin_url": {
      -            "type": "string"
      -          },
      -          "name": {
      -            "type": "string"
      -          },
      -          "website": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "maxItems": 50,
      -      "minItems": 1,
      -      "type": "array"
      -    },
      -    "people": {
      -      "items": {
      -        "additionalProperties": false,
      -        "anyOf": [
      -          {
      -            "properties": {
      -              "id": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "id"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "email": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "email"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "linkedin_url": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "linkedin_url"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "domain": {
      -                "pattern": "\\S"
      -              },
      -              "name": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "name",
      -              "domain"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "name": {
      -                "pattern": "\\S"
      -              },
      -              "organization_name": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "name",
      -              "organization_name"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "domain": {
      -                "pattern": "\\S"
      -              },
      -              "first_name": {
      -                "pattern": "\\S"
      -              },
      -              "last_name": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "first_name",
      -              "last_name",
      -              "domain"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "first_name": {
      -                "pattern": "\\S"
      -              },
      -              "last_name": {
      -                "pattern": "\\S"
      -              },
      -              "organization_name": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "first_name",
      -              "last_name",
      -              "organization_name"
      -            ]
      -          }
      -        ],
      -        "properties": {
      -          "domain": {
      -            "description": "Employer domain.",
      -            "type": "string"
      -          },
      -          "email": {
      -            "type": "string"
      -          },
      -          "first_name": {
      -            "type": "string"
      -          },
      -          "id": {
      -            "description": "apollo_id from people_company_search.",
      -            "type": "string"
      -          },
      -          "last_name": {
      -            "type": "string"
      -          },
      -          "linkedin_url": {
      -            "type": "string"
      -          },
      -          "name": {
      -            "description": "Full name, with domain or organization_name.",
      -            "type": "string"
      -          },
      -          "organization_name": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "maxItems": 50,
      -      "minItems": 1,
      -      "type": "array"
      -    }
      -  },
      -  "type": "object"
      -}
    • addedInput schema / properties / companies
      Added value: +{
      +  "description": "Companies to enrich, for firmographics.",
      +  "items": {
      +    "additionalProperties": false,
      +    "anyOf": [
      +      {
      +        "properties": {
      +          "domain": {
      +            "pattern": "\\S"
      +          }
      +        },
      +        "required": [
      +          "domain"
      +        ]
      +      },
      +      {
      +        "properties": {
      +          "linkedin_url": {
      +            "pattern": "\\S"
      +          }
      +        },
      +        "required": [
      +          "linkedin_url"
      +        ]
      +      },
      +      {
      +        "properties": {
      +          "name": {
      +            "pattern": "\\S"
      +          }
      +        },
      +        "required": [
      +          "name"
      +        ]
      +      }
      +    ],
      +    "properties": {
      +      "domain": {
      +        "description": "e.g. example.com.",
      +        "type": "string"
      +      },
      +      "linkedin_url": {
      +        "description": "LinkedIn company URL.",
      +        "type": "string"
      +      },
      +      "name": {
      +        "description": "Company name.",
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "maxItems": 10,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • changedInput schema / properties / contact_fields / description
      Previous value: -"Applies to people only; companies in the same call get firmographics. Finds these contact values instead of profiles. fullenrich: work_email 30 credits, personal_email 100, mobile 300, per value found. datalegion: 100 per matched person, every contact field it has. apollo: 30 per match, work email, plus personal emails when personal_email is listed. people_data_labs has no contact lookup."New value: +"People only. Find these contact values for each person; companies in the same call still get firmographics. Include mobile only when a phone number is needed: phone lookups are the costliest and run, and bill, only when mobile is listed."
    • removedInput schema / properties / datalegion
      Removed value: -{
      -  "additionalProperties": false,
      -  "description": "Data Legion. 20 credits per matched person or company.",
      -  "properties": {
      -    "companies": {
      -      "items": {
      -        "additionalProperties": false,
      -        "anyOf": [
      -          {
      -            "properties": {
      -              "domain": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "domain"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "social_url": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "social_url"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "name": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "name"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "linkedin_id": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "linkedin_id"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "ticker_symbol": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "ticker_symbol"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "legion_id": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "legion_id"
      -            ]
      -          }
      -        ],
      -        "properties": {
      -          "domain": {
      -            "type": "string"
      -          },
      -          "industry": {
      -            "type": "string"
      -          },
      -          "legion_id": {
      -            "type": "string"
      -          },
      -          "linkedin_id": {
      -            "type": "string"
      -          },
      -          "name": {
      -            "description": "Fuzzy match; add industry or domain for ambiguous names.",
      -            "type": "string"
      -          },
      -          "social_url": {
      -            "description": "LinkedIn company URL.",
      -            "type": "string"
      -          },
      -          "ticker_symbol": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "maxItems": 50,
      -      "minItems": 1,
      -      "type": "array"
      -    },
      -    "min_confidence": {
      -      "enum": [
      -        "high",
      -        "moderate",
      -        "low"
      -      ],
      -      "type": "string"
      -    },
      -    "people": {
      -      "items": {
      -        "additionalProperties": false,
      -        "anyOf": [
      -          {
      -            "properties": {
      -              "social_url": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "social_url"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "email": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "email"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "linkedin_id": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "linkedin_id"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "legion_id": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "legion_id"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "company": {
      -                "pattern": "\\S"
      -              },
      -              "full_name": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "full_name",
      -              "company"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "full_name": {
      -                "pattern": "\\S"
      -              },
      -              "job_title": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "full_name",
      -              "job_title"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "city": {
      -                "pattern": "\\S"
      -              },
      -              "full_name": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "full_name",
      -              "city"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "full_name": {
      -                "pattern": "\\S"
      -              },
      -              "state": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "full_name",
      -              "state"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "country": {
      -                "pattern": "\\S"
      -              },
      -              "full_name": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "full_name",
      -              "country"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "full_name": {
      -                "pattern": "\\S"
      -              },
      -              "school": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "full_name",
      -              "school"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "company": {
      -                "pattern": "\\S"
      -              },
      -              "first_name": {
      -                "pattern": "\\S"
      -              },
      -              "last_name": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "first_name",
      -              "last_name",
      -              "company"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "first_name": {
      -                "pattern": "\\S"
      -              },
      -              "job_title": {
      -                "pattern": "\\S"
      -              },
      -              "last_name": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "first_name",
      -              "last_name",
      -              "job_title"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "city": {
      -                "pattern": "\\S"
      -              },
      -              "first_name": {
      -                "pattern": "\\S"
      -              },
      -              "last_name": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "first_name",
      -              "last_name",
      -              "city"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "first_name": {
      -                "pattern": "\\S"
      -              },
      -              "last_name": {
      -                "pattern": "\\S"
      -              },
      -              "state": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "first_name",
      -              "last_name",
      -              "state"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "country": {
      -                "pattern": "\\S"
      -              },
      -              "first_name": {
      -                "pattern": "\\S"
      -              },
      -              "last_name": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "first_name",
      -              "last_name",
      -              "country"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "first_name": {
      -                "pattern": "\\S"
      -              },
      -              "last_name": {
      -                "pattern": "\\S"
      -              },
      -              "school": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "first_name",
      -              "last_name",
      -              "school"
      -            ]
      -          }
      -        ],
      -        "properties": {
      -          "city": {
      -            "type": "string"
      -          },
      -          "company": {
      -            "description": "Company name, website or social URL.",
      -            "type": "string"
      -          },
      -          "country": {
      -            "type": "string"
      -          },
      -          "email": {
      -            "type": "string"
      -          },
      -          "first_name": {
      -            "type": "string"
      -          },
      -          "full_name": {
      -            "type": "string"
      -          },
      -          "job_title": {
      -            "type": "string"
      -          },
      -          "last_name": {
      -            "type": "string"
      -          },
      -          "legion_id": {
      -            "type": "string"
      -          },
      -          "linkedin_id": {
      -            "type": "string"
      -          },
      -          "school": {
      -            "type": "string"
      -          },
      -          "social_url": {
      -            "description": "LinkedIn or other social profile URL.",
      -            "type": "string"
      -          },
      -          "state": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "maxItems": 50,
      -      "minItems": 1,
      -      "type": "array"
      -    }
      -  },
      -  "type": "object"
      -}
    • removedInput schema / properties / fullenrich
      Removed value: -{
      -  "additionalProperties": false,
      -  "description": "FullEnrich. people: 10 credits per match, no email. companies: 10 credits per match, includes technologies.",
      -  "properties": {
      -    "companies": {
      -      "items": {
      -        "additionalProperties": false,
      -        "anyOf": [
      -          {
      -            "properties": {
      -              "domain": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "domain"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "professional_network_url": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "professional_network_url"
      -            ]
      -          }
      -        ],
      -        "properties": {
      -          "domain": {
      -            "description": "e.g. stripe.com.",
      -            "type": "string"
      -          },
      -          "professional_network_url": {
      -            "description": "LinkedIn company URL.",
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "maxItems": 50,
      -      "minItems": 1,
      -      "type": "array"
      -    },
      -    "people": {
      -      "items": {
      -        "additionalProperties": false,
      -        "anyOf": [
      -          {
      -            "properties": {
      -              "person_professional_network_url": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "person_professional_network_url"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "company_domain": {
      -                "pattern": "\\S"
      -              },
      -              "person_name": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "person_name",
      -              "company_domain"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "company_professional_network_url": {
      -                "pattern": "\\S"
      -              },
      -              "person_name": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "person_name",
      -              "company_professional_network_url"
      -            ]
      -          }
      -        ],
      -        "properties": {
      -          "company_domain": {
      -            "type": "string"
      -          },
      -          "company_professional_network_url": {
      -            "description": "Employer LinkedIn URL.",
      -            "type": "string"
      -          },
      -          "person_name": {
      -            "description": "Full name, with a company identifier.",
      -            "type": "string"
      -          },
      -          "person_professional_network_url": {
      -            "description": "LinkedIn profile URL. Enough on its own.",
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "maxItems": 50,
      -      "minItems": 1,
      -      "type": "array"
      -    }
      -  },
      -  "type": "object"
      -}
    • changedInput schema / properties / max_credits / description
      Previous value: -"Most credits this call may spend. Set it only to a budget the user gave; left out, it is 1000. The estimate checked against it is each provider's listed price times its unit (record, input, Apollo company page, or 10 web results), as if every record were found; a call whose estimate is higher is refused before any provider runs."New value: +"Most credits the whole call may spend. Set it only to a budget the user gave; left out, the call has no cap. A provider is tried only while its listed price still fits, so 0 runs nothing paid."
    • changedInput schema / properties / max_credits / maximum
      Previous value: -9007199254740991New value: +10000
    • addedInput schema / properties / people
      Added value: +{
      +  "description": "People to enrich. People and companies together are at most 10 per call.",
      +  "items": {
      +    "additionalProperties": false,
      +    "anyOf": [
      +      {
      +        "properties": {
      +          "linkedin_url": {
      +            "pattern": "\\S"
      +          }
      +        },
      +        "required": [
      +          "linkedin_url"
      +        ]
      +      },
      +      {
      +        "properties": {
      +          "email": {
      +            "pattern": "\\S"
      +          }
      +        },
      +        "required": [
      +          "email"
      +        ]
      +      },
      +      {
      +        "properties": {
      +          "phone": {
      +            "pattern": "\\S"
      +          }
      +        },
      +        "required": [
      +          "phone"
      +        ]
      +      },
      +      {
      +        "properties": {
      +          "company": {
      +            "pattern": "\\S"
      +          },
      +          "name": {
      +            "pattern": "\\S"
      +          }
      +        },
      +        "required": [
      +          "name",
      +          "company"
      +        ]
      +      },
      +      {
      +        "properties": {
      +          "domain": {
      +            "pattern": "\\S"
      +          },
      +          "name": {
      +            "pattern": "\\S"
      +          }
      +        },
      +        "required": [
      +          "name",
      +          "domain"
      +        ]
      +      },
      +      {
      +        "properties": {
      +          "company": {
      +            "pattern": "\\S"
      +          },
      +          "first_name": {
      +            "pattern": "\\S"
      +          },
      +          "last_name": {
      +            "pattern": "\\S"
      +          }
      +        },
      +        "required": [
      +          "first_name",
      +          "last_name",
      +          "company"
      +        ]
      +      },
      +      {
      +        "properties": {
      +          "domain": {
      +            "pattern": "\\S"
      +          },
      +          "first_name": {
      +            "pattern": "\\S"
      +          },
      +          "last_name": {
      +            "pattern": "\\S"
      +          }
      +        },
      +        "required": [
      +          "first_name",
      +          "last_name",
      +          "domain"
      +        ]
      +      }
      +    ],
      +    "properties": {
      +      "company": {
      +        "description": "Employer name or domain.",
      +        "type": "string"
      +      },
      +      "domain": {
      +        "description": "Employer domain, e.g. example.com.",
      +        "type": "string"
      +      },
      +      "email": {
      +        "description": "Any email known for the person.",
      +        "type": "string"
      +      },
      +      "first_name": {
      +        "type": "string"
      +      },
      +      "last_name": {
      +        "type": "string"
      +      },
      +      "linkedin_url": {
      +        "description": "LinkedIn profile URL.",
      +        "type": "string"
      +      },
      +      "name": {
      +        "description": "Full name.",
      +        "type": "string"
      +      },
      +      "phone": {
      +        "description": "Any phone number known for the person.",
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "maxItems": 10,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • removedInput schema / properties / people_data_labs
      Removed value: -{
      -  "additionalProperties": false,
      -  "description": "People Data Labs. people: 50 credits per match, with work history. companies: 50 credits per match, with funding history.",
      -  "properties": {
      -    "companies": {
      -      "items": {
      -        "additionalProperties": false,
      -        "anyOf": [
      -          {
      -            "properties": {
      -              "website": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "website"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "profile": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "profile"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "ticker": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "ticker"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "pdl_id": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "pdl_id"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "name": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "name"
      -            ]
      -          }
      -        ],
      -        "properties": {
      -          "location": {
      -            "description": "Helps a name match; never enough alone.",
      -            "type": "string"
      -          },
      -          "name": {
      -            "description": "Company name. A name several companies share may not match.",
      -            "type": "string"
      -          },
      -          "pdl_id": {
      -            "type": "string"
      -          },
      -          "profile": {
      -            "description": "LinkedIn company URL.",
      -            "type": "string"
      -          },
      -          "ticker": {
      -            "type": "string"
      -          },
      -          "website": {
      -            "description": "Company website or domain.",
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "maxItems": 50,
      -      "minItems": 1,
      -      "type": "array"
      -    },
      -    "min_likelihood": {
      -      "description": "Minimum match confidence, 1 to 10 (default 6).",
      -      "maximum": 10,
      -      "minimum": 1,
      -      "type": "integer"
      -    },
      -    "people": {
      -      "items": {
      -        "additionalProperties": false,
      -        "anyOf": [
      -          {
      -            "properties": {
      -              "profile": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "profile"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "email": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "email"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "phone": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "phone"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "pdl_id": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "pdl_id"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "company": {
      -                "pattern": "\\S"
      -              },
      -              "name": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "name",
      -              "company"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "name": {
      -                "pattern": "\\S"
      -              },
      -              "school": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "name",
      -              "school"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "location": {
      -                "pattern": "\\S"
      -              },
      -              "name": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "name",
      -              "location"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "company": {
      -                "pattern": "\\S"
      -              },
      -              "first_name": {
      -                "pattern": "\\S"
      -              },
      -              "last_name": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "first_name",
      -              "last_name",
      -              "company"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "first_name": {
      -                "pattern": "\\S"
      -              },
      -              "last_name": {
      -                "pattern": "\\S"
      -              },
      -              "school": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "first_name",
      -              "last_name",
      -              "school"
      -            ]
      -          },
      -          {
      -            "properties": {
      -              "first_name": {
      -                "pattern": "\\S"
      -              },
      -              "last_name": {
      -                "pattern": "\\S"
      -              },
      -              "location": {
      -                "pattern": "\\S"
      -              }
      -            },
      -            "required": [
      -              "first_name",
      -              "last_name",
      -              "location"
      -            ]
      -          }
      -        ],
      -        "properties": {
      -          "company": {
      -            "description": "Employer name or domain.",
      -            "type": "string"
      -          },
      -          "email": {
      -            "type": "string"
      -          },
      -          "first_name": {
      -            "type": "string"
      -          },
      -          "last_name": {
      -            "type": "string"
      -          },
      -          "location": {
      -            "type": "string"
      -          },
      -          "name": {
      -            "type": "string"
      -          },
      -          "pdl_id": {
      -            "type": "string"
      -          },
      -          "phone": {
      -            "type": "string"
      -          },
      -          "profile": {
      -            "description": "LinkedIn or other social profile URL.",
      -            "type": "string"
      -          },
      -          "school": {
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "maxItems": 50,
      -      "minItems": 1,
      -      "type": "array"
      -    }
      -  },
      -  "type": "object"
      -}
    • addedInput schema / properties / profile
      Added value: +{
      +  "description": "With contact_fields, also return each person's profile in the same call, looked up first so the contact lookups can use it. Default true; false skips it.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / verified_only
      Added value: +{
      +  "description": "Email fields: return only an address the provider verified as deliverable. Default false returns the best address found, with fields.<field>.verified saying whether it was verified.",
      +  "type": "boolean"
      +}
  3. Changed1 schema field changed
    • changedInput schema / properties / max_credits / description
      Previous value: -"Most credits this call may spend. Omit it for 1000. 0 spends nothing, so only free calls run. The estimate checked against it is each provider's listed price times its unit (record, input, Apollo company page, or 10 web results), as if every record were found; a call whose estimate is higher is refused before any provider runs."New value: +"Most credits this call may spend. Set it only to a budget the user gave; left out, it is 1000. The estimate checked against it is each provider's listed price times its unit (record, input, Apollo company page, or 10 web results), as if every record were found; a call whose estimate is higher is refused before any provider runs."
  4. Changed1 schema field changed
    • changedInput schema / properties / apollo / description
      Previous value: -"Apollo. people: 30 credits per match, includes a work email when Apollo has one. companies: 30 credits per match; a name alone matches only on an exact name."New value: +"Apollo. people: 30 credits per match, includes a work email when Apollo has one. companies: 30 credits per match; a name alone matches only on an exact name. Runs once an organization admin has accepted Apollo's terms."
  5. Changed2 schema fields changed
    • changedInput schema / properties / contact_fields / description
      Previous value: -"People only: find these contact values instead of profiles. fullenrich: work_email 30 credits, personal_email 100, mobile 300, per value found. datalegion: 100 per matched person, every contact field it has. apollo: 30 per match, work email, plus personal emails when personal_email is listed. people_data_labs has no contact lookup."New value: +"Applies to people only; companies in the same call get firmographics. Finds these contact values instead of profiles. fullenrich: work_email 30 credits, personal_email 100, mobile 300, per value found. datalegion: 100 per matched person, every contact field it has. apollo: 30 per match, work email, plus personal emails when personal_email is listed. people_data_labs has no contact lookup."
    • changedInput schema / properties / max_credits / description
      Previous value: -"Most credits this call may spend, default 1000. A call that could cost more, if every record were found, is refused before any provider runs."New value: +"Most credits this call may spend. Omit it for 1000. 0 spends nothing, so only free calls run. The estimate checked against it is each provider's listed price times its unit (record, input, Apollo company page, or 10 web results), as if every record were found; a call whose estimate is higher is refused before any provider runs."
  6. Changed3 schema fields changed
    • changedInput schema / properties / people_data_labs / description
      Previous value: -"People Data Labs. people: 50 credits per match, richest work history. companies: 50 credits per match, funding history."New value: +"People Data Labs. people: 50 credits per match, with work history. companies: 50 credits per match, with funding history."
    • changedInput schema / properties / people_data_labs / properties / companies / items / properties / name / description
      Previous value: -"Weakest identifier; ambiguous names miss."New value: +"Company name. A name several companies share may not match."
    • changedInput schema / properties / people_data_labs / properties / companies / items / properties / website / description
      Previous value: -"Most reliable identifier."New value: +"Company website or domain."
  7. Added

TDQS

A4.8/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden and does so: it discloses the provider waterfall and ordering by price, billing semantics (found value billed at listed price, misses free), the max_credits cap and its absence by default, the employer_mismatch warning with domain_match false, and the costliness of mobile lookups. It also states the return shape (raw provider response tagged with the provider).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The critical routing and identifier guidance is front-loaded, and the dense body is largely earned by genuine behavioral detail. There is some duplication with the schema, notably the repeated warning that mobile is the costliest field, which could be stated once.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

There is no output schema, so the description must explain results, and it does: raw provider responses tagged by provider, plus the fields block reporting provider, verification and domain match. Combined with the waterfall and billing model, an agent has enough to call this correctly and predict its cost.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3, but the description adds real meaning beyond the schema: it explains that contact_fields changes the default output, that profile defaults true and is looked up first, that verified_only filters to provider-verified addresses, and what max_credits does to provider selection. It stops short of restating individual field formats, which the schema already covers.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb (enrich) and resource (people and companies), lists the accepted identifier types, and explicitly contrasts itself with people_company_search and alexandria_library_read. An agent can identify what this does and how it differs from siblings without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives an explicit priority rule ("Use this first when..."), a disambiguation rule against people_company_search keyed on identifier availability, and a separate routing rule to alexandria_library_read for single-provider calls. When-to-use, when-to-use-something-else, and the selecting condition are all stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources