Skip to content
Eden Engine

Person Profile Enrichment (by Name, Company, or LinkedIn URL)

omnial/people-enrich

Given identity clues about a person -- a name paired with a company or location, a single LinkedIn/GitHub/X/personal-site URL, or a work email -- returns a normalized professional profile with a match confidence score: current role and employer, work history, education, skills, a short bio, and city-level location. Built for finding a public professional profile, not for locating a private individual's personal contact details.

activeper callv3

Price

Up to $0.0692 per call; you pay what the call used

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.

Use it

Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.

Connect once and your AI can find and run this tool, and any other it needs.

For developers: the calls your assistant makes
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/people-enrich" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/people-enrich" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/people-enrich", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/people-enrich", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.0692
Updated
Nov 6, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "properties": {
    "name": {
      "type": "object",
      "required": [
        "first",
        "last"
      ],
      "properties": {
        "last": {
          "type": "string",
          "maxLength": 100,
          "minLength": 1,
          "description": "Family name."
        },
        "first": {
          "type": "string",
          "maxLength": 100,
          "minLength": 1,
          "description": "Given name."
        }
      },
      "description": "The person's name. On its own it is not enough — pair it with company, education, or location.",
      "additionalProperties": false
    },
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "maxLength": 320,
      "description": "WORK email address. Free-provider (gmail.com, yahoo.com) and disposable addresses are rejected upstream with a 422."
    },
    "company": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "maxLength": 200,
          "minLength": 1,
          "description": "Company name."
        },
        "domain": {
          "type": "string",
          "maxLength": 253,
          "minLength": 1,
          "description": "Company website domain."
        }
      },
      "description": "Current or recent employer.",
      "additionalProperties": false
    },
    "location": {
      "type": "object",
      "properties": {
        "city": {
          "type": "string",
          "maxLength": 200,
          "minLength": 1
        },
        "region": {
          "type": "string",
          "maxLength": 200,
          "minLength": 1
        },
        "country": {
          "type": "string",
          "maxLength": 200,
          "minLength": 1
        }
      },
      "description": "Where the person lives or works.",
      "additionalProperties": false
    },
    "education": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "degree": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1,
            "description": "Degree earned, e.g. 'BSc'."
          },
          "institution": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Organization name."
              },
              "domain": {
                "type": "string",
                "maxLength": 253,
                "minLength": 1,
                "description": "Organization website domain."
              }
            },
            "description": "School or university.",
            "additionalProperties": false
          },
          "field_of_study": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1,
            "description": "Field of study, e.g. 'Computer Science'."
          },
          "graduation_year": {
            "type": "integer",
            "maximum": 2200,
            "minimum": 1900,
            "description": "Graduation year."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 10,
      "minItems": 1,
      "description": "Education history clues. Up to 10 entries."
    },
    "timeoutMS": {
      "type": "integer",
      "maximum": 300000,
      "minimum": 1000,
      "description": "Upstream timeout in milliseconds (max 300000). The upstream call is aborted with a 408 when exceeded. Keep it below the endpoint's requestTimeoutMs so the provider answers before the platform's own budget expires."
    },
    "social_urls": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "maxItems": 20,
      "minItems": 1,
      "description": "Person-profile URLs (LinkedIn, GitHub, X, personal site) — the strongest clue. Up to 20."
    }
  },
  "minProperties": 1,
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "properties": {
    "match": {
      "type": "object",
      "properties": {
        "score": {
          "type": "number",
          "description": "Match confidence, 0-100. Observed 98 (name + company + location input) and 100 (a single LinkedIn URL input)."
        },
        "person": {
          "type": "object",
          "properties": {
            "bio": {
              "type": "string",
              "description": "A short, self-descriptive bio. Usually populated."
            },
            "name": {
              "type": "object",
              "properties": {
                "full": {
                  "type": "string"
                },
                "last": {
                  "type": "string"
                },
                "first": {
                  "type": "string"
                }
              },
              "additionalProperties": true
            },
            "skills": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Usually an empty array -- a populated shape is not documented."
            },
            "location": {
              "type": "object",
              "properties": {
                "city": {
                  "type": "string"
                },
                "region": {
                  "type": "string"
                },
                "country": {
                  "type": "string"
                },
                "display": {
                  "type": "string"
                },
                "country_code": {
                  "type": "string",
                  "description": "Observed as a 3-letter code, e.g. \"USA\"."
                }
              },
              "description": "City-level professional location, not a street address.",
              "additionalProperties": true
            },
            "education": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "degree": {
                    "type": "string"
                  },
                  "end_date": {
                    "type": "object",
                    "properties": {
                      "day": {
                        "type": "number"
                      },
                      "year": {
                        "type": "number"
                      },
                      "month": {
                        "type": "number"
                      }
                    },
                    "additionalProperties": true
                  },
                  "start_date": {
                    "type": "object",
                    "properties": {
                      "day": {
                        "type": "number"
                      },
                      "year": {
                        "type": "number"
                      },
                      "month": {
                        "type": "number"
                      }
                    },
                    "additionalProperties": true
                  },
                  "institution": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string"
                      },
                      "domain": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": true
                  },
                  "field_of_study": {
                    "type": "string"
                  }
                },
                "additionalProperties": true
              },
              "description": "Education history. Entry completeness varies: some entries carry start/end years but a missing institution domain, others carry a degree but no dates at all -- treat any single sub-field as best-effort."
            },
            "checked_at": {
              "type": "string",
              "description": "ISO 8601 timestamp of when this profile record was last checked."
            },
            "experience": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string"
                  },
                  "end_date": {
                    "type": "object",
                    "properties": {
                      "day": {
                        "type": "number"
                      },
                      "year": {
                        "type": "number"
                      },
                      "month": {
                        "type": "number"
                      }
                    },
                    "description": "Absent on an entry where `is_current` is true.",
                    "additionalProperties": true
                  },
                  "location": {
                    "type": "string"
                  },
                  "is_current": {
                    "type": "boolean"
                  },
                  "start_date": {
                    "type": "object",
                    "properties": {
                      "day": {
                        "type": "number"
                      },
                      "year": {
                        "type": "number"
                      },
                      "month": {
                        "type": "number"
                      }
                    },
                    "additionalProperties": true
                  },
                  "organization": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string"
                      },
                      "domain": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": true
                  }
                },
                "additionalProperties": true
              },
              "description": "Career history, typically most recent first."
            },
            "current_role": {
              "type": "object",
              "properties": {
                "title": {
                  "type": "string"
                },
                "location": {
                  "type": "string",
                  "description": "Often absent; where observed, its value ('CEO') duplicated the role title rather than naming an actual place -- treat as unreliable/best-effort when present, and note it is not always present at all."
                },
                "is_current": {
                  "type": "boolean"
                },
                "start_date": {
                  "type": "object",
                  "properties": {
                    "day": {
                      "type": "number"
                    },
                    "year": {
                      "type": "number"
                    },
                    "month": {
                      "type": "number"
                    }
                  },
                  "additionalProperties": true
                },
                "organization": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "domain": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": true
                }
              },
              "description": "The person's most current listed role -- for one lookup (Satya Nadella) this was a board-trustee position, not the person's best-known job, so do not assume it is always their primary employer.",
              "additionalProperties": true
            },
            "last_updated": {
              "type": "string",
              "description": "ISO 8601 timestamp of when this profile record was last updated."
            },
            "current_role_status": {
              "type": "string",
              "description": "Typically \"present\"."
            }
          },
          "additionalProperties": true
        },
        "status": {
          "type": "string",
          "description": "Typically \"candidate\". Other states the provider may return on a miss are undocumented here since none was observed."
        }
      },
      "additionalProperties": true
    }
  },
  "description": "The enrichment result. Calls observed in testing matched a real person (`match.status: \"candidate\"`) -- a not-found/no-match shape was never observed and is not described here.",
  "additionalProperties": true
}