Skip to main content
Glama

Probative legal-marketing data

Compare keys in a dataset

data_compare
Read-onlyIdempotent

Compare up to 10 states, counties or other keys of one dataset side by side, e.g. lawyer pay or bar pass rates in two states. Results are not legal advice.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "dataset": "<dataset>",
      "keys": "<keys>"
    },
    "name": "data_compare"
  }
}

Input Schema

NameRequiredDescriptionDefault
keysYes
datasetYesA dataset id, e.g. ad-costs, attorneys, aviation-accidents, bankruptcy, bar-pipeline. list_datasets lists every id.
response_formatNoconcise

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / dataset / description
      Previous value: -"A dataset id, e.g. attorneys, aviation-accidents, bankruptcy, bar-pipeline, benchmarks. list_datasets lists every id."New value: +"A dataset id, e.g. ad-costs, attorneys, aviation-accidents, bankruptcy, bar-pipeline. list_datasets lists every id."
  2. Changed1 schema field changed
    • changedInput schema / properties / dataset / description
      Previous value: -"A dataset id, e.g. attorneys, bankruptcy, bar-pipeline, benchmarks, business-applications. list_datasets lists every id."New value: +"A dataset id, e.g. attorneys, aviation-accidents, bankruptcy, bar-pipeline, benchmarks. list_datasets lists every id."
  3. Changed1 schema field changed
    • changedInput schema / properties / dataset / description
      Previous value: -"A dataset id, e.g. bankruptcy, bar-pipeline, benchmarks, business-applications, ca-courts. list_datasets lists every id."New value: +"A dataset id, e.g. attorneys, bankruptcy, bar-pipeline, benchmarks, business-applications. list_datasets lists every id."
  4. Changed2 schema fields changed
    • addedInput schema / properties / dataset / description
      Added value: +"A dataset id, e.g. bankruptcy, bar-pipeline, benchmarks, business-applications, ca-courts. list_datasets lists every id."
    • removedInput schema / properties / dataset / enum
      Removed value: -[
      -  "bankruptcy",
      -  "bar-pipeline",
      -  "benchmarks",
      -  "ca-courts",
      -  "civil-filings",
      -  "consumer-complaints",
      -  "consumer-sentinel",
      -  "criminal-filings",
      -  "crosswalks",
      -  "deserts",
      -  "disability-hearings",
      -  "eeoc-charges",
      -  "fatal-crashes",
      -  "federal-filings-county",
      -  "fees",
      -  "filing",
      -  "findings",
      -  "firm-web-census",
      -  "idb-civil",
      -  "immigration-courts",
      -  "language",
      -  "law-firm-economy",
      -  "law-offices",
      -  "lawyer-wages",
      -  "legal-need",
      -  "legal-prices",
      -  "limitations",
      -  "mdl",
      -  "nursing-homes",
      -  "opinions",
      -  "platforms",
      -  "referral",
      -  "robocall-complaints",
      -  "state-courts",
      -  "truck-crashes",
      -  "va-compensation",
      -  "vehicle-complaints",
      -  "veterans-representation",
      -  "wage-enforcement",
      -  "work-injuries"
      -]
  5. Changed1 schema field changed
    • changedInput schema / properties / dataset / enum
      Previous value: -[
      -  "bankruptcy",
      -  "bar-pipeline",
      -  "benchmarks",
      -  "ca-courts",
      -  "civil-filings",
      -  "consumer-complaints",
      -  "consumer-sentinel",
      -  "criminal-filings",
      -  "crosswalks",
      -  "deserts",
      -  "disability-hearings",
      -  "eeoc-charges",
      -  "fatal-crashes",
      -  "fees",
      -  "filing",
      -  "findings",
      -  "idb-civil",
      -  "immigration-courts",
      -  "language",
      -  "law-firm-economy",
      -  "law-offices",
      -  "lawyer-wages",
      -  "legal-need",
      -  "legal-prices",
      -  "limitations",
      -  "mdl",
      -  "nursing-homes",
      -  "opinions",
      -  "platforms",
      -  "referral",
      -  "robocall-complaints",
      -  "state-courts",
      -  "truck-crashes",
      -  "va-compensation",
      -  "vehicle-complaints",
      -  "veterans-representation",
      -  "wage-enforcement",
      -  "work-injuries"
      -]New value: +[
      +  "bankruptcy",
      +  "bar-pipeline",
      +  "benchmarks",
      +  "ca-courts",
      +  "civil-filings",
      +  "consumer-complaints",
      +  "consumer-sentinel",
      +  "criminal-filings",
      +  "crosswalks",
      +  "deserts",
      +  "disability-hearings",
      +  "eeoc-charges",
      +  "fatal-crashes",
      +  "federal-filings-county",
      +  "fees",
      +  "filing",
      +  "findings",
      +  "firm-web-census",
      +  "idb-civil",
      +  "immigration-courts",
      +  "language",
      +  "law-firm-economy",
      +  "law-offices",
      +  "lawyer-wages",
      +  "legal-need",
      +  "legal-prices",
      +  "limitations",
      +  "mdl",
      +  "nursing-homes",
      +  "opinions",
      +  "platforms",
      +  "referral",
      +  "robocall-complaints",
      +  "state-courts",
      +  "truck-crashes",
      +  "va-compensation",
      +  "vehicle-complaints",
      +  "veterans-representation",
      +  "wage-enforcement",
      +  "work-injuries"
      +]
  6. Changed1 schema field changed
    • changedInput schema / properties / dataset / enum
      Previous value: -[
      -  "bankruptcy",
      -  "bar-pipeline",
      -  "benchmarks",
      -  "ca-courts",
      -  "civil-filings",
      -  "consumer-complaints",
      -  "consumer-sentinel",
      -  "criminal-filings",
      -  "crosswalks",
      -  "deserts",
      -  "disability-hearings",
      -  "eeoc-charges",
      -  "fatal-crashes",
      -  "fees",
      -  "filing",
      -  "idb-civil",
      -  "immigration-courts",
      -  "language",
      -  "law-firm-economy",
      -  "law-offices",
      -  "lawyer-wages",
      -  "legal-need",
      -  "legal-prices",
      -  "limitations",
      -  "mdl",
      -  "nursing-homes",
      -  "opinions",
      -  "platforms",
      -  "referral",
      -  "robocall-complaints",
      -  "state-courts",
      -  "truck-crashes",
      -  "va-compensation",
      -  "vehicle-complaints",
      -  "veterans-representation",
      -  "wage-enforcement",
      -  "work-injuries"
      -]New value: +[
      +  "bankruptcy",
      +  "bar-pipeline",
      +  "benchmarks",
      +  "ca-courts",
      +  "civil-filings",
      +  "consumer-complaints",
      +  "consumer-sentinel",
      +  "criminal-filings",
      +  "crosswalks",
      +  "deserts",
      +  "disability-hearings",
      +  "eeoc-charges",
      +  "fatal-crashes",
      +  "fees",
      +  "filing",
      +  "findings",
      +  "idb-civil",
      +  "immigration-courts",
      +  "language",
      +  "law-firm-economy",
      +  "law-offices",
      +  "lawyer-wages",
      +  "legal-need",
      +  "legal-prices",
      +  "limitations",
      +  "mdl",
      +  "nursing-homes",
      +  "opinions",
      +  "platforms",
      +  "referral",
      +  "robocall-complaints",
      +  "state-courts",
      +  "truck-crashes",
      +  "va-compensation",
      +  "vehicle-complaints",
      +  "veterans-representation",
      +  "wage-enforcement",
      +  "work-injuries"
      +]
  7. Changed2 schema fields changed
    • removedInput schema / properties / detail
      Removed value: -{
      -  "default": "summary",
      -  "enum": [
      -    "summary",
      -    "full"
      -  ],
      -  "type": "string"
      -}
    • addedInput schema / properties / response_format
      Added value: +{
      +  "default": "concise",
      +  "enum": [
      +    "concise",
      +    "detailed"
      +  ],
      +  "type": "string"
      +}
  8. Changed1 schema field changed
    • changedInput schema / properties / dataset / enum
      Previous value: -[
      -  "bankruptcy",
      -  "bar-pipeline",
      -  "benchmarks",
      -  "ca-courts",
      -  "civil-filings",
      -  "consumer-complaints",
      -  "consumer-sentinel",
      -  "crosswalks",
      -  "deserts",
      -  "disability-hearings",
      -  "eeoc-charges",
      -  "fatal-crashes",
      -  "fees",
      -  "filing",
      -  "idb-civil",
      -  "immigration-courts",
      -  "language",
      -  "law-firm-economy",
      -  "law-offices",
      -  "lawyer-wages",
      -  "legal-need",
      -  "legal-prices",
      -  "limitations",
      -  "mdl",
      -  "nursing-homes",
      -  "opinions",
      -  "platforms",
      -  "referral",
      -  "robocall-complaints",
      -  "state-courts",
      -  "truck-crashes",
      -  "veterans-representation",
      -  "work-injuries"
      -]New value: +[
      +  "bankruptcy",
      +  "bar-pipeline",
      +  "benchmarks",
      +  "ca-courts",
      +  "civil-filings",
      +  "consumer-complaints",
      +  "consumer-sentinel",
      +  "criminal-filings",
      +  "crosswalks",
      +  "deserts",
      +  "disability-hearings",
      +  "eeoc-charges",
      +  "fatal-crashes",
      +  "fees",
      +  "filing",
      +  "idb-civil",
      +  "immigration-courts",
      +  "language",
      +  "law-firm-economy",
      +  "law-offices",
      +  "lawyer-wages",
      +  "legal-need",
      +  "legal-prices",
      +  "limitations",
      +  "mdl",
      +  "nursing-homes",
      +  "opinions",
      +  "platforms",
      +  "referral",
      +  "robocall-complaints",
      +  "state-courts",
      +  "truck-crashes",
      +  "va-compensation",
      +  "vehicle-complaints",
      +  "veterans-representation",
      +  "wage-enforcement",
      +  "work-injuries"
      +]
  9. Changed4 schema fields changed
    • removedInput schema / properties / dataset / description
      Removed value: -"Dataset id (list_datasets describes each one)"
    • changedInput schema / properties / dataset / enum
      Previous value: -[
      -  "bankruptcy",
      -  "bar-pipeline",
      -  "benchmarks",
      -  "ca-courts",
      -  "civil-filings",
      -  "consumer-complaints",
      -  "consumer-sentinel",
      -  "crosswalks",
      -  "deserts",
      -  "disability-hearings",
      -  "eeoc-charges",
      -  "fatal-crashes",
      -  "fees",
      -  "filing",
      -  "idb-civil",
      -  "immigration-courts",
      -  "language",
      -  "law-firm-economy",
      -  "law-offices",
      -  "lawyer-wages",
      -  "legal-need",
      -  "legal-prices",
      -  "limitations",
      -  "mdl",
      -  "nursing-homes",
      -  "opinions",
      -  "platforms",
      -  "referral",
      -  "robocall-complaints",
      -  "state-courts",
      -  "veterans-representation",
      -  "work-injuries"
      -]New value: +[
      +  "bankruptcy",
      +  "bar-pipeline",
      +  "benchmarks",
      +  "ca-courts",
      +  "civil-filings",
      +  "consumer-complaints",
      +  "consumer-sentinel",
      +  "crosswalks",
      +  "deserts",
      +  "disability-hearings",
      +  "eeoc-charges",
      +  "fatal-crashes",
      +  "fees",
      +  "filing",
      +  "idb-civil",
      +  "immigration-courts",
      +  "language",
      +  "law-firm-economy",
      +  "law-offices",
      +  "lawyer-wages",
      +  "legal-need",
      +  "legal-prices",
      +  "limitations",
      +  "mdl",
      +  "nursing-homes",
      +  "opinions",
      +  "platforms",
      +  "referral",
      +  "robocall-complaints",
      +  "state-courts",
      +  "truck-crashes",
      +  "veterans-representation",
      +  "work-injuries"
      +]
    • removedInput schema / properties / detail / description
      Removed value: -"summary (default): each record as its id, a 1-2 sentence text, status, date checked, one source URL and the page to cite. full: every field, every source and the per-record provenance."
    • removedOutput schema / properties
      Removed value: -{
      -  "meta": {
      -    "description": "Credit line (attribution), citation, DOI, version, license (CC BY 4.0), disclaimer, notice and the page to cite",
      -    "required": [
      -      "attribution",
      -      "license",
      -      "disclaimer",
      -      "notice"
      -    ],
      -    "type": "object"
      -  },
      -  "nextCursor": {
      -    "description": "Pass as `cursor` to get the next page; null on the last page",
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "provenance": {
      -    "description": "Where this came from: the publisher of the dataset, the dataset and its version DOI, the record id, the original source (who published it and its URL), the day that source was last checked, and when this answer was retrieved",
      -    "properties": {
      -      "citeUrl": {
      -        "description": "The page to cite",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "dataset": {
      -        "description": "Dataset id",
      -        "type": "string"
      -      },
      -      "datasetTitle": {
      -        "type": "string"
      -      },
      -      "dateChecked": {
      -        "description": "YYYY-MM-DD the record was last checked against its source",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "doi": {
      -        "description": "Version DOI",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "doiUrl": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "line": {
      -        "description": "The same facts as one sentence, to quote under an answer",
      -        "type": "string"
      -      },
      -      "publisher": {
      -        "description": "Publisher of the dataset",
      -        "type": "string"
      -      },
      -      "recordId": {
      -        "description": "Stable id of the record",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "retrievedAt": {
      -        "description": "ISO 8601 time this answer was served",
      -        "type": "string"
      -      },
      -      "source": {
      -        "description": "The original source: statute, rule, bar opinion, court report, agency table or platform policy",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "sourceKind": {
      -        "description": "primary or secondary",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "sourceUrl": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "status": {
      -        "description": "P primary source, S secondary, D default (no specific rule found), U open question",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "version": {
      -        "description": "Dataset version",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "publisher",
      -      "dataset",
      -      "version",
      -      "retrievedAt"
      -    ],
      -    "type": "object"
      -  }
      -}
  10. Changed1 schema field changed
    • changedInput schema / properties / dataset / enum
      Previous value: -[
      -  "bankruptcy",
      -  "bar-pipeline",
      -  "benchmarks",
      -  "ca-courts",
      -  "civil-filings",
      -  "consumer-complaints",
      -  "deserts",
      -  "eeoc-charges",
      -  "fatal-crashes",
      -  "fees",
      -  "filing",
      -  "idb-civil",
      -  "immigration-courts",
      -  "language",
      -  "law-firm-economy",
      -  "law-offices",
      -  "lawyer-wages",
      -  "legal-prices",
      -  "limitations",
      -  "mdl",
      -  "opinions",
      -  "platforms",
      -  "referral",
      -  "robocall-complaints",
      -  "state-courts",
      -  "veterans-representation",
      -  "work-injuries"
      -]New value: +[
      +  "bankruptcy",
      +  "bar-pipeline",
      +  "benchmarks",
      +  "ca-courts",
      +  "civil-filings",
      +  "consumer-complaints",
      +  "consumer-sentinel",
      +  "crosswalks",
      +  "deserts",
      +  "disability-hearings",
      +  "eeoc-charges",
      +  "fatal-crashes",
      +  "fees",
      +  "filing",
      +  "idb-civil",
      +  "immigration-courts",
      +  "language",
      +  "law-firm-economy",
      +  "law-offices",
      +  "lawyer-wages",
      +  "legal-need",
      +  "legal-prices",
      +  "limitations",
      +  "mdl",
      +  "nursing-homes",
      +  "opinions",
      +  "platforms",
      +  "referral",
      +  "robocall-complaints",
      +  "state-courts",
      +  "veterans-representation",
      +  "work-injuries"
      +]
  11. Changed1 schema field changed
    • changedInput schema / properties / dataset / enum
      Previous value: -[
      -  "bar-pipeline",
      -  "benchmarks",
      -  "ca-courts",
      -  "civil-filings",
      -  "consumer-complaints",
      -  "deserts",
      -  "eeoc-charges",
      -  "fatal-crashes",
      -  "fees",
      -  "filing",
      -  "language",
      -  "law-offices",
      -  "lawyer-wages",
      -  "legal-prices",
      -  "limitations",
      -  "mdl",
      -  "opinions",
      -  "platforms",
      -  "referral",
      -  "robocall-complaints",
      -  "state-courts"
      -]New value: +[
      +  "bankruptcy",
      +  "bar-pipeline",
      +  "benchmarks",
      +  "ca-courts",
      +  "civil-filings",
      +  "consumer-complaints",
      +  "deserts",
      +  "eeoc-charges",
      +  "fatal-crashes",
      +  "fees",
      +  "filing",
      +  "idb-civil",
      +  "immigration-courts",
      +  "language",
      +  "law-firm-economy",
      +  "law-offices",
      +  "lawyer-wages",
      +  "legal-prices",
      +  "limitations",
      +  "mdl",
      +  "opinions",
      +  "platforms",
      +  "referral",
      +  "robocall-complaints",
      +  "state-courts",
      +  "veterans-representation",
      +  "work-injuries"
      +]
  12. Changed1 schema field changed
    • changedInput schema / properties / dataset / enum
      Previous value: -[
      -  "benchmarks",
      -  "ca-courts",
      -  "fees",
      -  "filing",
      -  "language",
      -  "mdl",
      -  "opinions",
      -  "platforms",
      -  "referral"
      -]New value: +[
      +  "bar-pipeline",
      +  "benchmarks",
      +  "ca-courts",
      +  "civil-filings",
      +  "consumer-complaints",
      +  "deserts",
      +  "eeoc-charges",
      +  "fatal-crashes",
      +  "fees",
      +  "filing",
      +  "language",
      +  "law-offices",
      +  "lawyer-wages",
      +  "legal-prices",
      +  "limitations",
      +  "mdl",
      +  "opinions",
      +  "platforms",
      +  "referral",
      +  "robocall-complaints",
      +  "state-courts"
      +]
  13. Changed2 schema fields changed
    • changedInput schema / properties / dataset / enum
      Previous value: -[
      -  "ca-courts",
      -  "fees",
      -  "filing",
      -  "language",
      -  "mdl",
      -  "opinions",
      -  "platforms"
      -]New value: +[
      +  "benchmarks",
      +  "ca-courts",
      +  "fees",
      +  "filing",
      +  "language",
      +  "mdl",
      +  "opinions",
      +  "platforms",
      +  "referral"
      +]
    • addedInput schema / properties / detail
      Added value: +{
      +  "default": "summary",
      +  "description": "summary (default): each record as its id, a 1-2 sentence text, status, date checked, one source URL and the page to cite. full: every field, every source and the per-record provenance.",
      +  "enum": [
      +    "summary",
      +    "full"
      +  ],
      +  "type": "string"
      +}
  14. Added

TDQS

A3.5/5.0
Behavior3/5

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

Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false and openWorldHint=false, so the safety profile is covered without the description. The description adds the 10-key comparison cap (also in schema maxItems) and a 'not legal advice' caveat, but says nothing about what the side-by-side result looks like or how keys that don't exist in a dataset are handled. Modest added value over annotations.

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?

A single front-loaded capability sentence followed by a short domain-appropriate disclaimer; little waste. The 'not legal advice' sentence earns a place in a legal-adjacent tool, though the schema-duplicating 'up to 10' is mildly redundant with maxItems.

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 and annotations are rich, so return format and safety need not be described. What remains missing — how this differs from compare_states and what response_format changes — are moderate gaps rather than blockers for a 2-required-parameter read tool.

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

Parameters3/5

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

Schema coverage is only 33% — dataset is documented in-schema while keys and response_format are not. The description partially compensates for `keys` by naming acceptable key types (states, counties or other) and the 10-item ceiling, but it never explains `response_format` or the concise/detailed tradeoff, leaving one of three parameters fully unexplained.

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 (compare), resource (keys of one dataset) and a concrete limit (up to 10), with examples of the key granularity (states, counties). It does not distinguish itself from the sibling compare_states, which reads as a near-synonym, so the purpose is clear but not fully disambiguated.

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

Usage Guidelines3/5

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

The examples ('lawyer pay or bar pass rates in two states') imply when the tool is appropriate, but there is no explicit when-to-use versus compare_states, data_lookup, or data_search, and no stated prerequisites such as needing a valid dataset id first. Usage has to be inferred from the example, not from a rule.

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.