MCP TOOLcubeshell.person.profile

Person Details

Use when the user has one professional profile URL and needs that person's business context: current title, employer, location, work history and education. Returns a compact profile document or a not_found result. It does not search for people by name or role (use cubeshell.role.find), find contact details (use the email and mobile tools), or accept a bare name.

Request

Workspace identity comes from the authenticated MCP connection, not from the call arguments. There is no workspace field to set.

ParameterTypeDescription
request_idrequiredstringStable idempotency key, 1 to 200 characters. Replaying the same request_id with the same input returns the original result without a second charge.
quote_onlyrequiredfalseMust be false. Quote-only preview is not available in this version.
input.profile_urlrequiredstringProfessional profile URL or profile username. Up to 500 characters.
max_microcreditsintegerOptional ceiling. If the authoritative price is higher, the call is rejected before anything is charged.
tools/call
{
  "name": "cubeshell.person.profile",
  "arguments": {
    "request_id": "person-profile-2026-07-17-001",
    "quote_only": false,
    "input": { "profile_url": "https://example.com/in/jane-doe" }
  }
}

Result

ParameterTypeDescription
result.full_namestringThe person's full name.
result.first_namestringGiven name.
result.last_namestringFamily name.
result.titlestringCurrent job title.
result.company_namestringCurrent employer.
result.company_websitestringWebsite of the current employer.
result.company_industrystringReported industry of the current employer.
result.locationstringReported location of the person.
result.countrystringReported country.
result.biostringShort self-described summary when the profile carries one.
result.experiencearray of objectWork history, most recent first. May be null.
result.experience[].company_namestringEmployer for that role.
result.experience[].titlestringJob title held in that role.
result.experience[].periodstringReported dates for that role, as written on the profile.
result.educationarray of objectEducation history. May be null.
result.education[].institutionstringSchool or university.
result.education[].degreestringDegree or programme.
result.education[].periodstringReported dates, as written on the profile.
i
Experience and education may be null
A profile can resolve with no work history or no education attached. Both result.experience and result.education can be null rather than an empty array, so check for null before iterating. Individual fields inside a profile can also be absent when the profile does not report them.

Not found

When no profile can be resolved for the URL you sent, the call returns status not_found. That is a real terminal status, not an error, and it is not charged. Agents should not retry a not_found hoping for a different answer. Check the profile URL or move on.