Multi-LLM entity enrichment: schemas, single/batch enrichment, fusion, model benchmarks.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional. OAuth 2.1 is the primary auth: clients implementing the standard MCP auth spec (claude.ai, Claude Code, Cursor) omit this header and authorize interactively via browser consent. Use an Entity Enricher API key (ent_..., created under Settings -> API Keys) only for static-config or headless clients.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Acknowledge every delta through up_to_id after successful application, releasing its lease. Acknowledgement can permanently purge delivered deltas and entity state according to registration options; never acknowledge unapplied or failed work. Returns acknowledged and purged counts. No LLM call. Apply/ack workflow: enricher://docs/database-sync.
Acknowledge every delta with id <= this value.
Database sync UUID.
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Acknowledge every delta through up_to_id after successful application, releasing its lease. Acknowledgement can permanently purge delivered deltas and entity state according to registration options; never acknowledge unapplied or failed work. Returns acknowledged and purged counts. No LLM call. Apply/ack workflow: enricher://docs/database-sync.
| Argument | Type | Description |
|---|---|---|
| up_to_id* | integer | Acknowledge every delta with id <= this value. |
| database_id* | string | Database sync UUID. |
{
"type": "object",
"title": "ack_database_deltasArguments",
"required": [
"database_id",
"up_to_id"
],
"properties": {
"up_to_id": {
"type": "integer",
"title": "Up To Id",
"minimum": 1,
"description": "Acknowledge every delta with id <= this value."
},
"database_id": {
"type": "string",
"title": "Database Id",
"description": "Database sync UUID."
}
}
}Add a property under the root (parent_path=''), an object path or '$defs.X'. Accepts a scalar, nested object or reference to an existing $defs entity or $enums vocabulary. Requires editor; no LLM call. Omitted nullable means required at enrichment. Adding inside $defs affects every usage site. The same validation and working-copy/publication rules as update_schema_property apply. Read the container with get_schema_part first. Property format: enricher://docs/schema-reference.
| Argument | Type | Description |
|---|---|---|
| name* | string | New property name (letters, digits, underscores). |
| schema_id* | string | UUID of the saved schema. |
| definition* | object | {type|ref, description?, examples?, nullable?, flags?, properties?} — 'properties' nests the same shape per child for an inline object. |
| parent_path | string | '' = root, or an object path / '$defs.X'. |
{
"type": "object",
"title": "add_schema_propertyArguments",
"required": [
"schema_id",
"name",
"definition"
],
"properties": {
"name": {
"type": "string",
"title": "Name",
"description": "New property name (letters, digits, underscores)."
},
"schema_id": {
"type": "string",
"title": "Schema Id",
"description": "UUID of the saved schema."
},
"definition": {
"type": "object",
"title": "Definition",
"description": "{type|ref, description?, examples?, nullable?, flags?, properties?} — 'properties' nests the same shape per child for an inline object.",
"additionalProperties": true
},
"parent_path": {
"type": "string",
"title": "Parent Path",
"default": "",
"description": "'' = root, or an object path / '$defs.X'."
}
}
}Add an identity concept at zero usage, or add text as an alias using alias_of. Requires editor; resolution may incur embedding/judge cost. Probe first; if the text already resolves to an incumbent, offer that concept instead of blindly retrying. Aliases resolving to another concept are refused. embedding_model selects a new type's space only. Returns concept details and link; manage existing aliases with update_concept_alias. See enricher://docs/semantic-ids.
| Argument | Type | Description |
|---|---|---|
| text* | string | The identity text to add. |
| alias_of | any | semantic_id of the concept this text is a surface form of; omit to add a standalone concept. |
| judge_floor | any | Similarity at or above which a candidate is put to the identity judge. Omit to use the organization default (Settings → Organization). |
| concept_type* | string | Concept type the text belongs to. |
| embedding_model | any | Composite key (provider::model) to embed a NEW concept type under. |
{
"type": "object",
"title": "add_semantic_conceptArguments",
"required": [
"text",
"concept_type"
],
"properties": {
"text": {
"type": "string",
"title": "Text",
"description": "The identity text to add."
},
"alias_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Alias Of",
"default": null,
"description": "semantic_id of the concept this text is a surface form of; omit to add a standalone concept."
},
"judge_floor": {
"anyOf": [
{
"type": "number",
"maximum": 1,
"minimum": 0
},
{
"type": "null"
}
],
"title": "Judge Floor",
"default": null,
"description": "Similarity at or above which a candidate is put to the identity judge. Omit to use the organization default (Settings → Organization)."
},
"concept_type": {
"type": "string",
"title": "Concept Type",
"description": "Concept type the text belongs to."
},
"embedding_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Embedding Model",
"default": null,
"description": "Composite key (provider::model) to embed a NEW concept type under."
}
}
}Analyze sample property ambiguity and relationship identity scoping before schema generation. Requires editor; billed analysis persists a record but does not modify the sample. Returns findings with competing interpretations and suggested_names, plus identity_scoping for sites mixing an entity's own facts with facts about its parent relationship. Names are judged in their parent context, including missing units, periods or ranges. Apply only approved corrections before create_schema_from_sample. Optional: generate_sample already checks its initial sample. How to interpret findings: enricher://docs/schema-from-sample.
| Argument | Type | Description |
|---|---|---|
| model | string | Model composite key. 'auto' (default) lets the server pick the org's default schema-generation model. |
| sample_json* | object | The sample entity object to analyze. |
| protected_fields | any | Leaf names you own (still flagged, but no rename is proposed for them). |
{
"type": "object",
"title": "analyze_sampleArguments",
"required": [
"sample_json"
],
"properties": {
"model": {
"type": "string",
"title": "Model",
"default": "auto",
"description": "Model composite key. 'auto' (default) lets the server pick the org's default schema-generation model."
},
"sample_json": {
"type": "object",
"title": "Sample Json",
"description": "The sample entity object to analyze.",
"additionalProperties": true
},
"protected_fields": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Protected Fields",
"default": null,
"description": "Leaf names you own (still flagged, but no rename is proposed for them)."
}
}
}Analyze a saved schema's property ambiguity and relationship identity scoping, writing annotations to the schema. Requires editor; billed. Incremental by default; force=true rechecks all sites. Returns findings, suggested descriptions, identity-scoping annotations and pending unification proposals; it does not apply suggested structural changes. Fails with ambiguity_check_disabled if the feature is off. Use update_schema_property for approved descriptions or renames; review structural changes and publish them when linked. Interpretation and modeling guidance: enricher://docs/schema-reference.
| Argument | Type | Description |
|---|---|---|
| force | boolean | Re-analyze every property, not just unannotated ones. |
| model | string | Model composite key. 'auto' (default) lets the server pick the org's default schema-generation model. |
| schema_id* | string | UUID of the saved schema. |
{
"type": "object",
"title": "analyze_schemaArguments",
"required": [
"schema_id"
],
"properties": {
"force": {
"type": "boolean",
"title": "Force",
"default": false,
"description": "Re-analyze every property, not just unannotated ones."
},
"model": {
"type": "string",
"title": "Model",
"default": "auto",
"description": "Model composite key. 'auto' (default) lets the server pick the org's default schema-generation model."
},
"schema_id": {
"type": "string",
"title": "Schema Id",
"description": "UUID of the saved schema."
}
}
}Resume a paused job with answers to the questions returned under pause. answers maps question IDs to {option_ids: [...], text: ...}; omitted questions use defaults. Relay consequential unanswered choices to the user unless those defaults were already authorized. Resuming may continue billed model work. Returns the next pause, terminal result or running status after wait_seconds; poll get_job_status if still running. Works with generate_sample clarification in both knowledge and source modes. See enricher://docs/documents.
| Argument | Type | Description |
|---|---|---|
| job_id* | string | Paused job ID. |
| answers | any | Map of question id -> {option_ids: list[str], text: str | null}. Omit to resume with the planner's defaults. |
| wait_seconds | integer | How long to wait for the job's next pause or completion before returning (0 = return immediately after resuming). |
{
"type": "object",
"title": "answer_job_questionArguments",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"title": "Job Id",
"description": "Paused job ID."
},
"answers": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Answers",
"default": null,
"description": "Map of question id -> {option_ids: list[str], text: str | null}. Omit to resume with the planner's defaults."
},
"wait_seconds": {
"type": "integer",
"title": "Wait Seconds",
"default": 120,
"maximum": 600,
"minimum": 0,
"description": "How long to wait for the job's next pause or completion before returning (0 = return immediately after resuming)."
}
}
}Answer one LLM request of a job started with delegate_llm_calls=true: you are its model. Read the request under get_job_status(job_id).llm_requests (or in the start tool's return): run systemPrompt + messages with the listed tools and toolChoice on your own model, then pass the result here as response in MCP CreateMessageResult shape — {role: 'assistant', model: '<your model>', stopReason: 'toolUse' | 'endTurn', content: [{type: 'tool_use', id, name, input}] | {type: 'text', text}} — with optional usage {input_tokens, output_tokens}. toolChoice.mode 'required' means one tool_use block whose input matches the tool's inputSchema. The platform validates the answer like a provider's: a rejected answer returns as a new request with the error in a tool_result (isError) — fix and answer again. Returns the next pending request(s), the terminal result, or the running status after wait_seconds. Not for question pauses (answer_job_question). No platform LLM call. Guide: enricher://docs/llm-delegation.
| Argument | Type | Description |
|---|---|---|
| job_id* | string | Job whose llm_requests you are answering. |
| response* | object | MCP CreateMessageResult: role 'assistant', model (your model's name), stopReason, content (one block or a list of text / tool_use blocks); optional usage {input_tokens, output_tokens}. |
| request_id* | string | The request_id of the entry you answer. |
| wait_seconds | integer | How long to wait for the job's next pending request, pause or completion before returning (0 = return right after handing over the answer). |
Assign or clear the host provisioning a database sync. Requires owner and a sync-enabled plan. host accepts a connected host ID/name; null unassigns it. Assignment may create the physical database and start synchronization automatically. Moving hosts revokes the old host's minted credential; an existing manual pairing is not evicted. Candidates come from create_database_sync or list_database_syncs. No LLM call. Managed and manual setup: enricher://docs/database-sync.
| Argument | Type | Description |
|---|---|---|
| host | any | Sync host id or name; null clears the assignment. |
| database_id* | string | Database sync UUID (from list_database_syncs). |
{
"type": "object",
"title": "assign_sync_hostArguments",
"required": [
"database_id"
],
"properties": {
"host": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Host",
"default": null,
"description": "Sync host id or name; null clears the assignment."
},
"database_id": {
"type": "string",
"title": "Database Id",
"description": "Database sync UUID (from list_database_syncs)."
}
}
}Request cancellation of a pending, running or paused LLM job. In-flight model calls may finish and persist records; remaining work is skipped. Cancellation does not roll back records or database writes. Read get_job_status and list_records(job_id=...) afterward to inspect the outcome. No new LLM call is started by this tool.
| Argument | Type | Description |
|---|---|---|
| job_id* | string | Job ID to cancel. |
{
"type": "object",
"title": "cancel_jobArguments",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"title": "Job Id",
"description": "Job ID to cancel."
}
}
}Start a billed analysis proposing database keys, SQL types, indexes and relationship ownership on a linked schema. Requires editor. Registration already starts the initial pass; use this after relevant edits. Incremental scope covers new properties or changed JSON types/multilingual flags; an empty scope does not rerun unchanged fields. Returns job_id: poll get_job_status and inspect get_schema's working copy. Correct proposals with property tools, then publish_schema to ship changes. Entity-level indexes and ownership choices: enricher://docs/database-sync.
| Argument | Type | Description |
|---|---|---|
| model | string | Model composite key. 'auto' (default) lets the server pick the org's default schema-generation model, falling back to the model that generated the schema. |
| schema_id* | string | Saved schema UUID to classify. |
| delegate_llm_calls | boolean | Run every LLM call of this job on YOUR model instead of a platform model: the job parks each call as a pending request you answer with answer_llm_request; no credits are consumed. Model parameters must then be omitted or 'auto'. Plan feature. Protocol: enricher://docs/llm-delegation. |
{
"type": "object",
"title": "classify_database_modelArguments",
"required": [
"schema_id"
],
"properties": {
"model": {
"type": "string",
"title": "Model",
"default": "auto",
"description": "Model composite key. 'auto' (default) lets the server pick the org's default schema-generation model, falling back to the model that generated the schema."
},
"schema_id": {
"type": "string",
"title": "Schema Id",
"description": "Saved schema UUID to classify."
},
"delegate_llm_calls": {
"type": "boolean",
"title": "Delegate Llm Calls",
"default": false,
"description": "Run every LLM call of this job on YOUR model instead of a platform model: the job parks each call as a pending request you answer with answer_llm_request; no credits are consumed. Model parameters must then be omitted or 'auto'. Plan feature. Protocol: enricher://docs/llm-delegation."
}
}
}Create a reusable benchmark with a mandatory scoring judge. scenario_type='enrichment' needs schema_id and entity_data (the entity to enrich, as enrich_entity takes it — refused when it carries no value; never put it in description); 'sample_generation' needs sample_request; 'schema_generation' needs entity_samples (1..20 samples of one entity type). Enrichment and schema generation need a verified gold reference via set_benchmark_reference before running. Sample generation is rubric-scored and takes no reference. Requires owner and a plan with benchmarks; creating the scenario does not run the models. Returns the scenario and link. Next call run_benchmark when its reference requirements are satisfied. See enricher://docs/model-benchmark.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| language | string | sample_generation: output language for names + values. |
| strategy | string | Enrichment: pinned strategy (no 'auto'): single_pass | expert_domains | multi_expertise |
| languages | any | Enrichment: defaults to ['en']. |
| schema_id | any | UUID of the saved schema to enrich against (enrichment only, required there). |
| description | any | Free-text note shown in the Benchmarks tab; no model ever reads it. The entity to enrich goes in entity_data, never here. |
| entity_data |
Register a saved schema for relational synchronization to PostgreSQL, MySQL or SQLite. Requires owner and a sync-enabled plan. Starts a billed classification job when available; returns database ID, classification_job_id or classification_skipped, stamped_keys and registration_notices. The webhook signing secret stays outside the MCP response and can be managed in the web app. The schema is initially unpublished: wait for classification, review keys/options/notices, then publish_schema before any data can sync. pk_strategy locks once the physical model ships. Owned child arrays replace previous membership, so omitted children are deleted on re-enrichment. purge_entity_state transfers custody to replicas; relay custody_warning. A connected host may provision automatically; otherwise get_database_setup_instructions starts browser-confirmed client pairing. Modeling, publication and delivery: enricher://docs/database-sync.
| Argument | Type | Description |
|---|---|---|
| name* | string | Name of the physical database (existing on the user's server, or created by `ee-database run --create-missing`); shared by every schema linked to this database sync. Also used (snake-cased) as the conventional replica database name by the ee-database CLI. |
| dialect | string | SQL dialect the deltas are rendered in: postgres | mysql | sqlite. |
| on_gaps | string | Admission gate — what is written when an enrichment has gaps (non-nullable fields unfilled). 'reject_entity': nothing — one gap anywhere refuses the whole enrichment. 'skip_children' (default): the entity without its incomplete children — an array item is dropped, a shared 1-1 reference is detached (child not written, parent's foreign key NULL); gaps with no such child above them still reject. 'accept_partial': everything — gaps land as NULLs, and under last-write-wins a later partial run erases what an earlier one filled. |
Generate and auto-save a schema from reviewed samples, returning schema_id, schema content and record links. Supply entity_samples (or samples_csv), sample_record_id, or both; explicit samples override stored JSON while attachment inheritance is preserved. Samples must describe one entity type in one language. Generation combines their fields and annotates relationships; it does not redesign the approved structure. Resolve consequential modeling choices and whether to generate semantic IDs before calling; semantic IDs need an organization embedding model and add cost. Requires editor; synchronous and billed. Review returned suggestions before applying edits with property tools. Sample review and canonicalizations: enricher://docs/schema-from-sample; schema format: enricher://docs/schema-reference.
| Argument | Type | Description |
|---|---|---|
| model | string | Model composite key, or auto (default) for the organization task selection. Explicit keys are discovered through list_models. |
| language | any | Language of schema type names/descriptions and annotations; defaults to the sample-key language. Sample property names are not translated. Separate from enrichment output languages. |
| samples_csv | any | Samples as CSV text instead of entity_samples (never both): the first row is ALWAYS the header, each data row one sample. Delimiter ',', ';' or tab; headers become identifier keys ('Author Name' -> author_name); each column gets one type (integer, number, boolean or text; empty cell = null; decimal commas read in ';'/tab text). Over 20 rows, 20 are kept, covering every column. Read the result's csv_import and relay the kept rows and renamed headers. |
| attachment_ids | any | UUIDs used as source context and persisted for regeneration. With sample_record_id, omit to inherit its linked attachments; pass [] to deliberately use none, or a non-empty list to override. |
Permanently delete an attachment in your organization, including its stored file. No LLM call. Existing records remain, but future calls or schema regeneration cannot reuse the deleted source. Delete only when that source is no longer needed; this is not a required post-enrichment step. Returns the deleted ID and filename.
| Argument | Type | Description |
|---|---|---|
| attachment_id* | string | UUID of the attachment to delete. |
{
"type": "object",
"title": "delete_attachmentArguments",
"required": [
"attachment_id"
],
"properties": {
"attachment_id": {
"type": "string",
"title": "Attachment Id",
"description": "UUID of the attachment to delete."
}
}
}Delete a benchmark scenario and its stored results. Requires owner and a plan with benchmarks. No LLM call; inspect the scenario before deleting it.
| Argument | Type | Description |
|---|---|---|
| scenario_id* | string | UUID of the scenario to delete. |
{
"type": "object",
"title": "delete_benchmark_scenarioArguments",
"required": [
"scenario_id"
],
"properties": {
"scenario_id": {
"type": "string",
"title": "Scenario Id",
"description": "UUID of the scenario to delete."
}
}
}Delete a database registration and its queued deltas, stopping its feed. Requires owner and a sync-enabled plan; no LLM call. External replica tables remain untouched. Entity state and schema database flags remain by default; delete_entity_state and clear_database_model additionally remove data/model settings from schemas left with no registration. Obtain approval for those irreversible teardown options. See enricher://docs/database-sync.
| Argument | Type | Description |
|---|---|---|
| database_id* | string | Database sync UUID (from list_database_syncs). |
| delete_entity_state | boolean | Also hard-delete the stored entity state of the schemas left with no database (nothing writes to it anymore). Enrichment records are untouched. Irreversible. |
| clear_database_model | boolean | Also clear the database model those schemas carry (database_key, db_type, index, unique_group, shared, ordered, db_name/db_name_absolute, the classification ledger and the key-language lock), returning them to plain enrichment schemas. Implies delete_entity_state. Irreversible — a later re-link re-classifies from scratch. |
{
"type": "object",
"title": "delete_database_syncArguments",
"required": [
"database_id"
],
"properties": {
"database_id": {
"type": "string",
"title": "Database Id",
"description": "Database sync UUID (from list_database_syncs)."
},
"delete_entity_state": {
"type": "boolean",
"title": "Delete Entity State",
"default": false,
"description": "Also hard-delete the stored entity state of the schemas left with no database (nothing writes to it anymore). Enrichment records are untouched. Irreversible."
},
"clear_database_model": {
"type": "boolean",
"title": "Clear Database Model",
"default": false,
"description": "Also clear the database model those schemas carry (database_key, db_type, index, unique_group, shared, ordered, db_name/db_name_absolute, the classification ledger and the key-language lock), returning them to plain enrichment schemas. Implies delete_entity_state. Irreversible — a later re-link re-classifies from scratch."
}
}
}Soft-delete a saved schema by UUID. Requires editor; no LLM call. Restoration and permanent deletion are available in the web app, not through this tool. Returns the deletion outcome.
| Argument | Type | Description |
|---|---|---|
| schema_id* | string | UUID of the schema to delete. |
{
"type": "object",
"title": "delete_schemaArguments",
"required": [
"schema_id"
],
"properties": {
"schema_id": {
"type": "string",
"title": "Schema Id",
"description": "UUID of the schema to delete."
}
}
}Delete concepts selected by ids, concept_types or unused_only. Defaults to impact_only=true: review affected records, schemas and replicas before obtaining approval. Execution requires editor; clearing whole types requires owner. Deletion breaks convergence with IDs already stored in replicas; future resolution may mint new IDs. An unused-only deletion still removes that vocabulary. No LLM call. Returns impact counts or deletion results. See enricher://docs/semantic-ids.
| Argument | Type | Description |
|---|---|---|
| ids | any | Explicit concept semantic_ids to delete. |
| impact_only | boolean | True = report the blast radius only; False = delete. |
| unused_only | boolean | Only concepts no record references (usage 0). |
| concept_types | any | Scope to these concept types; without ids and unused_only this clears the whole types (owner role). |
{
"type": "object",
"title": "delete_semantic_conceptsArguments",
"properties": {
"ids": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Ids",
"default": null,
"description": "Explicit concept semantic_ids to delete."
},
"impact_only": {
"type": "boolean",
"title": "Impact Only",
"default": true,
"description": "True = report the blast radius only; False = delete."
},
"unused_only": {
"type": "boolean",
"title": "Unused Only",
"default": false,
"description": "Only concepts no record references (usage 0)."
},
"concept_types": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Concept Types",
"default": null,
"description": "Scope to these concept types; without ids and unused_only this clears the whole types (owner role)."
}
}
}Enrich one entity against exactly one of schema_id or target_schema, returning structured output, record_id, costs and any database outcome. Read get_schema's input_contract first (published version when linked); never invent preserve values. Models may be omitted for auto selection. Generation is billed. Two or more models fuse only when all succeed: check failed_models before reporting success. A failed leg prevents automatic fusion and database admission. classification_warning returns success=false, error_code and classification; bypass only after user confirmation. Database sync defaults on: report database.status and database_warning, including partial writes or overwrites; admission is not proof of replica delivery. Recovery and fusion: enricher://docs/enrichment-and-fusion. This tool does not expose web-search activation. With delegate_llm_calls=true the call returns the job status as soon as the first model call waits for you (llm_requests), or at the terminal state; a classification warning then pauses the job for answer_job_question instead of returning classification_warning.
| Argument | Type | Description |
|---|---|---|
| models | any | Model composite keys. Omit or pass ['auto'] for one automatically selected model; auto alone never fuses. Use list_models for explicit choices and model-count limits. |
| strategy | string | auto (default — server picks from the schema) | single_pass (simple schemas, 1 LLM call) | expert_domains (medium schemas with clear domains) | multi_expertise (large multi-domain schemas, parallel per-expertise calls — best quality, higher cost) |
| languages | any | ISO 639-1 codes; defaults to ['en'] server-side. The first language is the primary one used for all non-multilingual string fields; multilingual fields get one value per language. |
| schema_id | any |
Read the next ordered window of SQL deltas and canonical payloads for a database sync. claim=false is replayable; claim=true leases the window for 120 seconds. Apply a claimed window transactionally, including schema deltas, before ack_database_deltas. limit is also bounded by the registration's page_limit. snapshot_required pauses delivery until the replica reapplies its snapshot. No LLM call. Leasing, cursors, quarantine and snapshot handling: enricher://docs/database-sync.
| Argument | Type | Description |
|---|---|---|
| claim | boolean | Lease the window (requires ack). |
| limit | integer | |
| since | integer | Cursor: return deltas with id > since. |
| database_id* | string | Database sync UUID (from list_database_syncs). |
{
"type": "object",
"title": "fetch_database_deltasArguments",
"required": [
"database_id"
],
"properties": {
"claim": {
"type": "boolean",
"title": "Claim",
"default": false,
"description": "Lease the window (requires ack)."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 50,
"maximum": 500,
"minimum": 1
},
"since": {
"type": "integer",
"title": "Since",
"default": 0,
"minimum": 0,
"description": "Cursor: return deltas with id > since."
},
"database_id": {
"type": "string",
"title": "Database Id",
"description": "Database sync UUID (from list_database_syncs)."
}
}
}Generate editable sample JSON from a free-text request for schema authoring. Without attachments, use model knowledge and optional web search; with attachments, extract from the sources only (search does not relax that rule). Each sample is one instance in one language; set sample_count separately from request. Attachments force one sample. Requires editor; generation is billed. Returns a job_id and may already be paused or complete: relay pause questions through answer_job_question, otherwise poll get_job_status. Review returned samples and warnings before create_schema_from_sample; do not silently change facts or structure. For relationship modeling, multiple documents or hybrid extraction plus research, read enricher://docs/schema-from-sample and enricher://docs/documents.
| Argument | Type | Description |
|---|---|---|
| model | string | Auto (default) chooses the organization task model with attachment/search capabilities. Explicit provider::model bypasses this capability matching; provider combinations or quota may still fail. |
| request | string | Entity type, desired fields, scope and size/depth budget. Required without attachments; optional source-mode instructions otherwise. Put the number of instances in sample_count, not in this text. |
| language | any | Output language code for the generated field names AND values (e.g. 'en', 'fr'); an explicit code applies even when attachments are in another language. Omitted (default) → the generator follows the language the request is written in (its text and any typical object), else the attachment's, else English. |
| auto_answer | any | Omit or false to pause for clarification; true authorizes standard interpretations and planner defaults without asking, in either mode. |
Read one benchmark scenario with per-model quality, cost and speed results. include_reference=true adds the reference, the fixed entity_data and the schema-generation entity_samples. Config changes can make existing results stale. No LLM call. For a ranked subset use get_benchmark_scenario_results. Read after run_benchmark completes.
| Argument | Type | Description |
|---|---|---|
| scenario_id* | string | UUID of the scenario. |
| include_reference | boolean | Include reference_output + entity_data (can be large). |
{
"type": "object",
"title": "get_benchmark_scenarioArguments",
"required": [
"scenario_id"
],
"properties": {
"scenario_id": {
"type": "string",
"title": "Scenario Id",
"description": "UUID of the scenario."
},
"include_reference": {
"type": "boolean",
"title": "Include Reference",
"default": false,
"description": "Include reference_output + entity_data (can be large)."
}
}
}Filter, rank and limit a scenario's per-model benchmark results. No LLM call. overall blends quality, speed and cost using organization task weights and is null if a component is missing. Status tags are independent: success does not exclude stale or stale_score results. Missing sort metrics come last in either direction. See enricher://docs/model-benchmark for interpretation.
| Argument | Type | Description |
|---|---|---|
| limit | any | Keep only the top N after sorting (None = all). |
| status | any | Keep results carrying ANY of these tags: success | failed | stale (config_hash changed since this run, re-run it) | stale_score (reference/scoring config changed since scored, rescore it) | unscored (ran fine, never scored). Empty/None = every status. |
| sort_by | string | Metric to sort by. |
| providers | any | Keep only these provider names (empty/None = every provider). |
| model_keys | any | Keep only these model composite keys (empty/None = every model). |
| sort_order | string | Sort direction. |
| scenario_id* | string | UUID of the scenario. |
Return non-secret install, browser-confirmed pairing and run instructions for an ee-database sync client. Requires owner and a sync-enabled plan; no LLM call and no credential is issued or exposed to the MCP client. Run pair_command on the intended replica host: the CLI opens verification_url, the user chooses the database and confirms, and the credential travels directly to the polling CLI. Its DSN stays on that host. Use manual pairing only when managed host provisioning is not already handling the registration. Setup: enricher://docs/database-sync.
| Argument | Type | Description |
|---|---|---|
| database_id* | string | Database sync UUID (from list_database_syncs). |
{
"type": "object",
"title": "get_database_setup_instructionsArguments",
"required": [
"database_id"
],
"properties": {
"database_id": {
"type": "string",
"title": "Database Id",
"description": "Database sync UUID (from list_database_syncs)."
}
}
}List observed values outside each open enum's current vocabulary, with counts from recent enrichment records. No LLM call. Use the report to propose admitted members or rejected_values, or close a vocabulary only when it is exhaustive. This read does not edit the enum. An open enum allows other values; a closed one constrains output to its members. Named enums can be read with get_schema_part and changed through update_schema. See enricher://docs/schema-reference.
| Argument | Type | Description |
|---|---|---|
| schema_id* | string | UUID of the saved schema. |
{
"type": "object",
"title": "get_enum_candidatesArguments",
"required": [
"schema_id"
],
"properties": {
"schema_id": {
"type": "string",
"title": "Schema Id",
"description": "UUID of the saved schema."
}
}
}Read a job's status, progress and compact terminal summary with persisted record IDs. Status is pending, running, paused, completed, failed or cancelled. Relay pause questions with answer_job_question; answer a delegated job's llm_requests with answer_llm_request. include_result=true returns full terminal details; batch summaries count entities and database outcomes. A failed job is not usable output; inspect individual records for partial recovery. Unknown IDs may be invalid, expired or lost after restart: look for persisted outputs with list_records(job_id=...), without assuming success. events_after=<seq> adds the job's event log past that cursor (per-model completions, scoring progress, pauses) — the poll equivalent of the SSE stream; pass the returned last_seq next time. On a delegated job, llm_requests lists the pending model calls: the first complete, the rest as envelopes; llm_request_id=<id> returns that one complete. No LLM call. Polling, failure and recovery guidance: enricher://docs/enrichment-and-fusion.
| Argument | Type | Description |
|---|---|---|
| job_id* | string | Job ID returned by a start tool. |
| events_after | any | Event-log cursor: 0 returns the job's events from the start, a previous call's last_seq returns only the newer ones (at most 100 per call; events_has_more says when to call again). Omit to skip the log. |
| include_result | boolean | Include the full terminal result payload (can be large). Default returns a compact scalar summary per model. |
| llm_request_id | any | On a job delegating its LLM calls: return this pending request complete (messages, systemPrompt, tools, toolChoice, attachments) as the only entry of llm_requests. request_not_pending when it is no longer waiting. |
Read one persisted record's structured_output, entity_input_data, validation errors, expertise verdicts and metrics. failed_expertises and partial identify incomplete work even when output exists; use retry_expertises only on a record with failed domains. Fusion metadata identifies its source models and arbitration method. database_sync, when present, reports admission and per-replica delivery state. Returns record_url and the related schema link. No LLM call. Interpretation and recovery: enricher://docs/enrichment-and-fusion.
| Argument | Type | Description |
|---|---|---|
| record_id* | string | UUID of the record. |
{
"type": "object",
"title": "get_recordArguments",
"required": [
"record_id"
],
"properties": {
"record_id": {
"type": "string",
"title": "Record Id",
"description": "UUID of the record."
}
}
}Read a saved schema with its properties, annotations and input_contract. Before enrichment, use version='published' for a database-linked schema; default 'working' is for editing. identifying_keys guide entity naming; preserve values belong to the caller and are required; each supplied array item must carry its array_item_keys. Never invent caller-owned values. The response includes version, publish_state and schema_url. A requested published contract that does not exist returns not_found. For a small edit prefer get_schema_part. No LLM call. Contract details: enricher://docs/schema-reference.
| Argument | Type | Description |
|---|---|---|
| version | string | 'working' (default) — the editable copy updates/edits apply to; 'published' — the contract enrichment and database sync use (only meaningful for schemas linked to a database sync). |
| schema_id* | string | UUID of the saved schema. |
{
"type": "object",
"title": "get_schemaArguments",
"required": [
"schema_id"
],
"properties": {
"version": {
"type": "string",
"title": "Version",
"default": "working",
"description": "'working' (default) — the editable copy updates/edits apply to; 'published' — the contract enrichment and database sync use (only meaningful for schemas linked to a database sync)."
},
"schema_id": {
"type": "string",
"title": "Schema Id",
"description": "UUID of the saved schema."
}
}
}Read only the schema fragment needed for an edit. Omit path for the root/type index; use '$defs.X' or '$enums.X' for a definition, an object path for its subtree, or a leaf path for its property card and relations. Dot-separated paths use '[]' for array items. The response identifies shared definition usage, identity participation, database flags and whether entity state or linked databases exist. Editing a $defs property affects every usage site. Reads the working copy; no LLM call. Path examples: enricher://docs/schema-reference.
| Argument | Type | Description |
|---|---|---|
| path | any | Omit for the index; else a property/object path or '$defs.X'/'$enums.X'. |
| schema_id* | string | UUID of the saved schema. |
{
"type": "object",
"title": "get_schema_partArguments",
"required": [
"schema_id"
],
"properties": {
"path": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Path",
"default": null,
"description": "Omit for the index; else a property/object path or '$defs.X'/'$enums.X'."
},
"schema_id": {
"type": "string",
"title": "Schema Id",
"description": "UUID of the saved schema."
}
}
}Read one concept's aliases, identity source keys, linked records and nearest neighbors within its own type/model slice. Record links are capped; records_truncated signals omitted links. neighbors_limit=0 skips neighbors. Use returned alias IDs with update_concept_alias and similarities to assess a proposed merge. No LLM call. Never compare similarities across embedding spaces or concept types. See enricher://docs/semantic-ids.
| Argument | Type | Description |
|---|---|---|
| concept_id* | string | The concept's semantic_id (UUID). |
| neighbors_limit | integer |
{
"type": "object",
"title": "get_semantic_conceptArguments",
"required": [
"concept_id"
],
"properties": {
"concept_id": {
"type": "string",
"title": "Concept Id",
"description": "The concept's semantic_id (UUID)."
},
"neighbors_limit": {
"type": "integer",
"title": "Neighbors Limit",
"default": 50,
"maximum": 200,
"minimum": 0
}
}
}Read organization-wide record totals, success rate, tokens and cost summary. No LLM call. This tool has no job filter; use list_records(job_id=...) for a particular run and benchmark tools for comparative quality/cost/speed scores.
No arguments.
{
"type": "object",
"title": "get_statsArguments",
"properties": {}
}Resolve 1..1000 texts against one concept type. mint=false returns exact/matched/would_mint outcomes without minting; mint=true creates misses and requires owner (reporting requires editor). Resolution can call embeddings and the identity judge even in report mode. Review would_mint rows before authorizing creation. A new type may be initialized with embedding_model; existing types cannot switch spaces through import. Returns per-text outcomes. See enricher://docs/semantic-ids.
| Argument | Type | Description |
|---|---|---|
| mint | boolean | False = report only; True = create the unmatched rows (owner role). |
| texts* | array | Identity texts to resolve (1..1000). |
| judge_floor | any | Similarity at or above which a candidate is put to the identity judge. Omit to use the organization default (Settings → Organization). |
| concept_type* | string | Concept type (slice) to resolve against. |
| embedding_model | any | Composite key (provider::model) seeding a NEW concept type's slice — an import may open the type it resolves into. Refused when that type's vocabulary already lives in another model. |
{
"type": "object",
"title": "import_semantic_conceptsArguments",
"required": [
"texts",
"concept_type"
],
"properties": {
"mint": {
"type": "boolean",
"title": "Mint",
"default": false,
"description": "False = report only; True = create the unmatched rows (owner role)."
},
"texts": {
"type": "array",
"items": {
"type": "string"
},
"title": "Texts",
"description": "Identity texts to resolve (1..1000)."
},
"judge_floor": {
"anyOf": [
{
"type": "number",
"maximum": 1,
"minimum": 0
},
{
"type": "null"
}
],
"title": "Judge Floor",
"default": null,
"description": "Similarity at or above which a candidate is put to the identity judge. Omit to use the organization default (Settings → Organization)."
},
"concept_type": {
"type": "string",
"title": "Concept Type",
"description": "Concept type (slice) to resolve against."
},
"embedding_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Embedding Model",
"default": null,
"description": "Composite key (provider::model) seeding a NEW concept type's slice — an import may open the type it resolves into. Refused when that type's vocabulary already lives in another model."
}
}
}List compact benchmark scenario summaries and total. Scenarios test enrichment, sample generation or schema generation. No LLM call. Read one with get_benchmark_scenario or create one with create_benchmark_scenario. Lifecycle and reference requirements: enricher://docs/model-benchmark.
No arguments.
{
"type": "object",
"title": "list_benchmark_scenariosArguments",
"properties": {}
}List a saved schema's database registrations, linked schemas, options and sync hosts. Returns pending and quarantined delta counts, projection_upgrade_pending and database links. No LLM call. Pending zero alone does not prove healthy delivery: check quarantine and migration blockers. Use list_entity_states for server-side rows and get_record for per-record delivery state. PostgreSQL, MySQL and SQLite delivery is performed by the user's sync client. See enricher://docs/database-sync.
| Argument | Type | Description |
|---|---|---|
| schema_id* | string | Saved schema UUID. |
{
"type": "object",
"title": "list_database_syncsArguments",
"required": [
"schema_id"
],
"properties": {
"schema_id": {
"type": "string",
"title": "Schema Id",
"description": "Saved schema UUID."
}
}
}Browse a schema's current merged entity rows, not per-run records. Requires editor; no LLM call. Returns identities, revision, last_record_id and optionally payload, with limit/offset pagination. Rejected entities have no row; purge_entity_state may also remove delivered rows. Server-side state does not prove the external replica has applied its deltas. Use get_record and list_database_syncs for delivery and rejection diagnostics. See enricher://docs/database-sync.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer | |
| schema_id* | string | Saved schema UUID. |
| entity_type | any | Filter to one entity type (the response lists the types present). |
| include_payload | boolean | Include each entity's current merged payload. Set false for a compact identity-only listing (keys, revision, last_record_id). |
{
"type": "object",
"title": "list_entity_statesArguments",
"required": [
"schema_id"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20,
"maximum": 200,
"minimum": 1
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0,
"minimum": 0
},
"schema_id": {
"type": "string",
"title": "Schema Id",
"description": "Saved schema UUID."
},
"entity_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Entity Type",
"default": null,
"description": "Filter to one entity type (the response lists the types present)."
},
"include_payload": {
"type": "boolean",
"title": "Include Payload",
"default": true,
"description": "Include each entity's current merged payload. Set false for a compact identity-only listing (keys, revision, last_record_id)."
}
}
}List available model keys, nominal capabilities, languages, strategies, auto-selected defaults and organization profile_limits. Use when choosing explicit models or checking plan limits; ordinary calls may omit models or use auto without fetching this large catalogue. Auto also accounts for attachment capabilities. is_available means a usable provider key exists, not that provider quota or every combination of tools and media will work. Missing capability flags mean unsupported on this discovery surface. default_models_web_search is a search-only preview, not attachment-specific. No LLM call. Model selection and costs: enricher://docs/enrichment-and-fusion.
No arguments.
{
"type": "object",
"title": "list_modelsArguments",
"properties": {}
}List compact, paginated records in your organization, most recent first. Filter by job_id to retrieve persisted outputs of an asynchronous workflow; type, success, model and search further narrow the result. Both per-model enrichment and arbitration records may exist for one entity. Use get_record for full output and failures; use list_entity_states for current merged entity state instead of run history. No LLM call. Fetch every page when a job produces more than one page of records.
| Argument | Type | Description |
|---|---|---|
| page | integer | |
| model | any | Filter by model composite key (e.g. 'anthropic::claude-sonnet-4-6'). |
| job_id | any | Filter to a single job (every model + expertise in one batch shares one job_id). |
| search | any | Substring match against the entity's `name` field in the output. |
| success | any | True = only successful records; False = only failed. |
| page_size | integer | |
| record_type | any | Filter by type: enrichment | classification | arbitration | sample_generation | schema_generation | schema_edit | schema_annotation | ambiguity_analysis | db_classification | benchmark_scoring | playground |
List saved schemas in your organization, pinned first. Returns compact summaries with IDs, names and links; no LLM call. Use get_schema to inspect a chosen schema and its input contract, or get_schema_part for a targeted edit. For a database-linked schema, enrich against its published version; the working copy may contain unpublished changes.
No arguments.
{
"type": "object",
"title": "list_schemasArguments",
"properties": {}
}Browse organization concepts with aliases, usage counts and type/model facets. view='review' returns pairs escalated by the identity judge, not merely similar pairs. Returns a filtered page; use get_semantic_concept for details and neighbors. Similarities are comparable only within one concept_type/embedding_model slice. No LLM call. Vocabulary review and curation: enricher://docs/semantic-ids.
| Argument | Type | Description |
|---|---|---|
| view | string | 'concepts' = filtered concept page; 'review' = pairs the identity judge left for a person: escalated (unsure), found duplicated while answering another question, or separated at a similarity high enough to double-check. |
| limit | integer | |
| offset | integer | |
| search | any | Substring match against concept texts. |
| sort_by | string | ref_count | text | concept_type | created_at |
| sort_order | string | |
| concept_types | any | Restrict to these concept types (empty/None = every type). |
| min_ref_count | any |
Fuse two or more records of the same entity into a new arbitration record. Without arbitration_model use voting, median and union rules; with an arbiter, conflicts may incur LLM cost. Returns output, conflicts, fusion metadata and a new record ID. The merged result can feed linked databases and overwrite current entity values. Inspect database warnings and the actual fusion method; an arbiter failure can fall back to rules. Use this after separately recovered model runs, not to merge different entities. See enricher://docs/enrichment-and-fusion. With delegate_llm_calls=true and arbitration_model='auto', YOU arbitrate: the call returns the job status at its first pending request (answer_llm_request) or at the terminal state.
| Argument | Type | Description |
|---|---|---|
| result_ids* | array | UUIDs of the enrichment records to merge (minimum 2). |
| wait_seconds | integer | Delegated merges only: how long to wait for the first pending request or completion before returning. |
| attachment_ids | any | Attachments passed to the arbitration LLM (ignored for rule-based merges). |
| arbitration_model | any | Model composite key for LLM arbitration (None = rule-based). |
| delegate_llm_calls | boolean | Run the arbitration on YOUR model: pass arbitration_model='auto' and answer the pending requests with answer_llm_request; no credits are consumed. Plan feature. Protocol: enricher://docs/llm-delegation. |
Merge a loser concept into a winner. Defaults to impact_only=true: inspect counts and affected replicas before obtaining approval to execute. impact_only=false requires owner and rewrites aliases, entity identities and referencing payloads, queuing convergence to linked replicas. No LLM call. Similarity alone does not establish identity; inspect get_semantic_concept and the judge review evidence first. Returns impact or merge results. See enricher://docs/semantic-ids.
| Argument | Type | Description |
|---|---|---|
| loser_id* | string | semantic_id of the concept folded into the winner. |
| winner_id* | string | semantic_id of the concept that survives. |
| impact_only | boolean | True = report the merge's blast radius only; False = merge (owner role). |
{
"type": "object",
"title": "merge_semantic_conceptsArguments",
"required": [
"winner_id",
"loser_id"
],
"properties": {
"loser_id": {
"type": "string",
"title": "Loser Id",
"description": "semantic_id of the concept folded into the winner."
},
"winner_id": {
"type": "string",
"title": "Winner Id",
"description": "semantic_id of the concept that survives."
},
"impact_only": {
"type": "boolean",
"title": "Impact Only",
"default": true,
"description": "True = report the merge's blast radius only; False = merge (owner role)."
}
}
}Inspect or migrate the organization's concept embedding space. action='status' is read-only; preview, start and cancel require owner. preview estimates cost and reports potential collisions; review them before authorizing start. target_model is required for preview/start; source_model and concept_types scope the move. Starting launches billed background re-embedding while enrichment continues, then switches the selected slices after coverage is complete. Cancel marks the transition cancelled; it does not guarantee interruption or rollback of in-flight work. Returns migration status or preview. See enricher://docs/semantic-ids.
| Argument | Type | Description |
|---|---|---|
| action* | string | status | preview | start | cancel |
| source_model | any | Embedding space to move; omitted = the org's current default. |
| target_model | any | Composite key (provider::model) to move to. Required for preview/start. |
| concept_types | any | Restrict the move to these concept types; empty = the whole space. |
{
"type": "object",
"title": "migrate_semantic_embeddingsArguments",
"required": [
"action"
],
"properties": {
"action": {
"enum": [
"status",
"preview",
"start",
"cancel"
],
"type": "string",
"title": "Action",
"description": "status | preview | start | cancel"
},
"source_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Model",
"default": null,
"description": "Embedding space to move; omitted = the org's current default."
},
"target_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Target Model",
"default": null,
"description": "Composite key (provider::model) to move to. Required for preview/start."
},
"concept_types": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Concept Types",
"default": null,
"description": "Restrict the move to these concept types; empty = the whole space."
}
}
}Move one property into the root, an object path or '$defs.X', preserving its flags and expertise. Requires editor; no LLM call. Moving into a definition changes every usage site. An identity composition naming the property is re-spelled automatically when the destination stays within the same 1-1 closure (identity_rebound reports it); the move is refused when it would take the key out of that closure or leave a semantic ID with no identity material, and on collisions or recursive containment. Read source and destination with get_schema_part first. Structural changes on database-linked schemas require publish_schema. Paths and migration guidance: enricher://docs/schema-reference.
| Argument | Type | Description |
|---|---|---|
| path* | string | Property path, e.g. 'ceremonies[].ceremony_type'. |
| schema_id* | string | UUID of the saved schema. |
| new_parent_path | string | '' = root, or an object path / '$defs.X'. |
{
"type": "object",
"title": "move_schema_propertyArguments",
"required": [
"schema_id",
"path"
],
"properties": {
"path": {
"type": "string",
"title": "Path",
"description": "Property path, e.g. 'ceremonies[].ceremony_type'."
},
"schema_id": {
"type": "string",
"title": "Schema Id",
"description": "UUID of the saved schema."
},
"new_parent_path": {
"type": "string",
"title": "New Parent Path",
"default": "",
"description": "'' = root, or an object path / '$defs.X'."
}
}
}Materialize an entity region from get_schema's x-entityMap. Ordinary flat members (e.g. product_id, product_name on an order line) move into a new object named after the region, regions hanging from it move along (nest them in turn inside the new object), pairing facts stay on the host, and the moved names shed the region's tokens (product_name → name) unless strip_prefix=false. A pairing region nests the same way: its pair facts gather into a pairing object with the entity hanging from it (series_volume → series_engagement.volume beside book_series). Compact scalar occurrences (e.g. manufacturer_name or each therapeutic_classes[] item) are all converted to references to one shared $defs entity; host_path and strip_prefix do not apply to that form. If the schema already uses semantic IDs, the created object gets one when generation's gates allow (keyed, not only by exact values, not a pairing); no other object changes. host_path is '' for the root, an object path, 'path[]' for an array's items, or '$defs.X'. Defaults to dry_run=true: inspect the returned schema_content and notes, then persist with dry_run=false only after approval of the change. Requires editor; no LLM call. Database-linked structural edits still require publish_schema. Modeling consequences: enricher://docs/schema-reference.
| Argument | Type | Description |
|---|---|---|
| dry_run | boolean | Report the rewrite without persisting it (the default). |
| host_path | string | Container holding the flat members ('' = root, object path, 'path[]', '$defs.X'). |
| region_id* | string | Entity region id from x-entityMap.regions (get_schema). |
| schema_id |
Preview identity resolution without adding a concept or increasing its usage. Requires editor; uncached resolution may call embeddings and the identity judge. Returns exact_hit, match or no_match, the matched concept and neighbors. Probe before adding; a matched incumbent may already represent the intended entity. embedding_model can select the space for a new concept type, not change an existing type's space. Inspect judge evidence as well as similarity. See enricher://docs/semantic-ids.
| Argument | Type | Description |
|---|---|---|
| text* | string | The identity text to resolve. |
| neighbors | integer | |
| judge_floor | any | Similarity at or above which a candidate is put to the identity judge. Omit to use the organization default (Settings → Organization). |
| concept_type* | string | Concept type (slice) to resolve against. |
| embedding_model | any | Composite key (provider::model) to embed a NEW concept type under. |
{
"type": "object",
"title": "probe_semantic_conceptArguments",
"required": [
"text",
"concept_type"
],
"properties": {
"text": {
"type": "string",
"title": "Text",
"description": "The identity text to resolve."
},
"neighbors": {
"type": "integer",
"title": "Neighbors",
"default": 10,
"maximum": 200,
"minimum": 1
},
"judge_floor": {
"anyOf": [
{
"type": "number",
"maximum": 1,
"minimum": 0
},
{
"type": "null"
}
],
"title": "Judge Floor",
"default": null,
"description": "Similarity at or above which a candidate is put to the identity judge. Omit to use the organization default (Settings → Organization)."
},
"concept_type": {
"type": "string",
"title": "Concept Type",
"description": "Concept type (slice) to resolve against."
},
"embedding_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Embedding Model",
"default": null,
"description": "Composite key (provider::model) to embed a NEW concept type under."
}
}
}Publish a database-linked schema's working copy as the contract used by enrichment and replicas. A newly linked schema sends nothing until first publication; unlinked drafts cannot be published. Requires editor; no LLM call. Call validate_only=true to inspect the diff, blockers, warnings and per-database migration_sql. Transform migrations require user-approved confirm_transforms=true; cross-schema conflicts remain blockers. key_language may be required if classification revealed a multilingual key. Returns publication state; queued migrations apply asynchronously on replicas. See enricher://docs/database-sync for the review and delivery workflow.
| Argument | Type | Description |
|---|---|---|
| schema_id* | string | UUID of the schema to publish. |
| key_language | any | ISO 639-1 language for multilingual identity tokens. Normally adopted from the database lock. Supply when key_language_required requests a choice; review the suggested language with the user. Shared by all schemas of that database. |
| validate_only | boolean | Dry-run: return the diff + blockers without publishing. |
| confirm_transforms | boolean | Acknowledge a transform migration (re-key, type change, or a column/table rename) run against the replicas' own data. Required when the preview says requires_confirm — ALWAYS show the transforms to the user and get their explicit approval before passing true. |
{
"type": "object",
"title": "publish_schemaArguments",
"required": [
"schema_id"
],
"properties": {
"schema_id": {
"type": "string",
"title": "Schema Id",
"description": "UUID of the schema to publish."
},
"key_language": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Key Language",
"default": null,
"description": "ISO 639-1 language for multilingual identity tokens. Normally adopted from the database lock. Supply when key_language_required requests a choice; review the suggested language with the user. Shared by all schemas of that database."
},
"validate_only": {
"type": "boolean",
"title": "Validate Only",
"default": false,
"description": "Dry-run: return the diff + blockers without publishing."
},
"confirm_transforms": {
"type": "boolean",
"title": "Confirm Transforms",
"default": false,
"description": "Acknowledge a transform migration (re-key, type change, or a column/table rename) run against the replicas' own data. Required when the preview says requires_confirm — ALWAYS show the transforms to the user and get their explicit approval before passing true."
}
}
}Resolve one pending entity-type unification proposal from get_schema. action='accept' maps the proposed site onto the winning $def; field_map overrides proposed correspondences. Unmapped fields are retained as nullable; other usages of the winning definition are affected. action='dismiss' keeps the sites separate. Defaults to dry_run=true: inspect the returned schema_content and notes, then persist with dry_run=false only after approval of the change. Requires editor; no LLM call. Database-linked structural edits still require publish_schema. Modeling consequences: enricher://docs/schema-reference.
| Argument | Type | Description |
|---|---|---|
| action* | string | 'accept' or 'dismiss'. |
| dry_run | boolean | Report the rewrite without persisting it (the default). |
| field_map | any | accept only: override of the loser→winner field correspondence. |
| schema_id* | string | UUID of the saved schema. |
| proposal_id* | string | Proposal id from x-entityMap.proposals (get_schema). |
{
"type": "object",
"title": "resolve_unify_proposalArguments",
"required": [
"schema_id",
"proposal_id",
"action"
],
"properties": {
"action": {
"type": "string",
"title": "Action",
"description": "'accept' or 'dismiss'."
},
"dry_run": {
"type": "boolean",
"title": "Dry Run",
"default": true,
"description": "Report the rewrite without persisting it (the default)."
},
"field_map": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Field Map",
"default": null,
"description": "accept only: override of the loser→winner field correspondence."
},
"schema_id": {
"type": "string",
"title": "Schema Id",
"description": "UUID of the saved schema."
},
"proposal_id": {
"type": "string",
"title": "Proposal Id",
"description": "Proposal id from x-entityMap.proposals (get_schema)."
}
}
}Retry only an existing record's failed expertise domains, then update its output and attempt the run's fusion/synchronization. Billed for retried work. Requires failed_expertises on that record (get_record); a surviving successful sibling is not retryable and returns no_failed_expertises. Supply its entity_input_data and saved_schema_id; model optionally substitutes the failed model. Returns job_id: poll get_job_status, then re-read get_record. When the failed leg left no record, use a one-model enrich_entity with database_sync=false followed by merge_records instead. Recovery decisions: enricher://docs/enrichment-and-fusion.
| Argument | Type | Description |
|---|---|---|
| model | any | Model to retry with (provider::model from list_models). Defaults to the record's own model — pass a stronger one when a domain fails repeatedly on it (retrying the same model that just failed usually fails again). Only the failed domains are re-run and re-billed; the record stays attributed to its original model. |
| languages | any | ISO 639-1 codes; defaults to ['en']. |
| record_id* | string | Enrichment record with failed expertises. |
| schema_id | any | Saved schema UUID (get_record -> saved_schema_id). Or pass target_schema. |
| entity_data* | object | The record's original entity input (get_record -> entity_input_data). |
| target_schema | any | Raw schema dict when no saved schema exists. |
Undo automatic edits a scoring pass made to a scenario's reference. Every scoring pass folds what the scored models showed the reference should be (a candidate the judge found better, a rule the samples prove, a value the reference lacked) and writes it into the reference — an edit a pass already made is only replaced by stronger evidence (samples, a wrong verdict, more agreeing models), never by one more model's better verdict; the log is reference_meta.auto_applied on get_benchmark_scenario, each entry with its inverse patch. Pass the revision ids to undo: the inverse is applied, the entry is marked reverted and its (path, attribute) is pinned so no later pass re-applies it (a manual set_benchmark_reference lifts every pin). Scores never go stale from this. Requires owner and a plan with benchmarks. No LLM call.
| Argument | Type | Description |
|---|---|---|
| scenario_id* | string | UUID of the scenario. |
| revision_ids* | array | Ids of the reference_meta.auto_applied entries to undo (1..200). |
{
"type": "object",
"title": "revert_benchmark_reference_updatesArguments",
"required": [
"scenario_id",
"revision_ids"
],
"properties": {
"scenario_id": {
"type": "string",
"title": "Scenario Id",
"description": "UUID of the scenario."
},
"revision_ids": {
"type": "array",
"items": {
"type": "string"
},
"title": "Revision Ids",
"description": "Ids of the reference_meta.auto_applied entries to undo (1..200)."
}
}
}Start billed asynchronous execution and scoring of a benchmark. Requires owner, a benchmark-enabled plan and a judge; a verified reference is also required except for sample generation. Supply model_keys or providers; omitting both runs all active models with usable provider keys. Repetitions and judging increase cost. Returns job_id and total_models: poll get_job_status, then read get_benchmark_scenario_results. Re-running replaces each selected model's previous result. An organization's benchmark runs and scoring passes execute one at a time: a launch while another is in flight is queued (queue_position, status 'pending'), and a launch on a scenario whose run is still queued folds its models into that run (merged=true, job_id names the queued run). Reference setup and score interpretation: enricher://docs/model-benchmark.
| Argument | Type | Description |
|---|---|---|
| providers | any | Provider names (e.g. ['anthropic', 'mistral']) — runs every active model of those providers that has a valid key. |
| model_keys | any | Explicit model composite keys. Overrides `providers`. |
| scenario_id* | string | UUID of the scenario to run. |
{
"type": "object",
"title": "run_benchmarkArguments",
"required": [
"scenario_id"
],
"properties": {
"providers": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Providers",
"default": null,
"description": "Provider names (e.g. ['anthropic', 'mistral']) — runs every active model of those providers that has a valid key."
},
"model_keys": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Model Keys",
"default": null,
"description": "Explicit model composite keys. Overrides `providers`."
},
"scenario_id": {
"type": "string",
"title": "Scenario Id",
"description": "UUID of the scenario to run."
}
}
}Save a directly authored schema and return its ID and link. Requires editor; no LLM call or generation charge. schema_content is a JSON Schema 2020-12 document in Entity Enricher's supported dialect: title, type='object', properties, optional $defs and x-* extension sections. The server validates it and makes colliding names unique. Entity definitions, enum vocabularies and localized fields have different projection rules. Unknown keywords are dropped, not rejected: read ignored_keywords (path, keyword, hint) and applied_repairs in the result — a property flag such as semantic_id placed on a $defs entity object lands there, with the level it is read at. Use create_schema_from_sample to derive a schema from data, or update_schema for an existing schema. A minimal valid example and supported annotations are in enricher://docs/schema-reference.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| tags | any | Optional tags. |
| is_pinned | boolean | Pin it to the top of listings. |
| schema_content* | object | Full schema document: title, type=object, properties and optional $defs/x-* sections. See enricher://docs/schema-reference for a minimal example. |
{
"type": "object",
"title": "save_schemaArguments",
"required": [
"name",
"schema_content"
],
"properties": {
"name": {
"type": "string",
"title": "Name",
"maxLength": 255,
"minLength": 1
},
"tags": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Tags",
"default": null,
"description": "Optional tags."
},
"is_pinned": {
"type": "boolean",
"title": "Is Pinned",
"default": false,
"description": "Pin it to the top of listings."
},
"schema_content": {
"type": "object",
"title": "Schema Content",
"description": "Full schema document: title, type=object, properties and optional $defs/x-* sections. See enricher://docs/schema-reference for a minimal example.",
"additionalProperties": true
}
}
}Save the gold reference for an enrichment or schema-generation benchmark. Only set reference_verified=true after checking its values against trusted evidence or obtaining human sign-off; a generated answer alone is not verification. Schema-generation references must be GeneratedJsonSchema objects. Sample-generation scenarios reject references because they are rubric-scored. Requires owner and a plan with benchmarks; no LLM call. A verified reference enables run_benchmark. See enricher://docs/model-benchmark.
| Argument | Type | Description |
|---|---|---|
| source | any | Provenance: generated | pasted | record (default 'pasted'). |
| scenario_id* | string | UUID of the scenario. |
| reference_output* | object | Expected entity JSON for enrichment, or a schema document for schema_generation. Sample-generation scenarios do not accept a reference. |
| source_record_id | any | Record UUID the reference was copied from (when source='record'). |
| reference_verified | boolean | Explicit sign-off that the reference is correct (required to run). |
{
"type": "object",
"title": "set_benchmark_referenceArguments",
"required": [
"scenario_id",
"reference_output"
],
"properties": {
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source",
"default": null,
"description": "Provenance: generated | pasted | record (default 'pasted')."
},
"scenario_id": {
"type": "string",
"title": "Scenario Id",
"description": "UUID of the scenario."
},
"reference_output": {
"type": "object",
"title": "Reference Output",
"description": "Expected entity JSON for enrichment, or a schema document for schema_generation. Sample-generation scenarios do not accept a reference.",
"additionalProperties": true
},
"source_record_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Record Id",
"default": null,
"description": "Record UUID the reference was copied from (when source='record')."
},
"reference_verified": {
"type": "boolean",
"title": "Reference Verified",
"default": false,
"description": "Explicit sign-off that the reference is correct (required to run)."
}
}
}Start billed asynchronous enrichment of an entity list against exactly one of schema_id or target_schema. Returns job_id and total. No fixed entity-count cap; live prompt quotas and credits can stop remaining work. Each entity follows the enrichment/fusion pipeline; every model must succeed for its automatic fusion and database admission. A confident classification mismatch skips that entity without enrichment, never pauses the batch. Poll get_job_status, then list_records(job_id=...). Attachments apply to every entity. Unlike enrich_entity, this tool exposes neither database_sync=false nor web-search activation. Input contracts, partial results and recovery: enricher://docs/batch-enrichment.
| Argument | Type | Description |
|---|---|---|
| models | any | Model composite keys (call list_models to discover them). Optional: omit (or pass ['auto']) to let the server pick the org's default model — pinned per-task default if set, else the best blended benchmark score. |
| entities* | array | Entities to enrich (each a free-form dict naming the entity — the schema's identifying fields ideally, but any field names work). |
| strategy | string | auto (default) | single_pass | expert_domains | multi_expertise |
| languages | any | ISO 639-1 codes; defaults to ['en']. |
| schema_id | any | UUID of a saved schema. Mutually exclusive with target_schema. |
| target_schema | any | Inline schema document in the supported Entity Enricher dialect. Prefer schema_id to link records. See enricher://docs/schema-reference. |
Validate and inject stored or supplied enrichment output into the entity layer and linked syncs. May incur semantic-resolution cost. record_id alone reuses its output; adding structured_output creates a new derived record. Without record_id, supply structured_output and saved_schema_id. Each item uses the current published contract and admission gate. Only enrichment/arbitration records qualify; base records whose fusion is in the same request are skipped. Inspect each outcome for rejected or partial writes. Use after fixing a rejected output or an enrich_entity run with database_sync=false. See enricher://docs/enrichment-and-fusion.
| Argument | Type | Description |
|---|---|---|
| items* | array | Entities to inject. Each item: {record_id?, structured_output?, saved_schema_id?} — at least one of record_id / structured_output, and saved_schema_id required when there is no record_id. |
{
"type": "object",
"title": "sync_records_to_databaseArguments",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"title": "Items",
"maxItems": 100,
"minItems": 1,
"description": "Entities to inject. Each item: {record_id?, structured_output?, saved_schema_id?} — at least one of record_id / structured_output, and saved_schema_id required when there is no record_id."
}
}
}Edit a benchmark's test definition or scoring configuration. Requires owner and a plan with benchmarks; no model run. Only supplied fields change, but sample_params and schema_gen_params replace their parameter objects wholesale. The judge may be replaced, not cleared; scenario_type is immutable. Changed test definitions make previous results stale. Re-run affected models to refresh their scores. See enricher://docs/model-benchmark.
| Argument | Type | Description |
|---|---|---|
| name | any | |
| strategy | any | |
| languages | any | |
| schema_id | any | New saved-schema UUID. |
| description | any | Free-text note shown in the Benchmarks tab; no model ever reads it. |
| entity_data | any | Enrichment: replacement fixed entity input (same contract as enrich_entity's entity_data; refused when it carries no value). |
| repetitions | any | |
| scenario_id* | string | UUID of the scenario. |
Remove or promote a concept alias using alias IDs from get_semantic_concept. Requires editor; no LLM call. action='remove' stops that surface form resolving to this concept; removing the last alias is refused. action='set_canonical' changes its displayed form. To add an alias use add_semantic_concept(alias_of=...). Returns the outcome. See enricher://docs/semantic-ids.
| Argument | Type | Description |
|---|---|---|
| action* | string | 'remove' prunes the surface form; 'set_canonical' promotes it. |
| alias_id* | string | The surface-form row's own id (UUID). |
| concept_id* | string | The concept's semantic_id (UUID). |
{
"type": "object",
"title": "update_concept_aliasArguments",
"required": [
"concept_id",
"alias_id",
"action"
],
"properties": {
"action": {
"enum": [
"remove",
"set_canonical"
],
"type": "string",
"title": "Action",
"description": "'remove' prunes the surface form; 'set_canonical' promotes it."
},
"alias_id": {
"type": "string",
"title": "Alias Id",
"description": "The surface-form row's own id (UUID)."
},
"concept_id": {
"type": "string",
"title": "Concept Id",
"description": "The concept's semantic_id (UUID)."
}
}
}Edit a saved schema's metadata or replace its full schema_content without an LLM call. Requires editor. Only supplied values change. For one property, prefer update_schema_property, add_schema_property or move_schema_property. Replacements must use GeneratedJsonSchema; unknown keywords are dropped, not rejected, and reported in ignored_keywords / applied_repairs. On database-linked schemas this edits the working copy: neutral edits propagate automatically; structural edits take effect after publish_schema. Returns the updated schema and link. Contract and edit workflow: enricher://docs/schema-reference.
| Argument | Type | Description |
|---|---|---|
| name | any | New name (must be unique). |
| tags | any | Replacement tag list. |
| is_pinned | any | Pin or unpin. |
| schema_id* | string | UUID of the schema to update. |
| key_language | any | Pre-set the key language for multilingual database keys ahead of a database link (ISO 639-1). Settable only while the schema has no linked database and no entity state; locked afterwards. |
| schema_content | any | Full replacement schema document, following get_schema.schema_content. See enricher://docs/schema-reference. |
| ambiguity_check_enabled |
Edit or remove one property by path without replacing the full schema. Requires editor; no LLM call. Only supplied fields change; null clears an entry in flags. Server validation rejects or normalizes invalid combinations and reports applied_repairs. Editing inside $defs affects every usage site. Removing an identity-source member is refused until its identity is recomposed. Renames preserve identity references and record migration intent. Database-linked schemas remain working-copy edits until publish_schema; inspect migration_grade. For additions or relocation use add_schema_property or move_schema_property. Paths, flags and rename rules: enricher://docs/schema-reference.
| Argument | Type | Description |
|---|---|---|
| ref | any | '#/$defs/X' or '#/$enums/X'; clears type. |
| path* | string | Property path, e.g. 'ceremonies[].ceremony_type'. |
| type | any | New JSON type (string/number/integer/boolean/array/object); clears $ref. |
| flags | any | Flag updates (null clears): expertise, preserve, multilingual, language_discriminator, identifying, nullable, format, pattern, semantic_id, judge_floor, semantic_concept_type, semantic_embedding_model, database_key, db_type, db_type_length, index, unique_group, shared, ordered, db_name, db_name_absolute. |
| remove | boolean | Delete the property instead. |
| examples |
Upload base64 file bytes as reusable source material; returns id and requires_capability. Pass the ID in attachment_ids to sample/schema generation, enrichment or benchmarks. Supported format handling depends on server MIME policy: extracted text or model-readable binary. Prefer auto model selection for attachment capabilities. Uploading does not itself run an LLM. A generated sample with attachments is source-only; see enricher://docs/documents for formats, multiple-file behavior and research workflows. Retain attachments needed for later runs or regeneration.
| Argument | Type | Description |
|---|---|---|
| filename* | string | Original filename including extension (e.g. 'report.pdf'). |
| media_type | any | Optional MIME hint; the server still sniffs the magic bytes. |
| content_base64* | string | The file's bytes, base64-encoded (no data: prefix). |
{
"type": "object",
"title": "upload_attachmentArguments",
"required": [
"filename",
"content_base64"
],
"properties": {
"filename": {
"type": "string",
"title": "Filename",
"minLength": 1,
"description": "Original filename including extension (e.g. 'report.pdf')."
},
"media_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Media Type",
"default": null,
"description": "Optional MIME hint; the server still sniffs the magic bytes."
},
"content_base64": {
"type": "string",
"title": "Content Base64",
"description": "The file's bytes, base64-encoded (no data: prefix)."
}
}
}{
"type": "object",
"title": "answer_llm_requestArguments",
"required": [
"job_id",
"request_id",
"response"
],
"properties": {
"job_id": {
"type": "string",
"title": "Job Id",
"description": "Job whose llm_requests you are answering."
},
"response": {
"type": "object",
"title": "Response",
"description": "MCP CreateMessageResult: role 'assistant', model (your model's name), stopReason, content (one block or a list of text / tool_use blocks); optional usage {input_tokens, output_tokens}.",
"additionalProperties": true
},
"request_id": {
"type": "string",
"title": "Request Id",
"description": "The request_id of the entry you answer."
},
"wait_seconds": {
"type": "integer",
"title": "Wait Seconds",
"default": 120,
"maximum": 600,
"minimum": 0,
"description": "How long to wait for the job's next pending request, pause or completion before returning (0 = return right after handing over the answer)."
}
}
}| any |
| Enrichment (required there): the fixed entity input every model enriches — the same JSON enrich_entity takes. Read get_schema.input_contract first: identifying fields, preserve paths and keys for supplied array items. Refused when it carries no value. |
| repetitions | integer | Run each model N times per run; keeps mean + consistency spread. |
| scenario_type | string | enrichment | sample_generation | schema_generation (immutable). |
| attachment_ids | any | Attachment UUIDs included in every run. |
| entity_samples | any | schema_generation: the 1..20 fixed input samples (JSON objects of one entity type) every model converts to a schema. Several samples let the scoring read evidence the reference cannot state alone (nullable, types, identity). |
| sample_request | any | sample_generation: the free-text sample request every model answers — the kind of entity, what the sample must contain, any budget or structural preference (same contract as generate_sample's request). |
| typical_object | any | sample_generation: a specific instance to model (e.g. 'Serena Williams'). |
| enable_web_search | boolean | sample_generation: ground values with the model's web search. |
| naming_convention | string | sample_generation: auto | snake_case | camelCase. |
| generate_semantic_ids | boolean | schema_generation: add semantic_id properties to keyed objects. |
| scoring_judge_model_key* | string | LLM judge composite key used to score results (required). |
{
"type": "object",
"title": "create_benchmark_scenarioArguments",
"required": [
"name",
"scoring_judge_model_key"
],
"properties": {
"name": {
"type": "string",
"title": "Name",
"maxLength": 255,
"minLength": 1
},
"language": {
"type": "string",
"title": "Language",
"default": "en",
"description": "sample_generation: output language for names + values."
},
"strategy": {
"type": "string",
"title": "Strategy",
"default": "single_pass",
"description": "Enrichment: pinned strategy (no 'auto'): single_pass | expert_domains | multi_expertise"
},
"languages": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Languages",
"default": null,
"description": "Enrichment: defaults to ['en']."
},
"schema_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Schema Id",
"default": null,
"description": "UUID of the saved schema to enrich against (enrichment only, required there)."
},
"description": {
"anyOf": [
{
"type": "string",
"maxLength": 2000
},
{
"type": "null"
}
],
"title": "Description",
"default": null,
"description": "Free-text note shown in the Benchmarks tab; no model ever reads it. The entity to enrich goes in entity_data, never here."
},
"entity_data": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Entity Data",
"default": null,
"description": "Enrichment (required there): the fixed entity input every model enriches — the same JSON enrich_entity takes. Read get_schema.input_contract first: identifying fields, preserve paths and keys for supplied array items. Refused when it carries no value."
},
"repetitions": {
"type": "integer",
"title": "Repetitions",
"default": 2,
"maximum": 3,
"minimum": 1,
"description": "Run each model N times per run; keeps mean + consistency spread."
},
"scenario_type": {
"type": "string",
"title": "Scenario Type",
"default": "enrichment",
"description": "enrichment | sample_generation | schema_generation (immutable)."
},
"attachment_ids": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Attachment Ids",
"default": null,
"description": "Attachment UUIDs included in every run."
},
"entity_samples": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Entity Samples",
"default": null,
"description": "schema_generation: the 1..20 fixed input samples (JSON objects of one entity type) every model converts to a schema. Several samples let the scoring read evidence the reference cannot state alone (nullable, types, identity)."
},
"sample_request": {
"anyOf": [
{
"type": "string",
"maxLength": 4000
},
{
"type": "null"
}
],
"title": "Sample Request",
"default": null,
"description": "sample_generation: the free-text sample request every model answers — the kind of entity, what the sample must contain, any budget or structural preference (same contract as generate_sample's request)."
},
"typical_object": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Typical Object",
"default": null,
"description": "sample_generation: a specific instance to model (e.g. 'Serena Williams')."
},
"enable_web_search": {
"type": "boolean",
"title": "Enable Web Search",
"default": false,
"description": "sample_generation: ground values with the model's web search."
},
"naming_convention": {
"type": "string",
"title": "Naming Convention",
"default": "auto",
"description": "sample_generation: auto | snake_case | camelCase."
},
"generate_semantic_ids": {
"type": "boolean",
"title": "Generate Semantic Ids",
"default": false,
"description": "schema_generation: add semantic_id properties to keyed objects."
},
"scoring_judge_model_key": {
"type": "string",
"title": "Scoring Judge Model Key",
"description": "LLM judge composite key used to score results (required)."
}
}
}| schema_id* | string | Saved schema UUID to connect the database to. |
| pk_strategy | string | surrogate (default): physical surrogate IDs with unique schema keys; natural: use schema keys as physical primary keys and restrict later re-keying. Locks once the physical model ships; decide before publication. See enricher://docs/database-sync. |
| target_host | any | Sync host (id or name) that should provision and sync this registration automatically (managed ee-database mode). Omitted: auto-assigned when exactly one eligible host is connected; otherwise the response's connected_hosts lists the candidates — relay the choice to the user and call assign_sync_host, or fall back to get_database_setup_instructions for browser-confirmed manual pairing. |
| key_language | any | Language of multilingual identity tokens (ISO 639-1), shared by all schemas of this database. Usually defaults to schema language when needed; publication may request it after classification. Locked once chosen for the database. |
| purge_on_ack | boolean | Delete delivered delta copies once acknowledged. |
| index_scalars | string | none: identity/feed indexes; keys: add natural keys and relation access paths; filterable (default): add dates, search intent, spatial/range roles and entity query indexes; all: every scalar. Later changes queue index migrations. |
| notify_debounce_s | integer | Quiet period (seconds) before a delta-available notification fires: each new delta resets the timer, so a burst is announced once. Default 5 for MCP callers (agent workflows expect near-immediate reaction); the web app defaults to 30 to coalesce human-scale editing bursts. |
| delegate_llm_calls | boolean | Run the registration's classification pass on YOUR model: its calls come back as pending requests on classification_job_id, to answer with answer_llm_request; no credits are consumed. Plan feature. Protocol: enricher://docs/llm-delegation. |
| propagate_not_null | any | Mirror required schema fields as SQL NOT NULL. Omitted: on for strict gap policies, off for accept_partial. True with accept_partial is refused. Later tightening requires validating existing replica rows; violations can quarantine the migration. |
| purge_entity_state | boolean | Delete fully delivered entity state after every linked database acknowledges it. Transfers custody to replicas, makes server snapshots incomplete and limits duplicate checks. Relay custody_warning and obtain agreement before enabling. Default false. |
| purge_on_ack_delay_days | any | Grace period for purge_on_ack: keep acknowledged delta copies this many days (from acknowledgement) before the hourly purge deletes them. Omit to delete them at acknowledgement. Bounded by the plan's delta retention ceiling. |
| pattern_index_localized_keys | boolean | Add per-language pattern-match indexes on indexed localized keys/labels (default false). Useful for prefix autocomplete; increases write/index cost. Concrete SQL depends on the selected dialect. |
| purge_entity_state_delay_days | any | Grace period for purge_entity_state: a fully-delivered entity row is kept until it has gone this many days without an update, then the hourly purge deletes it. Omit to delete it as soon as every database of the schema acknowledged it. |
{
"type": "object",
"title": "create_database_syncArguments",
"required": [
"schema_id",
"name"
],
"properties": {
"name": {
"type": "string",
"title": "Name",
"maxLength": 255,
"minLength": 1,
"description": "Name of the physical database (existing on the user's server, or created by `ee-database run --create-missing`); shared by every schema linked to this database sync. Also used (snake-cased) as the conventional replica database name by the ee-database CLI."
},
"dialect": {
"type": "string",
"title": "Dialect",
"default": "postgres",
"description": "SQL dialect the deltas are rendered in: postgres | mysql | sqlite."
},
"on_gaps": {
"type": "string",
"title": "On Gaps",
"default": "skip_children",
"description": "Admission gate — what is written when an enrichment has gaps (non-nullable fields unfilled). 'reject_entity': nothing — one gap anywhere refuses the whole enrichment. 'skip_children' (default): the entity without its incomplete children — an array item is dropped, a shared 1-1 reference is detached (child not written, parent's foreign key NULL); gaps with no such child above them still reject. 'accept_partial': everything — gaps land as NULLs, and under last-write-wins a later partial run erases what an earlier one filled."
},
"schema_id": {
"type": "string",
"title": "Schema Id",
"description": "Saved schema UUID to connect the database to."
},
"pk_strategy": {
"type": "string",
"title": "Pk Strategy",
"default": "surrogate",
"description": "surrogate (default): physical surrogate IDs with unique schema keys; natural: use schema keys as physical primary keys and restrict later re-keying. Locks once the physical model ships; decide before publication. See enricher://docs/database-sync."
},
"target_host": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Target Host",
"default": null,
"description": "Sync host (id or name) that should provision and sync this registration automatically (managed ee-database mode). Omitted: auto-assigned when exactly one eligible host is connected; otherwise the response's connected_hosts lists the candidates — relay the choice to the user and call assign_sync_host, or fall back to get_database_setup_instructions for browser-confirmed manual pairing."
},
"key_language": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Key Language",
"default": null,
"description": "Language of multilingual identity tokens (ISO 639-1), shared by all schemas of this database. Usually defaults to schema language when needed; publication may request it after classification. Locked once chosen for the database."
},
"purge_on_ack": {
"type": "boolean",
"title": "Purge On Ack",
"default": false,
"description": "Delete delivered delta copies once acknowledged."
},
"index_scalars": {
"type": "string",
"title": "Index Scalars",
"default": "filterable",
"description": "none: identity/feed indexes; keys: add natural keys and relation access paths; filterable (default): add dates, search intent, spatial/range roles and entity query indexes; all: every scalar. Later changes queue index migrations."
},
"notify_debounce_s": {
"type": "integer",
"title": "Notify Debounce S",
"default": 5,
"maximum": 600,
"minimum": 0,
"description": "Quiet period (seconds) before a delta-available notification fires: each new delta resets the timer, so a burst is announced once. Default 5 for MCP callers (agent workflows expect near-immediate reaction); the web app defaults to 30 to coalesce human-scale editing bursts."
},
"delegate_llm_calls": {
"type": "boolean",
"title": "Delegate Llm Calls",
"default": false,
"description": "Run the registration's classification pass on YOUR model: its calls come back as pending requests on classification_job_id, to answer with answer_llm_request; no credits are consumed. Plan feature. Protocol: enricher://docs/llm-delegation."
},
"propagate_not_null": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Propagate Not Null",
"default": null,
"description": "Mirror required schema fields as SQL NOT NULL. Omitted: on for strict gap policies, off for accept_partial. True with accept_partial is refused. Later tightening requires validating existing replica rows; violations can quarantine the migration."
},
"purge_entity_state": {
"type": "boolean",
"title": "Purge Entity State",
"default": false,
"description": "Delete fully delivered entity state after every linked database acknowledges it. Transfers custody to replicas, makes server snapshots incomplete and limits duplicate checks. Relay custody_warning and obtain agreement before enabling. Default false."
},
"purge_on_ack_delay_days": {
"anyOf": [
{
"type": "integer",
"maximum": 365,
"minimum": 1
},
{
"type": "null"
}
],
"title": "Purge On Ack Delay Days",
"default": null,
"description": "Grace period for purge_on_ack: keep acknowledged delta copies this many days (from acknowledgement) before the hourly purge deletes them. Omit to delete them at acknowledgement. Bounded by the plan's delta retention ceiling."
},
"pattern_index_localized_keys": {
"type": "boolean",
"title": "Pattern Index Localized Keys",
"default": false,
"description": "Add per-language pattern-match indexes on indexed localized keys/labels (default false). Useful for prefix autocomplete; increases write/index cost. Concrete SQL depends on the selected dialect."
},
"purge_entity_state_delay_days": {
"anyOf": [
{
"type": "integer",
"maximum": 365,
"minimum": 1
},
{
"type": "null"
}
],
"title": "Purge Entity State Delay Days",
"default": null,
"description": "Grace period for purge_entity_state: a fully-delivered entity row is kept until it has gone this many days without an update, then the hourly purge deletes it. Omit to delete it as soon as every database of the schema acknowledged it."
}
}
}| entity_samples | any | 1..20 reviewed instances of one entity type. Required without sample_record_id. Explicit samples override stored JSON while keeping attachment inheritance. Fields are unioned; missing/null observations become nullable. Use consistent names across samples and array items. Single-language data only; set multilingual flags after generation with update_schema_property. |
| timeout_seconds | integer | Wall-clock cap; returns a timeout error past this. |
| sample_record_id | any | UUID of a successful sample_generation record. Its stored sample(s) are used when entity_samples is omitted, and its linked attachments are inherited when attachment_ids is omitted. |
| delegate_llm_calls | boolean | Run every LLM call of this job on YOUR model instead of a platform model: the job parks each call as a pending request you answer with answer_llm_request; no credits are consumed. Model parameters must then be omitted or 'auto'. Plan feature. Protocol: enricher://docs/llm-delegation. |
| generate_semantic_ids | boolean | Add semantic IDs to eligible keyed objects. Requires an organization embedding model and adds resolution cost. Recommend for reusable identities without stable machine keys; obtain agreement before enabling unless already authorized. Defaults false. Modeling guidance: enricher://docs/schema-from-sample. |
{
"type": "object",
"title": "create_schema_from_sampleArguments",
"properties": {
"model": {
"type": "string",
"title": "Model",
"default": "auto",
"description": "Model composite key, or auto (default) for the organization task selection. Explicit keys are discovered through list_models."
},
"language": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Language",
"default": null,
"description": "Language of schema type names/descriptions and annotations; defaults to the sample-key language. Sample property names are not translated. Separate from enrichment output languages."
},
"samples_csv": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Samples Csv",
"default": null,
"description": "Samples as CSV text instead of entity_samples (never both): the first row is ALWAYS the header, each data row one sample. Delimiter ',', ';' or tab; headers become identifier keys ('Author Name' -> author_name); each column gets one type (integer, number, boolean or text; empty cell = null; decimal commas read in ';'/tab text). Over 20 rows, 20 are kept, covering every column. Read the result's csv_import and relay the kept rows and renamed headers."
},
"attachment_ids": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Attachment Ids",
"default": null,
"description": "UUIDs used as source context and persisted for regeneration. With sample_record_id, omit to inherit its linked attachments; pass [] to deliberately use none, or a non-empty list to override."
},
"entity_samples": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 20
},
{
"type": "null"
}
],
"title": "Entity Samples",
"default": null,
"description": "1..20 reviewed instances of one entity type. Required without sample_record_id. Explicit samples override stored JSON while keeping attachment inheritance. Fields are unioned; missing/null observations become nullable. Use consistent names across samples and array items. Single-language data only; set multilingual flags after generation with update_schema_property."
},
"timeout_seconds": {
"type": "integer",
"title": "Timeout Seconds",
"default": 300,
"maximum": 900,
"minimum": 10,
"description": "Wall-clock cap; returns a timeout error past this."
},
"sample_record_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Sample Record Id",
"default": null,
"description": "UUID of a successful sample_generation record. Its stored sample(s) are used when entity_samples is omitted, and its linked attachments are inherited when attachment_ids is omitted."
},
"delegate_llm_calls": {
"type": "boolean",
"title": "Delegate Llm Calls",
"default": false,
"description": "Run every LLM call of this job on YOUR model instead of a platform model: the job parks each call as a pending request you answer with answer_llm_request; no credits are consumed. Model parameters must then be omitted or 'auto'. Plan feature. Protocol: enricher://docs/llm-delegation."
},
"generate_semantic_ids": {
"type": "boolean",
"title": "Generate Semantic Ids",
"default": false,
"description": "Add semantic IDs to eligible keyed objects. Requires an organization embedding model and adds resolution cost. Recommend for reusable identities without stable machine keys; obtain agreement before enabling unless already authorized. Defaults false. Modeling guidance: enricher://docs/schema-from-sample."
}
}
}| UUID of a saved schema. Mutually exclusive with target_schema. |
| entity_data* | object | Entity identifiers and supplied values. Read get_schema.input_contract first: preserve paths and keys for supplied array items are required. Identifying field names are guidance; arbitrary names are accepted. |
| database_sync | boolean | Whether this run feeds the schema's entity layer and linked databases. Leave true for normal enrichments. Set false for the one-model recovery leg of a failed fusion run (see the recovery ladder above): the merge_records call that follows is what should write, so the intermediate single-model write is skipped. The record itself is still saved either way. |
| target_schema | any | Inline JSON Schema document in the supported Entity Enricher dialect; prefer schema_id. Format: enricher://docs/schema-reference. |
| attachment_ids | any | UUIDs of attachments (from upload_attachment) to provide as source material for this enrichment. |
| timeout_seconds | integer | Wall-clock cap. Past it the call returns `enrichment_timeout` with the job_id and the job is cancelled — a leg still in flight may finish and persist a partial record, reachable via list_records(job_id=...) and recoverable with retry_expertises. Multi-model fusion runs and reasoning models routinely need more than the default; raise it or use start_batch_enrichment (async). |
| arbitration_model | any | Optional LLM model key used to resolve fusion conflicts when 2+ models are selected. Without this, conflicts are resolved by deterministic voting. |
| delegate_llm_calls | boolean | Run every LLM call of this job on YOUR model instead of a platform model: the job parks each call as a pending request you answer with answer_llm_request; no credits are consumed. Model parameters must then be omitted or 'auto'. Plan feature. Protocol: enricher://docs/llm-delegation. |
| classification_model | any | Optional pre-flight classifier model key. When set, the entity is type-checked before enrichment to catch mismatches. |
| force_after_classification_warning | boolean | Set to true to bypass a previous classification warning. Use only after explicit user confirmation. |
{
"type": "object",
"title": "enrich_entityArguments",
"required": [
"entity_data"
],
"properties": {
"models": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Models",
"default": null,
"description": "Model composite keys. Omit or pass ['auto'] for one automatically selected model; auto alone never fuses. Use list_models for explicit choices and model-count limits."
},
"strategy": {
"type": "string",
"title": "Strategy",
"default": "auto",
"description": "auto (default — server picks from the schema) | single_pass (simple schemas, 1 LLM call) | expert_domains (medium schemas with clear domains) | multi_expertise (large multi-domain schemas, parallel per-expertise calls — best quality, higher cost)"
},
"languages": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Languages",
"default": null,
"description": "ISO 639-1 codes; defaults to ['en'] server-side. The first language is the primary one used for all non-multilingual string fields; multilingual fields get one value per language."
},
"schema_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Schema Id",
"default": null,
"description": "UUID of a saved schema. Mutually exclusive with target_schema."
},
"entity_data": {
"type": "object",
"title": "Entity Data",
"description": "Entity identifiers and supplied values. Read get_schema.input_contract first: preserve paths and keys for supplied array items are required. Identifying field names are guidance; arbitrary names are accepted.",
"additionalProperties": true
},
"database_sync": {
"type": "boolean",
"title": "Database Sync",
"default": true,
"description": "Whether this run feeds the schema's entity layer and linked databases. Leave true for normal enrichments. Set false for the one-model recovery leg of a failed fusion run (see the recovery ladder above): the merge_records call that follows is what should write, so the intermediate single-model write is skipped. The record itself is still saved either way."
},
"target_schema": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Target Schema",
"default": null,
"description": "Inline JSON Schema document in the supported Entity Enricher dialect; prefer schema_id. Format: enricher://docs/schema-reference."
},
"attachment_ids": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Attachment Ids",
"default": null,
"description": "UUIDs of attachments (from upload_attachment) to provide as source material for this enrichment."
},
"timeout_seconds": {
"type": "integer",
"title": "Timeout Seconds",
"default": 300,
"maximum": 900,
"minimum": 10,
"description": "Wall-clock cap. Past it the call returns `enrichment_timeout` with the job_id and the job is cancelled — a leg still in flight may finish and persist a partial record, reachable via list_records(job_id=...) and recoverable with retry_expertises. Multi-model fusion runs and reasoning models routinely need more than the default; raise it or use start_batch_enrichment (async)."
},
"arbitration_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Arbitration Model",
"default": null,
"description": "Optional LLM model key used to resolve fusion conflicts when 2+ models are selected. Without this, conflicts are resolved by deterministic voting."
},
"delegate_llm_calls": {
"type": "boolean",
"title": "Delegate Llm Calls",
"default": false,
"description": "Run every LLM call of this job on YOUR model instead of a platform model: the job parks each call as a pending request you answer with answer_llm_request; no credits are consumed. Model parameters must then be omitted or 'auto'. Plan feature. Protocol: enricher://docs/llm-delegation."
},
"classification_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Classification Model",
"default": null,
"description": "Optional pre-flight classifier model key. When set, the entity is type-checked before enrichment to catch mismatches."
},
"force_after_classification_warning": {
"type": "boolean",
"title": "Force After Classification Warning",
"default": false,
"description": "Set to true to bypass a previous classification warning. Use only after explicit user confirmation."
}
}
}| sample_count |
| integer |
| Number of same-type instances (1..20), default 1. Consider 3 varied instances when designing a schema. Attachments force 1. Inspect samples_note for under-delivery or the cap. |
| wait_seconds | integer | How long to wait for the first pause or completion before returning (0 = return the job_id immediately). |
| attachment_ids | any | UUIDs from upload_attachment. Providing any attachment switches the call into source mode: transcribe the document or describe visible photo attributes only, with an interactive planner. |
| typical_objects | any | Up to sample_count concrete instances to anchor knowledge mode (e.g. ['Sanofi', 'Pfizer']), one per generated sample in order — slots beyond len(typical_objects) are named by the model's own instance roster. In source mode the attachment remains authoritative and this is ignored. |
| existing_samples | any | Samples you already hold, to extend instead of starting over: the new samples reproduce the first one's exact field set and never repeat an instance already in the set; sample_count is then the number of NEW samples (set capped at 20 in total), request is optional context, and only the new samples are returned. Knowledge mode only (no attachments). |
| enable_web_search | boolean | Use builtin search in knowledge mode (default false). Source mode remains source-only. With an explicit unsupported model this option is ignored. Hybrid tasks: enricher://docs/documents. |
| naming_convention | string | auto | snake_case | camelCase |
| delegate_llm_calls | boolean | Run every LLM call of this job on YOUR model instead of a platform model: the job parks each call as a pending request you answer with answer_llm_request; no credits are consumed. Model parameters must then be omitted or 'auto'. Plan feature. Protocol: enricher://docs/llm-delegation. |
{
"type": "object",
"title": "generate_sampleArguments",
"properties": {
"model": {
"type": "string",
"title": "Model",
"default": "auto",
"description": "Auto (default) chooses the organization task model with attachment/search capabilities. Explicit provider::model bypasses this capability matching; provider combinations or quota may still fail."
},
"request": {
"type": "string",
"title": "Request",
"default": "",
"maxLength": 4000,
"description": "Entity type, desired fields, scope and size/depth budget. Required without attachments; optional source-mode instructions otherwise. Put the number of instances in sample_count, not in this text."
},
"language": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Language",
"default": null,
"description": "Output language code for the generated field names AND values (e.g. 'en', 'fr'); an explicit code applies even when attachments are in another language. Omitted (default) → the generator follows the language the request is written in (its text and any typical object), else the attachment's, else English."
},
"auto_answer": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Auto Answer",
"default": null,
"description": "Omit or false to pause for clarification; true authorizes standard interpretations and planner defaults without asking, in either mode."
},
"sample_count": {
"type": "integer",
"title": "Sample Count",
"default": 1,
"maximum": 20,
"minimum": 1,
"description": "Number of same-type instances (1..20), default 1. Consider 3 varied instances when designing a schema. Attachments force 1. Inspect samples_note for under-delivery or the cap."
},
"wait_seconds": {
"type": "integer",
"title": "Wait Seconds",
"default": 120,
"maximum": 600,
"minimum": 0,
"description": "How long to wait for the first pause or completion before returning (0 = return the job_id immediately)."
},
"attachment_ids": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Attachment Ids",
"default": null,
"description": "UUIDs from upload_attachment. Providing any attachment switches the call into source mode: transcribe the document or describe visible photo attributes only, with an interactive planner."
},
"typical_objects": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20
},
{
"type": "null"
}
],
"title": "Typical Objects",
"default": null,
"description": "Up to sample_count concrete instances to anchor knowledge mode (e.g. ['Sanofi', 'Pfizer']), one per generated sample in order — slots beyond len(typical_objects) are named by the model's own instance roster. In source mode the attachment remains authoritative and this is ignored."
},
"existing_samples": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 19,
"minItems": 1
},
{
"type": "null"
}
],
"title": "Existing Samples",
"default": null,
"description": "Samples you already hold, to extend instead of starting over: the new samples reproduce the first one's exact field set and never repeat an instance already in the set; sample_count is then the number of NEW samples (set capped at 20 in total), request is optional context, and only the new samples are returned. Knowledge mode only (no attachments)."
},
"enable_web_search": {
"type": "boolean",
"title": "Enable Web Search",
"default": false,
"description": "Use builtin search in knowledge mode (default false). Source mode remains source-only. With an explicit unsupported model this option is ignored. Hybrid tasks: enricher://docs/documents."
},
"naming_convention": {
"type": "string",
"title": "Naming Convention",
"default": "auto",
"description": "auto | snake_case | camelCase"
},
"delegate_llm_calls": {
"type": "boolean",
"title": "Delegate Llm Calls",
"default": false,
"description": "Run every LLM call of this job on YOUR model instead of a platform model: the job parks each call as a pending request you answer with answer_llm_request; no credits are consumed. Model parameters must then be omitted or 'auto'. Plan feature. Protocol: enricher://docs/llm-delegation."
}
}
}{
"type": "object",
"title": "get_benchmark_scenario_resultsArguments",
"required": [
"scenario_id"
],
"properties": {
"limit": {
"anyOf": [
{
"type": "integer",
"maximum": 200,
"minimum": 1
},
{
"type": "null"
}
],
"title": "Limit",
"default": null,
"description": "Keep only the top N after sorting (None = all)."
},
"status": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"success",
"failed",
"stale",
"stale_score",
"unscored"
],
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Status",
"default": null,
"description": "Keep results carrying ANY of these tags: success | failed | stale (config_hash changed since this run, re-run it) | stale_score (reference/scoring config changed since scored, rescore it) | unscored (ran fine, never scored). Empty/None = every status."
},
"sort_by": {
"enum": [
"overall",
"quality",
"cost",
"speed",
"last_run"
],
"type": "string",
"title": "Sort By",
"default": "overall",
"description": "Metric to sort by."
},
"providers": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Providers",
"default": null,
"description": "Keep only these provider names (empty/None = every provider)."
},
"model_keys": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Model Keys",
"default": null,
"description": "Keep only these model composite keys (empty/None = every model)."
},
"sort_order": {
"enum": [
"asc",
"desc"
],
"type": "string",
"title": "Sort Order",
"default": "desc",
"description": "Sort direction."
},
"scenario_id": {
"type": "string",
"title": "Scenario Id",
"description": "UUID of the scenario."
}
}
}{
"type": "object",
"title": "get_job_statusArguments",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"title": "Job Id",
"description": "Job ID returned by a start tool."
},
"events_after": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Events After",
"default": null,
"description": "Event-log cursor: 0 returns the job's events from the start, a previous call's last_seq returns only the newer ones (at most 100 per call; events_has_more says when to call again). Omit to skip the log."
},
"include_result": {
"type": "boolean",
"title": "Include Result",
"default": false,
"description": "Include the full terminal result payload (can be large). Default returns a compact scalar summary per model."
},
"llm_request_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Llm Request Id",
"default": null,
"description": "On a job delegating its LLM calls: return this pending request complete (messages, systemPrompt, tools, toolChoice, attachments) as the only entry of llm_requests. request_not_pending when it is no longer waiting."
}
}
}{
"type": "object",
"title": "list_recordsArguments",
"properties": {
"page": {
"type": "integer",
"title": "Page",
"default": 1,
"minimum": 1
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Model",
"default": null,
"description": "Filter by model composite key (e.g. 'anthropic::claude-sonnet-4-6')."
},
"job_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Job Id",
"default": null,
"description": "Filter to a single job (every model + expertise in one batch shares one job_id)."
},
"search": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Search",
"default": null,
"description": "Substring match against the entity's `name` field in the output."
},
"success": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Success",
"default": null,
"description": "True = only successful records; False = only failed."
},
"page_size": {
"type": "integer",
"title": "Page Size",
"default": 20,
"maximum": 100,
"minimum": 1
},
"record_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Record Type",
"default": null,
"description": "Filter by type: enrichment | classification | arbitration | sample_generation | schema_generation | schema_edit | schema_annotation | ambiguity_analysis | db_classification | benchmark_scoring | playground"
}
}
}| Only concepts used by at least this many records. |
{
"type": "object",
"title": "list_semantic_conceptsArguments",
"properties": {
"view": {
"enum": [
"concepts",
"review"
],
"type": "string",
"title": "View",
"default": "concepts",
"description": "'concepts' = filtered concept page; 'review' = pairs the identity judge left for a person: escalated (unsure), found duplicated while answering another question, or separated at a similarity high enough to double-check."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 50,
"maximum": 200,
"minimum": 1
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0,
"minimum": 0
},
"search": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Search",
"default": null,
"description": "Substring match against concept texts."
},
"sort_by": {
"type": "string",
"title": "Sort By",
"default": "ref_count",
"description": "ref_count | text | concept_type | created_at"
},
"sort_order": {
"enum": [
"asc",
"desc"
],
"type": "string",
"title": "Sort Order",
"default": "desc"
},
"concept_types": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Concept Types",
"default": null,
"description": "Restrict to these concept types (empty/None = every type)."
},
"min_ref_count": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Min Ref Count",
"default": null,
"description": "Only concepts used by at least this many records."
}
}
}{
"type": "object",
"title": "merge_recordsArguments",
"required": [
"result_ids"
],
"properties": {
"result_ids": {
"type": "array",
"items": {
"type": "string"
},
"title": "Result Ids",
"minItems": 2,
"description": "UUIDs of the enrichment records to merge (minimum 2)."
},
"wait_seconds": {
"type": "integer",
"title": "Wait Seconds",
"default": 120,
"maximum": 600,
"minimum": 0,
"description": "Delegated merges only: how long to wait for the first pending request or completion before returning."
},
"attachment_ids": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Attachment Ids",
"default": null,
"description": "Attachments passed to the arbitration LLM (ignored for rule-based merges)."
},
"arbitration_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Arbitration Model",
"default": null,
"description": "Model composite key for LLM arbitration (None = rule-based)."
},
"delegate_llm_calls": {
"type": "boolean",
"title": "Delegate Llm Calls",
"default": false,
"description": "Run the arbitration on YOUR model: pass arbitration_model='auto' and answer the pending requests with answer_llm_request; no credits are consumed. Plan feature. Protocol: enricher://docs/llm-delegation."
}
}
}| string |
| UUID of the saved schema. |
| strip_prefix | boolean | Drop the region's name tokens from the moved field names. |
{
"type": "object",
"title": "nest_schema_regionArguments",
"required": [
"schema_id",
"region_id"
],
"properties": {
"dry_run": {
"type": "boolean",
"title": "Dry Run",
"default": true,
"description": "Report the rewrite without persisting it (the default)."
},
"host_path": {
"type": "string",
"title": "Host Path",
"default": "",
"description": "Container holding the flat members ('' = root, object path, 'path[]', '$defs.X')."
},
"region_id": {
"type": "string",
"title": "Region Id",
"description": "Entity region id from x-entityMap.regions (get_schema)."
},
"schema_id": {
"type": "string",
"title": "Schema Id",
"description": "UUID of the saved schema."
},
"strip_prefix": {
"type": "boolean",
"title": "Strip Prefix",
"default": true,
"description": "Drop the region's name tokens from the moved field names."
}
}
}| delegate_llm_calls | boolean | Run every LLM call of this job on YOUR model instead of a platform model: the job parks each call as a pending request you answer with answer_llm_request; no credits are consumed. Model parameters must then be omitted or 'auto'. Plan feature. Protocol: enricher://docs/llm-delegation. |
{
"type": "object",
"title": "retry_expertisesArguments",
"required": [
"record_id",
"entity_data"
],
"properties": {
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Model",
"default": null,
"description": "Model to retry with (provider::model from list_models). Defaults to the record's own model — pass a stronger one when a domain fails repeatedly on it (retrying the same model that just failed usually fails again). Only the failed domains are re-run and re-billed; the record stays attributed to its original model."
},
"languages": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Languages",
"default": null,
"description": "ISO 639-1 codes; defaults to ['en']."
},
"record_id": {
"type": "string",
"title": "Record Id",
"description": "Enrichment record with failed expertises."
},
"schema_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Schema Id",
"default": null,
"description": "Saved schema UUID (get_record -> saved_schema_id). Or pass target_schema."
},
"entity_data": {
"type": "object",
"title": "Entity Data",
"description": "The record's original entity input (get_record -> entity_input_data).",
"additionalProperties": true
},
"target_schema": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Target Schema",
"default": null,
"description": "Raw schema dict when no saved schema exists."
},
"delegate_llm_calls": {
"type": "boolean",
"title": "Delegate Llm Calls",
"default": false,
"description": "Run every LLM call of this job on YOUR model instead of a platform model: the job parks each call as a pending request you answer with answer_llm_request; no credits are consumed. Model parameters must then be omitted or 'auto'. Plan feature. Protocol: enricher://docs/llm-delegation."
}
}
}| attachment_ids | any | Attachment UUIDs applied as source material to every entity. |
| arbitration_model | any | Optional LLM for auto-fusion conflict resolution (None = rule-based). |
| delegate_llm_calls | boolean | Run every LLM call of this job on YOUR model instead of a platform model: the job parks each call as a pending request you answer with answer_llm_request; no credits are consumed. Model parameters must then be omitted or 'auto'. Plan feature. Protocol: enricher://docs/llm-delegation. |
| classification_model | any | Optional classifier key. Confident mismatches skip that entity; softer verdicts become prompt context. Batch classification never pauses. |
{
"type": "object",
"title": "start_batch_enrichmentArguments",
"required": [
"entities"
],
"properties": {
"models": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Models",
"default": null,
"description": "Model composite keys (call list_models to discover them). Optional: omit (or pass ['auto']) to let the server pick the org's default model — pinned per-task default if set, else the best blended benchmark score."
},
"entities": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"title": "Entities",
"minItems": 1,
"description": "Entities to enrich (each a free-form dict naming the entity — the schema's identifying fields ideally, but any field names work)."
},
"strategy": {
"type": "string",
"title": "Strategy",
"default": "auto",
"description": "auto (default) | single_pass | expert_domains | multi_expertise"
},
"languages": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Languages",
"default": null,
"description": "ISO 639-1 codes; defaults to ['en']."
},
"schema_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Schema Id",
"default": null,
"description": "UUID of a saved schema. Mutually exclusive with target_schema."
},
"target_schema": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Target Schema",
"default": null,
"description": "Inline schema document in the supported Entity Enricher dialect. Prefer schema_id to link records. See enricher://docs/schema-reference."
},
"attachment_ids": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Attachment Ids",
"default": null,
"description": "Attachment UUIDs applied as source material to every entity."
},
"arbitration_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Arbitration Model",
"default": null,
"description": "Optional LLM for auto-fusion conflict resolution (None = rule-based)."
},
"delegate_llm_calls": {
"type": "boolean",
"title": "Delegate Llm Calls",
"default": false,
"description": "Run every LLM call of this job on YOUR model instead of a platform model: the job parks each call as a pending request you answer with answer_llm_request; no credits are consumed. Model parameters must then be omitted or 'auto'. Plan feature. Protocol: enricher://docs/llm-delegation."
},
"classification_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Classification Model",
"default": null,
"description": "Optional classifier key. Confident mismatches skip that entity; softer verdicts become prompt context. Batch classification never pauses."
}
}
}| sample_params |
| any |
| sample_generation: full replacement task params object {request, typical_object, naming_convention, language, enable_web_search}. |
| entity_samples | any | schema_generation: replacement input samples (1..20, whole list). |
| scoring_source | any | Feed this scenario's results into the live per-model scores of the options API: 'organization' (owner+), 'global' (system admin only, fallback for orgs without their own source), or 'off' to stop using it. |
| schema_gen_params | any | schema_generation: full replacement task params object {generate_semantic_ids}. |
| scoring_judge_model_key | any |
{
"type": "object",
"title": "update_benchmark_scenarioArguments",
"required": [
"scenario_id"
],
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name",
"default": null
},
"strategy": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Strategy",
"default": null
},
"languages": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Languages",
"default": null
},
"schema_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Schema Id",
"default": null,
"description": "New saved-schema UUID."
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description",
"default": null,
"description": "Free-text note shown in the Benchmarks tab; no model ever reads it."
},
"entity_data": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Entity Data",
"default": null,
"description": "Enrichment: replacement fixed entity input (same contract as enrich_entity's entity_data; refused when it carries no value)."
},
"repetitions": {
"anyOf": [
{
"type": "integer",
"maximum": 3,
"minimum": 1
},
{
"type": "null"
}
],
"title": "Repetitions",
"default": null
},
"scenario_id": {
"type": "string",
"title": "Scenario Id",
"description": "UUID of the scenario."
},
"sample_params": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Sample Params",
"default": null,
"description": "sample_generation: full replacement task params object {request, typical_object, naming_convention, language, enable_web_search}."
},
"entity_samples": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Entity Samples",
"default": null,
"description": "schema_generation: replacement input samples (1..20, whole list)."
},
"scoring_source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Scoring Source",
"default": null,
"description": "Feed this scenario's results into the live per-model scores of the options API: 'organization' (owner+), 'global' (system admin only, fallback for orgs without their own source), or 'off' to stop using it."
},
"schema_gen_params": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Schema Gen Params",
"default": null,
"description": "schema_generation: full replacement task params object {generate_semantic_ids}."
},
"scoring_judge_model_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Scoring Judge Model Key",
"default": null
}
}
}| any |
| Enable/disable the ambiguity check for this schema — the pass that flags properties whose name admits more than one meaning (gates analyze_schema and the generation post-pass). |
{
"type": "object",
"title": "update_schemaArguments",
"required": [
"schema_id"
],
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name",
"default": null,
"description": "New name (must be unique)."
},
"tags": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Tags",
"default": null,
"description": "Replacement tag list."
},
"is_pinned": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Is Pinned",
"default": null,
"description": "Pin or unpin."
},
"schema_id": {
"type": "string",
"title": "Schema Id",
"description": "UUID of the schema to update."
},
"key_language": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Key Language",
"default": null,
"description": "Pre-set the key language for multilingual database keys ahead of a database link (ISO 639-1). Settable only while the schema has no linked database and no entity state; locked afterwards."
},
"schema_content": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Schema Content",
"default": null,
"description": "Full replacement schema document, following get_schema.schema_content. See enricher://docs/schema-reference."
},
"ambiguity_check_enabled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Ambiguity Check Enabled",
"default": null,
"description": "Enable/disable the ambiguity check for this schema — the pass that flags properties whose name admits more than one meaning (gates analyze_schema and the generation post-pass)."
}
}
}| any |
| new_name | any | Rename the property. |
| schema_id* | string | UUID of the saved schema. |
| description | any |
{
"type": "object",
"title": "update_schema_propertyArguments",
"required": [
"schema_id",
"path"
],
"properties": {
"ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Ref",
"default": null,
"description": "'#/$defs/X' or '#/$enums/X'; clears type."
},
"path": {
"type": "string",
"title": "Path",
"description": "Property path, e.g. 'ceremonies[].ceremony_type'."
},
"type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Type",
"default": null,
"description": "New JSON type (string/number/integer/boolean/array/object); clears $ref."
},
"flags": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Flags",
"default": null,
"description": "Flag updates (null clears): expertise, preserve, multilingual, language_discriminator, identifying, nullable, format, pattern, semantic_id, judge_floor, semantic_concept_type, semantic_embedding_model, database_key, db_type, db_type_length, index, unique_group, shared, ordered, db_name, db_name_absolute."
},
"remove": {
"type": "boolean",
"title": "Remove",
"default": false,
"description": "Delete the property instead."
},
"examples": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
{
"type": "null"
}
],
"title": "Examples",
"default": null
},
"new_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "New Name",
"default": null,
"description": "Rename the property."
},
"schema_id": {
"type": "string",
"title": "Schema Id",
"description": "UUID of the saved schema."
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description",
"default": null
}
}
}