Humantic AI MCP / Tools / humantic_pi_profile_create_v1
Personality Profiling Pi

humantic_pi_profile_create_v1

Create a Humantic AI profile for one person.

At a glance

Key inputs

One of linkedin_url / email / text; optional first_name / last_name / company_name hints.

Upstream API

POST /v1/user-profile/create

Example ask
Create a Humantic AI profile from this LinkedIn URL: linkedin.com/in/sarah-chen-vp
Example tool call
humantic_pi_profile_create_v1({
  "linkedin_url": "https://linkedin.com/in/sarah-chen-vp"
})
Example output
// Profile already exists → served straight back
{
  "status": "200",
  "message": "Success",
  "results": {
    "display_name": "Sarah Chen",
    "user_description": "VP Operations at Acme Corp",
    "location": "Austin, Texas, United States",
    "personality_analysis": {
      "disc_assessment": {
        "dominance":       { "score": 7.8, "level": "high" },
        "influence":       { "score": 4.1, "level": "medium" },
        "steadiness":      { "score": 2.8, "level": "low" },
        "calculativeness": { "score": 8.9, "level": "high" }
      },
      "ocean_assessment": { "conscientiousness": { "score": 7.9, "level": "Conscientious" }, "openness": { "score": 6.2, "level": "Somewhat Open" } },
      "summary": { "disc": { "label": ["D", "C"], "description": ["High Dominance", "High Calculativeness"], "color": "red", "group": "dominant", "archetype": "Strategist" } }
    },
    "persona": { "sales": { "communication_advice": {
      "adjectives": ["Direct", "Analytical", "Results-Driven"],
      "key_traits": { "Speed": "Decides fast once the numbers hold up.", "Decision Drivers": "Evidence, ROI, and low execution risk." },
      "what_to_say":   ["Lead with hard numbers and a clear ROI case", "Be brief; get to the point in the first line"],
      "what_to_avoid": ["Small talk before the substance", "Vague claims without proof points"]
    } } }
  },
  "metadata": { "confidence": { "score": 92, "level": "High Confidence" }, "status": "FOUND", "status_code": 1, "analysis_status": "COMPLETE", "linkedin_analysis_status": "COMPLETED", "analysis_type": "linkedin" },
  "_status": "ready",
  "_trace_id": "7383c1abdacbf400",
  "_quota": { "pool": "api", "limit": 3000, "consumed": 412, "remaining": 2588 }
}

// New person → analysis kicks off; call profile_fetch after 30–45 seconds
{
  "status": "200",
  "message": "Success",
  "metadata": { "status": "FOUND", "status_code": 1, "analysis_status": "IN_PROGRESS", "linkedin_analysis_status": "PENDING", "analysis_type": "linkedin" },
  "_status": "processing",
  "_trace_id": "a1c9e4d27b60f3e5",
  "_quota": { "pool": "api", "limit": 3000, "consumed": 413, "remaining": 2587 }
}

// Unknown or private LinkedIn URL → no analysis
{
  "status": "200",
  "message": "Success",
  "metadata": { "status": "NOT_FOUND", "status_code": 41, "analysis_status": "NOT_FOUND", "linkedin_analysis_status": "INVALID_URL", "analysis_type": "linkedin" },
  "_status": "ready",
  "_trace_id": "84a4ac0e0b02dfab"
}
Good to know. Use this the first time you research a person. If a Humantic AI profile already exists it is served straight back in this response (_status: "ready"). If not, the analysis starts and the response comes back _status: "processing" — call profile_fetch after 30–45 seconds to pick up the finished profile. An unknown or private LinkedIn URL returns metadata.status: "NOT_FOUND". If confidence comes back low, follow up with profile_update with something the person wrote.