Skip to main content
Glama

NarcoScope — illicit-economy evidence atlas

Inspect China drug data coverage

get_palimpsest_bridge
Read-only

Inspect official China evidence coverage and source metadata. WDR prices and seizures are withheld pending publication permission; independently available precursor, designation and wildlife aggregates retain their provenance, disclosure and causal boundaries.

Input Schema

NameRequiredDescriptionDefault

No arguments

Output Schema

NameRequiredDescriptionDefault
$schemaYes
dataAsOfYes
datasetsYes
geographyYes
artifactIdYes
disclosureYes
exclusionsYes
limitationsYes
canonicalUrlYes
schemaVersionYes
interpretationYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changed
    • changedOutput schema / $defs / dataset / properties / data / type
      Previous value: -"object"New value: +[
      +  "object",
      +  "null"
      +]
    • addedOutput schema / $defs / dataset / properties / publication
      Added value: +{
      +  "$ref": "#/$defs/publication"
      +}
    • addedOutput schema / $defs / publication
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "observationScope": {
      +      "const": "published_rows_only"
      +    },
      +    "permissionEvidence": {
      +      "type": "null"
      +    },
      +    "policyId": {
      +      "const": "narcoscope.publication-rights.2026-10-28.v1"
      +    },
      +    "reason": {
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "sourceIds": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "minItems": 1,
      +      "type": "array"
      +    },
      +    "status": {
      +      "const": "metadata_only"
      +    }
      +  },
      +  "required": [
      +    "policyId",
      +    "status",
      +    "sourceIds",
      +    "permissionEvidence",
      +    "reason",
      +    "observationScope"
      +  ],
      +  "type": "object"
      +}
    • changedOutput schema / properties / datasets / properties / drugSeizures / allOf
      Previous value: -[
      -  {
      -    "$ref": "#/$defs/dataset"
      -  },
      -  {
      -    "properties": {
      -      "datasetId": {
      -        "const": "drug_seizures"
      -      }
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "$ref": "#/$defs/dataset"
      +  },
      +  {
      +    "properties": {
      +      "datasetId": {
      +        "const": "drug_seizures"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "data": {
      +        "type": "null"
      +      },
      +      "publication": {
      +        "$ref": "#/$defs/publication"
      +      }
      +    },
      +    "required": [
      +      "publication"
      +    ],
      +    "type": "object"
      +  }
      +]
    • changedOutput schema / properties / datasets / properties / retailDrugPrices / allOf
      Previous value: -[
      -  {
      -    "$ref": "#/$defs/dataset"
      -  },
      -  {
      -    "properties": {
      -      "datasetId": {
      -        "const": "retail_drug_prices"
      -      }
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "$ref": "#/$defs/dataset"
      +  },
      +  {
      +    "properties": {
      +      "datasetId": {
      +        "const": "retail_drug_prices"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "data": {
      +        "type": "null"
      +      },
      +      "publication": {
      +        "$ref": "#/$defs/publication"
      +      }
      +    },
      +    "required": [
      +      "publication"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$defs": {
      +    "dataset": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "data": {
      +          "type": "object"
      +        },
      +        "datasetId": {
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "limitations": {
      +          "items": {
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "minItems": 1,
      +          "type": "array"
      +        },
      +        "measurement": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "grain": {
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "method": {
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "status": {
      +              "enum": [
      +                "official_reported",
      +                "official_action_record"
      +              ]
      +            },
      +            "unit": {
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "valueType": {
      +              "enum": [
      +                "statistical_measurement",
      +                "administrative_measurement",
      +                "administrative_action"
      +              ]
      +            }
      +          },
      +          "required": [
      +            "status",
      +            "valueType",
      +            "method",
      +            "unit",
      +            "grain"
      +          ],
      +          "type": "object"
      +        },
      +        "provenance": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "documentSha256": {
      +              "pattern": "^[a-f0-9]{64}$",
      +              "type": "string"
      +            },
      +            "input": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "path": {
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                "sha256": {
      +                  "pattern": "^[a-f0-9]{64}$",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "path",
      +                "sha256"
      +              ],
      +              "type": "object"
      +            },
      +            "localDataDate": {
      +              "format": "date",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "publisher": {
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "retrievedAt": {
      +              "format": "date-time",
      +              "type": "string"
      +            },
      +            "sourceEdition": {
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "title": {
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "url": {
      +              "format": "uri",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "publisher",
      +            "title",
      +            "url",
      +            "sourceEdition",
      +            "localDataDate",
      +            "input"
      +          ],
      +          "type": "object"
      +        },
      +        "sourceStatus": {
      +          "const": "official"
      +        },
      +        "temporalCoverage": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "fromYear": {
      +              "type": [
      +                "integer",
      +                "null"
      +              ]
      +            },
      +            "kind": {
      +              "enum": [
      +                "year_range",
      +                "snapshot"
      +              ]
      +            },
      +            "snapshotDate": {
      +              "format": "date",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "toYear": {
      +              "type": [
      +                "integer",
      +                "null"
      +              ]
      +            }
      +          },
      +          "required": [
      +            "kind",
      +            "fromYear",
      +            "toYear",
      +            "snapshotDate"
      +          ],
      +          "type": "object"
      +        },
      +        "topic": {
      +          "minLength": 1,
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "datasetId",
      +        "topic",
      +        "sourceStatus",
      +        "measurement",
      +        "temporalCoverage",
      +        "provenance",
      +        "data",
      +        "limitations"
      +      ],
      +      "type": "object"
      +    },
      +    "ofacDesignationData": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "byEntityType": {
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "count": {
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              "entityType": {
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "entityType",
      +              "count"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "byProgram": {
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "count": {
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              "label": {
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "program": {
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "program",
      +              "label",
      +              "count"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "multiCountryRecordCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "narcoticsSpecificProgramRecordCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "recordCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "tcoOnlyRecordCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        }
      +      },
      +      "required": [
      +        "recordCount",
      +        "narcoticsSpecificProgramRecordCount",
      +        "tcoOnlyRecordCount",
      +        "byEntityType",
      +        "byProgram",
      +        "multiCountryRecordCount"
      +      ],
      +      "type": "object"
      +    },
      +    "precursorCorridorData": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "contextRecords": {
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "allocationStatus": {
      +                "const": "not_reported_by_origin_destination_pair"
      +              },
      +              "contextId": {
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "countScope": {
      +                "const": "four_reporting_countries_operation_total"
      +              },
      +              "destinations": {
      +                "items": {
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                "minItems": 1,
      +                "type": "array",
      +                "uniqueItems": true
      +              },
      +              "operationReportedSeizureCount": {
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "origins": {
      +                "items": {
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                "minItems": 1,
      +                "type": "array",
      +                "uniqueItems": true
      +              },
      +              "precursor": {
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "recordKind": {
      +                "const": "qualitative_context"
      +              },
      +              "sourceLocator": {
      +                "$ref": "#/$defs/sourceLocator"
      +              },
      +              "summary": {
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "year": {
      +                "minimum": 1900,
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "contextId",
      +              "precursor",
      +              "origins",
      +              "destinations",
      +              "year",
      +              "recordKind",
      +              "allocationStatus",
      +              "operationReportedSeizureCount",
      +              "countScope",
      +              "summary",
      +              "sourceLocator"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "corridors": {
      +          "items": {
      +            "additionalProperties": false,
      +            "allOf": [
      +              {
      +                "if": {
      +                  "properties": {
      +                    "aggregationEligibility": {
      +                      "const": "eligible"
      +                    }
      +                  },
      +                  "required": [
      +                    "aggregationEligibility"
      +                  ],
      +                  "type": "object"
      +                },
      +                "then": {
      +                  "properties": {
      +                    "aggregationGroup": {
      +                      "type": "string"
      +                    },
      +                    "quantityRelation": {
      +                      "const": "exact"
      +                    },
      +                    "recordKind": {
      +                      "not": {
      +                        "const": "derived_subtotal"
      +                      }
      +                    }
      +                  },
      +                  "type": "object"
      +                }
      +              },
      +              {
      +                "else": {
      +                  "properties": {
      +                    "aggregationEligibility": {
      +                      "const": "ineligible_non_exact"
      +                    }
      +                  },
      +                  "type": "object"
      +                },
      +                "if": {
      +                  "properties": {
      +                    "quantityRelation": {
      +                      "const": "exact"
      +                    }
      +                  },
      +                  "required": [
      +                    "quantityRelation"
      +                  ],
      +                  "type": "object"
      +                },
      +                "then": {
      +                  "properties": {
      +                    "aggregationEligibility": {
      +                      "not": {
      +                        "const": "ineligible_non_exact"
      +                      }
      +                    }
      +                  },
      +                  "type": "object"
      +                }
      +              },
      +              {
      +                "if": {
      +                  "properties": {
      +                    "recordKind": {
      +                      "const": "derived_subtotal"
      +                    }
      +                  },
      +                  "required": [
      +                    "recordKind"
      +                  ],
      +                  "type": "object"
      +                },
      +                "then": {
      +                  "properties": {
      +                    "aggregationEligibility": {
      +                      "const": "ineligible_derived"
      +                    },
      +                    "aggregationGroup": {
      +                      "const": null
      +                    }
      +                  },
      +                  "type": "object"
      +                }
      +              },
      +              {
      +                "if": {
      +                  "properties": {
      +                    "aggregationEligibility": {
      +                      "const": "ineligible_derived"
      +                    }
      +                  },
      +                  "required": [
      +                    "aggregationEligibility"
      +                  ],
      +                  "type": "object"
      +                },
      +                "then": {
      +                  "properties": {
      +                    "aggregationGroup": {
      +                      "const": null
      +                    },
      +                    "recordKind": {
      +                      "const": "derived_subtotal"
      +                    }
      +                  },
      +                  "type": "object"
      +                }
      +              },
      +              {
      +                "if": {
      +                  "properties": {
      +                    "aggregationEligibility": {
      +                      "const": "ineligible_incompatible_basis"
      +                    }
      +                  },
      +                  "required": [
      +                    "aggregationEligibility"
      +                  ],
      +                  "type": "object"
      +                },
      +                "then": {
      +                  "properties": {
      +                    "aggregationGroup": {
      +                      "const": null
      +                    }
      +                  },
      +                  "type": "object"
      +                }
      +              }
      +            ],
      +            "properties": {
      +              "aggregationEligibility": {
      +                "enum": [
      +                  "eligible",
      +                  "ineligible_non_exact",
      +                  "ineligible_derived",
      +                  "ineligible_incompatible_basis"
      +                ]
      +              },
      +              "aggregationGroup": {
      +                "oneOf": [
      +                  {
      +                    "enum": [
      +                      "mdma_precursor_substance_mass",
      +                      "meth_pre_precursor_substance_mass",
      +                      "pseudoephedrine_preparation_gross_mass",
      +                      "potassium_permanganate_substance_mass",
      +                      "pseudoephedrine_preparation_mass"
      +                    ]
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "destination": {
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "incidentCount": {
      +                "minimum": 1,
      +                "type": [
      +                  "integer",
      +                  "null"
      +                ]
      +              },
      +              "originAttribution": {
      +                "enum": [
      +                  "china_only",
      +                  "joint_origin_includes_china"
      +                ]
      +              },
      +              "precursor": {
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "quantityBasis": {
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "quantityKg": {
      +                "minimum": 0,
      +                "type": "number"
      +              },
      +              "quantityRelation": {
      +                "enum": [
      +                  "exact",
      +                  "approx",
      +                  "less_than",
      +                  "greater_than"
      +                ]
      +              },
      +              "recordKind": {
      +                "enum": [
      +                  "single_incident",
      +                  "multi_incident_aggregate",
      +                  "annual_aggregate",
      +                  "derived_subtotal"
      +                ]
      +              },
      +              "reportedOrigin": {
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "seizureLocation": {
      +                "minLength": 1,
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "sourceLocator": {
      +                "$ref": "#/$defs/sourceLocator"
      +              },
      +              "transit": {
      +                "minLength": 1,
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "year": {
      +                "minimum": 1900,
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "originAttribution",
      +              "reportedOrigin",
      +              "transit",
      +              "destination",
      +              "seizureLocation",
      +              "year",
      +              "precursor",
      +              "quantityKg",
      +              "quantityRelation",
      +              "quantityBasis",
      +              "recordKind",
      +              "aggregationEligibility",
      +              "aggregationGroup",
      +              "incidentCount",
      +              "sourceLocator"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "includedContextRecordCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "includedQuantitativeRecordCount": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "quantityAggregation": {
      +          "additionalProperties": false,
      +          "allOf": [
      +            {
      +              "else": {
      +                "properties": {
      +                  "aggregationGroup": {
      +                    "const": null
      +                  },
      +                  "summedQuantityKg": {
      +                    "const": null
      +                  }
      +                },
      +                "type": "object"
      +              },
      +              "if": {
      +                "properties": {
      +                  "status": {
      +                    "const": "computed_exact_only"
      +                  }
      +                },
      +                "required": [
      +                  "status"
      +                ],
      +                "type": "object"
      +              },
      +              "then": {
      +                "properties": {
      +                  "aggregationGroup": {
      +                    "enum": [
      +                      "mdma_precursor_substance_mass",
      +                      "meth_pre_precursor_substance_mass",
      +                      "pseudoephedrine_preparation_gross_mass",
      +                      "potassium_permanganate_substance_mass",
      +                      "pseudoephedrine_preparation_mass"
      +                    ]
      +                  },
      +                  "eligibleRecordCount": {
      +                    "minimum": 1,
      +                    "type": "integer"
      +                  },
      +                  "summedQuantityKg": {
      +                    "type": "number"
      +                  }
      +                },
      +                "type": "object"
      +              }
      +            }
      +          ],
      +          "properties": {
      +            "aggregationGroup": {
      +              "oneOf": [
      +                {
      +                  "enum": [
      +                    "mdma_precursor_substance_mass",
      +                    "meth_pre_precursor_substance_mass",
      +                    "pseudoephedrine_preparation_gross_mass",
      +                    "potassium_permanganate_substance_mass",
      +                    "pseudoephedrine_preparation_mass"
      +                  ]
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            },
      +            "eligibleRecordCount": {
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "exactRecordCount": {
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "excludedRecordCount": {
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "nonExactRecordCount": {
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "status": {
      +              "enum": [
      +                "computed_exact_only",
      +                "not_computed_non_exact_inputs",
      +                "not_computed_ineligible_exact_inputs",
      +                "not_computed_mixed_aggregation_groups",
      +                "not_computed_no_records"
      +              ]
      +            },
      +            "summedQuantityKg": {
      +              "minimum": 0,
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            }
      +          },
      +          "required": [
      +            "status",
      +            "exactRecordCount",
      +            "nonExactRecordCount",
      +            "eligibleRecordCount",
      +            "excludedRecordCount",
      +            "aggregationGroup",
      +            "summedQuantityKg"
      +          ],
      +          "type": "object"
      +        }
      +      },
      +      "required": [
      +        "includedQuantitativeRecordCount",
      +        "includedContextRecordCount",
      +        "quantityAggregation",
      +        "corridors",
      +        "contextRecords"
      +      ],
      +      "type": "object"
      +    },
      +    "sourceLocator": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "paragraph": {
      +          "minimum": 1,
      +          "type": "integer"
      +        },
      +        "pdfPage": {
      +          "minimum": 1,
      +          "type": "integer"
      +        },
      +        "printedPage": {
      +          "minimum": 1,
      +          "type": "integer"
      +        }
      +      },
      +      "required": [
      +        "pdfPage",
      +        "printedPage",
      +        "paragraph"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "$id": "urn:narcoscope:mcp-output:palimpsest-bridge:v1",
      +  "$schema": "https://json-schema.org/draft/2020-12/schema",
      +  "additionalProperties": false,
      +  "properties": {
      +    "$schema": {
      +      "const": "./narcoscope-palimpsest-v1.schema.json"
      +    },
      +    "artifactId": {
      +      "const": "narcoscope.china.official-coverage"
      +    },
      +    "canonicalUrl": {
      +      "format": "uri",
      +      "pattern": "^https://",
      +      "type": "string"
      +    },
      +    "dataAsOf": {
      +      "format": "date",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "datasets": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "drugSeizures": {
      +          "allOf": [
      +            {
      +              "$ref": "#/$defs/dataset"
      +            },
      +            {
      +              "properties": {
      +                "datasetId": {
      +                  "const": "drug_seizures"
      +                }
      +              },
      +              "type": "object"
      +            }
      +          ]
      +        },
      +        "ofacDesignations": {
      +          "allOf": [
      +            {
      +              "$ref": "#/$defs/dataset"
      +            },
      +            {
      +              "properties": {
      +                "data": {
      +                  "$ref": "#/$defs/ofacDesignationData"
      +                },
      +                "datasetId": {
      +                  "const": "ofac_designations"
      +                }
      +              },
      +              "type": "object"
      +            }
      +          ]
      +        },
      +        "precursorCorridorIncidents": {
      +          "allOf": [
      +            {
      +              "$ref": "#/$defs/dataset"
      +            },
      +            {
      +              "properties": {
      +                "data": {
      +                  "$ref": "#/$defs/precursorCorridorData"
      +                },
      +                "datasetId": {
      +                  "const": "precursor_corridor_incidents"
      +                },
      +                "provenance": {
      +                  "properties": {
      +                    "documentSha256": {
      +                      "const": "8397f2799116fe33ce6851ec2c7e03a042886fb9c048f72cdb259724de5ddd6e"
      +                    },
      +                    "retrievedAt": {
      +                      "const": "2026-08-12T13:50:25Z"
      +                    },
      +                    "url": {
      +                      "const": "https://www.incb.org/incb/uploads/documents/Publications/AnnualReports/AR2025/Precursors_Report/E_INCB_2025_4_eng.pdf"
      +                    }
      +                  },
      +                  "required": [
      +                    "documentSha256",
      +                    "retrievedAt"
      +                  ],
      +                  "type": "object"
      +                }
      +              },
      +              "type": "object"
      +            }
      +          ]
      +        },
      +        "retailDrugPrices": {
      +          "allOf": [
      +            {
      +              "$ref": "#/$defs/dataset"
      +            },
      +            {
      +              "properties": {
      +                "datasetId": {
      +                  "const": "retail_drug_prices"
      +                }
      +              },
      +              "type": "object"
      +            }
      +          ]
      +        },
      +        "wildlifeConfiscations": {
      +          "allOf": [
      +            {
      +              "$ref": "#/$defs/dataset"
      +            },
      +            {
      +              "properties": {
      +                "datasetId": {
      +                  "const": "wildlife_confiscations"
      +                }
      +              },
      +              "type": "object"
      +            }
      +          ]
      +        }
      +      },
      +      "required": [
      +        "retailDrugPrices",
      +        "drugSeizures",
      +        "precursorCorridorIncidents",
      +        "ofacDesignations",
      +        "wildlifeConfiscations"
      +      ],
      +      "type": "object"
      +    },
      +    "disclosure": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "exactAddressDisclosure": {
      +          "const": "none"
      +        },
      +        "identifierDisclosure": {
      +          "const": "none"
      +        },
      +        "illustrativeDataIncluded": {
      +          "const": false
      +        },
      +        "level": {
      +          "const": "public_aggregate"
      +        },
      +        "runtimeCoupling": {
      +          "const": "none_static_artifact"
      +        },
      +        "sourcePolicy": {
      +          "const": "official_only"
      +        },
      +        "subjectEntityDisclosure": {
      +          "const": "none"
      +        }
      +      },
      +      "required": [
      +        "level",
      +        "sourcePolicy",
      +        "subjectEntityDisclosure",
      +        "exactAddressDisclosure",
      +        "identifierDisclosure",
      +        "illustrativeDataIncluded",
      +        "runtimeCoupling"
      +      ],
      +      "type": "object"
      +    },
      +    "exclusions": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "classification": {
      +            "enum": [
      +              "illustrative",
      +              "illustrative_or_constructed",
      +              "unreviewed_leads",
      +              "privacy_minimized"
      +            ]
      +          },
      +          "component": {
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "reason": {
      +            "minLength": 1,
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "component",
      +          "classification",
      +          "reason"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "geography": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "country": {
      +          "const": "China"
      +        },
      +        "iso2": {
      +          "const": "CN"
      +        },
      +        "iso3": {
      +          "const": "CHN"
      +        }
      +      },
      +      "required": [
      +        "country",
      +        "iso2",
      +        "iso3"
      +      ],
      +      "type": "object"
      +    },
      +    "interpretation": {
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "limitations": {
      +      "items": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "minItems": 1,
      +      "type": "array"
      +    },
      +    "schemaVersion": {
      +      "const": "narcoscope.palimpsest.china-aggregate.v1"
      +    }
      +  },
      +  "required": [
      +    "$schema",
      +    "schemaVersion",
      +    "artifactId",
      +    "dataAsOf",
      +    "geography",
      +    "disclosure",
      +    "datasets",
      +    "exclusions",
      +    "limitations",
      +    "canonicalUrl",
      +    "interpretation"
      +  ],
      +  "title": "NarcoScope public China aggregate for Palimpsest",
      +  "type": "object"
      +}
  3. First observed

TDQS

A3.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the safety profile (read-only, closed-world, non-destructive), so the description adds genuine value by disclosing partial data availability: WDR prices and seizures are withheld pending permission, while precursor, designation and wildlife aggregates retain provenance and disclosure boundaries. This tells the agent to expect gaps rather than assume missing data means zero.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with the core purpose followed by the caveat. The second sentence is dense with jargon ('causal boundaries', 'designation aggregates') but every clause carries information about coverage limits.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return format need not be described. For a no-argument inspection tool, the description supplies the key context (what is covered, what is suppressed and why). It could go further in stating how the aggregates relate to the other palimpsest endpoints.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Zero parameters with an empty schema, so there is nothing for the description to disambiguate. Baseline of 4 applies; the description adds nothing here but nothing is required.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource: inspect official China evidence coverage plus source metadata. Clear enough to know what the tool returns, but it never distinguishes itself from the similarly-named siblings (get_palimpsest_bri_context, get_palimpsest_corridors), and the tool name 'bridge' is opaque relative to the description.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no guidance on when to call this versus the other palimpsest tools, and no stated prerequisites. The note about withheld WDR data is a caveat about results, not a selection rule for the agent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.