Agent Master Data

Free discovery tool. Get supported public master-data entity types, identifiers, searchable attributes, relationships, reference domains, coverage, and freshness. Use this first when an agent does not know the data model or valid filters.

{
  "type": "object",
  "properties": {
    "entity_type": {
      "$ref": "#/$defs/entityType",
      "description": "Describe only this entity domain. Omitted means all v1 entity domains."
    },
    "include_attributes": {
      "default": true,
      "description": "When false, the attributes member is omitted from each described entity type.",
      "type": "boolean"
    },
    "include_identifiers": {
      "default": true,
      "description": "When false, the identifiers member is omitted from each described entity type. primary_identifier is always present.",
      "type": "boolean"
    },
    "include_relationships": {
      "default": true,
      "description": "When false, the relationships member is omitted from each described entity type.",
      "type": "boolean"
    }
  },
  "$defs": {
    "entityType": {
      "description": "One of the v1 entity domains. customer, asset, and person are closed Operator decisions, not gaps; reference data is served by get_reference_data.",
      "enum": [
        "supplier",
        "location",
        "organization"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "description": "Input for the free discovery tool that describes the published master-data schema: entity domains, identifiers, attributes, and relationships. Every property is optional: an empty object returns the full schema for all v1 entity domains.",
  "title": "get_master_data_schema tool input"
}

Paid x402 tool. Search trusted public master data for suppliers, locations, or organizations. Returns bounded golden-record summaries with match reasons, confidence, provenance, public-use status, freshness, and data-quality scores. Price ID: price.search.v1. Read masterdata://pricing before payment.

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "Opaque pagination cursor from a previous response's meta.next_cursor.",
      "minLength": 1,
      "type": "string"
    },
    "entity_type": {
      "$ref": "#/$defs/entityType",
      "description": "Restrict the search to one entity domain. Omitted means all v1 entity domains."
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of results per page.",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "query": {
      "description": "Free-text search over golden records.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "$defs": {
    "entityType": {
      "description": "One of the v1 entity domains. customer, asset, and person are closed Operator decisions, not gaps; reference data is served by get_reference_data.",
      "enum": [
        "supplier",
        "location",
        "organization"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "description": "Input for the paid search over golden records. Mirrors POST /v1/master-data/search.",
  "title": "search_master_data tool input"
}

Paid x402 tool. Match incomplete or conflicting public supplier, location, or organization attributes to trusted master-data candidates. Returns explainable match evidence and never silently chooses an ambiguous entity. Price ID: price.resolve.v1.

{
  "type": "object",
  "properties": {
    "attributes": {
      "additionalProperties": {
        "type": "string"
      },
      "description": "Identifying attribute values keyed by field name, e.g. a name or an address line.",
      "type": "object"
    },
    "entity_type": {
      "$ref": "#/$defs/entityType"
    },
    "identifiers": {
      "description": "Known identifiers of the entity being resolved.",
      "items": {
        "additionalProperties": false,
        "properties": {
          "system": {
            "description": "Identifier system the value belongs to.",
            "minLength": 1,
            "type": "string"
          },
          "value": {
            "description": "The identifier value within its system.",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "system",
          "value"
        ],
        "type": "object"
      },
      "minItems": 1,
      "type": "array"
    }
  },
  "required": [
    "entity_type"
  ],
  "$defs": {
    "entityType": {
      "description": "One of the v1 entity domains. customer, asset, and person are closed Operator decisions, not gaps; reference data is served by get_reference_data.",
      "enum": [
        "supplier",
        "location",
        "organization"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "anyOf": [
    {
      "required": [
        "identifiers"
      ]
    },
    {
      "required": [
        "attributes"
      ]
    }
  ],
  "description": "Input for the paid resolution of identifying attributes to the matching golden-record identity. Mirrors POST /v1/master-data/entities/resolve. At least one of identifiers or attributes must be supplied.",
  "title": "resolve_master_data_entity tool input"
}

Paid x402 tool. Retrieve one authoritative public golden record by stable record ID. Returns public attributes, identifiers, source-record lineage, survivorship evidence, freshness, relationships summary, and data quality. Price ID: price.record.v1.

{
  "type": "object",
  "properties": {
    "entity_type": {
      "$ref": "#/$defs/entityType"
    },
    "record_id": {
      "description": "Golden-record identifier within the entity domain.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "entity_type",
    "record_id"
  ],
  "$defs": {
    "entityType": {
      "description": "One of the v1 entity domains. customer, asset, and person are closed Operator decisions, not gaps; reference data is served by get_reference_data.",
      "enum": [
        "supplier",
        "location",
        "organization"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "description": "Input for the paid fetch of one golden record with provenance and per-value redistribution terms. Mirrors GET /v1/master-data/entities/{entity_type}/{record_id}.",
  "title": "get_master_data_golden_record tool input"
}

Paid x402 tool. Get governed public relationships for one master-data golden record, such as supplier ownership, location hierarchy, or organization parentage. Returns direction, validity dates, provenance, and confidence. Price IDs by requested depth: price.relationships.depth-1.v1, price.relationships.depth-2.v1, or price.relationships.depth-3.v1.

{
  "type": "object",
  "properties": {
    "depth": {
      "default": 1,
      "description": "Traversal depth. Each depth is a separately priced tier.",
      "enum": [
        1,
        2,
        3
      ],
      "type": "integer"
    },
    "entity_type": {
      "$ref": "#/$defs/entityType"
    },
    "record_id": {
      "description": "Golden-record identifier within the entity domain.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "entity_type",
    "record_id"
  ],
  "$defs": {
    "entityType": {
      "description": "One of the v1 entity domains. customer, asset, and person are closed Operator decisions, not gaps; reference data is served by get_reference_data.",
      "enum": [
        "supplier",
        "location",
        "organization"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "description": "Input for the paid fetch of the relationship graph around one golden record, priced by traversal depth. Mirrors GET /v1/master-data/entities/{entity_type}/{record_id}/relationships.",
  "title": "get_master_data_relationships tool input"
}

Paid x402 tool. Get governed public reference data and controlled vocabulary values such as country, currency, unit of measure, industry, status, category, or code mappings. Returns codes, labels, definitions, validity dates, mappings, provenance, and version. Price ID: price.reference.v1.

{
  "type": "object",
  "properties": {
    "codes": {
      "description": "Exact codes wanted. Set membership, never a substring match; omit it to narrow nothing.",
      "items": {
        "maxLength": 100,
        "minLength": 1,
        "type": "string"
      },
      "maxItems": 100,
      "type": "array",
      "uniqueItems": true
    },
    "cursor": {
      "description": "Opaque continuation cursor from a prior identical request. Bound to the operation, the normalized request, and the data_version it paged.",
      "maxLength": 2048,
      "type": "string"
    },
    "domain": {
      "description": "Reference-data domain identifier, as get_master_data_schema names it.",
      "maxLength": 100,
      "minLength": 1,
      "type": "string"
    },
    "include_inactive": {
      "default": false,
      "description": "Whether values not KNOWN to be active at valid_at are served. False excludes them; true serves them flagged - active: false for a value declared inactive, beside the reference_value_inactive warning, and active: null for one whose source states no validity interval, beside reference_value_validity_unknown - so an intentionally excluded value is distinguishable from an accidental match. Either warning is carried when such a value is WITHHELD too, so the omission is never silent.",
      "type": "boolean"
    },
    "limit": {
      "default": 100,
      "description": "Page size, applied after query, codes, and validity have narrowed the list.",
      "maximum": 500,
      "minimum": 1,
      "type": "integer"
    },
    "locale": {
      "default": "en",
      "description": "Language tag echoed on every served value and in the answer. Labels are served exactly as the snapshot stores them; there is no translation layer.",
      "pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$",
      "type": "string"
    },
    "query": {
      "description": "Optional code or label search: a case-insensitive substring match against a value's code OR its label. Omit it to match every value.",
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "valid_at": {
      "description": "The instant to evaluate each value's validity interval at. Defaults to the request clock. A value whose source DECLARES its interval is active when valid_from <= valid_at < valid_to, an absent or null bound open on its side. A value whose source states no interval at all is neither: it is served active: null and carries the reference_value_validity_unknown warning.",
      "format": "date-time",
      "type": "string"
    }
  },
  "required": [
    "domain"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "description": "Input for the paid fetch of one governed reference-data code list. Mirrors GET /v1/reference-data/{domain}. Every optional member below is BUILD.md 8.7's, and the semantics are implemented in crates/core/src/operations/reference.rs: query and codes narrow the list, valid_at and include_inactive decide which values are current, limit and cursor page the result.",
  "title": "get_reference_data tool input"
}

Paid x402 tool. Assess the completeness, validity, consistency, uniqueness, and freshness of a master-data record or supplied attributes. Returns explainable issues, severity, affected fields, policy rules, and safe remediation guidance without changing data. Price ID: price.quality.v1.

{
  "type": "object",
  "properties": {
    "attributes": {
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "integer",
          "boolean",
          "null"
        ]
      },
      "description": "Candidate attributes to assess without writing them. Supply this or record_id, never both. No value submitted here is stored, published, or echoed: the answer names the input by its digest alone.",
      "maxProperties": 50,
      "minProperties": 1,
      "type": "object"
    },
    "dimensions": {
      "default": [
        "completeness",
        "validity",
        "consistency",
        "uniqueness",
        "freshness"
      ],
      "description": "The quality dimensions to assess. A registered rule scoring a dimension not asked for is absent from the answer's issues, passed_rules, and not_evaluated_rules alike.",
      "items": {
        "$ref": "#/$defs/qualityDimension"
      },
      "type": "array",
      "uniqueItems": true
    },
    "entity_type": {
      "$ref": "#/$defs/entityType"
    },
    "include_remediation_guidance": {
      "default": true,
      "description": "Whether each reported issue carries remediation guidance.",
      "type": "boolean"
    },
    "record_id": {
      "description": "Existing golden-record ID to assess. Supply this or attributes, never both.",
      "maxLength": 256,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "entity_type"
  ],
  "$defs": {
    "entityType": {
      "description": "One of the v1 entity domains. customer, asset, and person are closed Operator decisions, not gaps; reference data is served by get_reference_data.",
      "enum": [
        "supplier",
        "location",
        "organization"
      ]
    },
    "qualityDimension": {
      "description": "The quality dimensions the serving snapshot scores. Exactly the five the snapshot's quality object carries and the quality_rules registry may name.",
      "enum": [
        "completeness",
        "validity",
        "consistency",
        "uniqueness",
        "freshness"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "description": "Input for the paid quality assessment of ONE stored golden record or ONE submitted attribute set. Mirrors POST /v1/master-data/data-quality/assess. Exactly one of record_id or attributes is supplied, per BUILD.md 8.8; the semantics are implemented in crates/core/src/operations/quality.rs. Submitted attributes are assessed without being written, and only their digest is ever echoed back.",
  "oneOf": [
    {
      "required": [
        "record_id"
      ]
    },
    {
      "required": [
        "attributes"
      ]
    }
  ],
  "title": "assess_master_data_quality tool input"
}