Contract
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 at no charge."
},
"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.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. Populated on both fixtures."
},
"name": {
"type": "object",
"properties": {
"full": {
"type": "string"
},
"last": {
"type": "string"
},
"first": {
"type": "string"
}
},
"additionalProperties": true
},
"skills": {
"type": "array",
"items": {
"type": "string"
},
"description": "Observed as an empty array on both captured fixtures -- a populated shape is unconfirmed."
},
"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: one fixture's entries carry start/end years and a missing institution domain on one entry, the other's 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, most recent first on both fixtures observed."
},
"current_role": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"location": {
"type": "string",
"description": "Observed present on only one fixture, and there 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 -- on one fixture (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": "Observed value: \"present\" on both fixtures."
}
},
"additionalProperties": true
},
"status": {
"type": "string",
"description": "Observed value: \"candidate\" on both captured fixtures. Other states the vendor may return on a miss are undocumented here since none was observed."
}
},
"additionalProperties": true
}
},
"description": "The enrichment result, as returned at the result path. Both fixtures observed matched a real person (`match.status: \"candidate\"`) -- a not-found/no-match shape was never observed and is not described here.",
"additionalProperties": true
}Pricing
Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.
Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.
| Charge | Rate |
|---|---|
Per call Flat, regardless of what comes back | $0.02457 |
- Cost basis
- Not recorded
This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.
- Updated
- Sep 23, 2026