Skip to main content
Glama

us-lobbying-mcp-server

Uslobbying Get Client Profile

uslobbying_get_client_profile
Read-onlyIdempotent

Resolve client relationship records by client_name in mode resolve (default), then use mode profile with explicit client_ids and years. Select candidates[].id, preserving secondary client_id as source data. IDs identify registrant relationships, not a verified corporate identity. Follow collecting cursors before interpreting separate income and expense ledgers. Typed rows preserve every audit filing; activity descriptions and lobbyist lists appear in them only when include names them, and a selected filing UUID passed to uslobbying_search_filings returns its complete record. Optional canvas datasets support SQL.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "uslobbying_get_client_profile"
  }
}

Input Schema

NameRequiredDescriptionDefault
modeNoresolve (default) finds client_name candidates; profile requires selected client_ids and years. Omit on continuation.
yearsNoRequired explicit analytical year scope; sorted and deduplicated.
cursorNoContinue the original scope; omit the other fields or repeat them unchanged, since a changed value (page_size included) fails cursor_invalid. Only max_pages may change per call.
includeNoProfile mode only: lobbying-activity fields to return in selected_filings, raw_filings and activities, activity_descriptions (description) and activity_lobbyists (lobbyists). Fields left out are removed from delivered rows only; totals and SQL datasets are unaffected. Default []. Fixed for the scan: a continuation omits it or repeats it unchanged.
row_setsNoInline analytical sets; omit for all sets. Selection never limits acquisition, totals or SQL staging. Omitted sets remain available from a new call with another selection or staged tables. On a continuation, omit row_sets or list the sets of the first call in any order; listing every set after a first call that omitted row_sets fails cursor_invalid.
canvas_idNoReuse this canvas only after complete analytical acquisition.
max_pagesNoMost upstream pages fetched per call, at most 5; larger values clamp and are disclosed in delivery_limits. Discovery fetches only while fewer than page_size matches are pending. Default one for discovery, five for analysis.
page_sizeNoWhole records delivered per call: candidates in resolve mode (default 25, at most 25), analytical rows in profile mode (default 25, at most 250). Larger values clamp to the mode's ceiling and are disclosed in delivery_limits. Not the upstream page size; a page is short only at the end of the result or while acquisition is still collecting.
client_idsNoRequired explicit relationship record IDs from candidates[].id in profile mode; candidates[].client_id is a secondary source number.
client_nameNoRequired literal name in resolve mode.

Output Schema

NameRequiredDescriptionDefault
modeNoClient resolution or selected relationship analysis.
errorNoPresent when the call failed. Absent on success.
firmsNoFirm breakdowns in this window.
yearsNoExplicit requested years.
offsetNoRecords delivered before this window.
sourceNoOfficial source system.
statusNoSource acquisition status, separate from row delivery.
clientsNoClient relationship breakdowns in this window.
datasetNoComplete SQL metadata on the first final window and its replay.
noticesNoLimitations and success notices.
coverageNoAcquisition progress, independent of delivery.
guidanceNoNext profile-mode selection step.
canvas_idNoTenant-scoped canvas access token.
truncatedNoMore data is available through next_cursor; no source data was discarded.
activitiesNoSelected activities in this window, with no money columns; description and lobbyists appear only when include names them.
candidatesNoAll matching relationships; never auto-merged.
client_idsNoCaller-selected client relationship IDs.
query_toolNoQuery or retrieve materialized table rows.
selectionsNoVersion-selection decisions in this window.
attributionNoRequired verbatim attribution for LDA data.
issue_codesNoOverlapping issue breakdowns in this window; with issue_code set, every row covers only selected filings that also mention issue_code.
methodologyNoAccounting limitations.
next_cursorNoNext acquisition or output window cursor.
raw_filingsNoAll acquired versions in this window, including selected versions; activity description and lobbyists appear only when include names them.
retrieved_atNoRetrieval ISO timestamp.
describe_toolNoInspect exact table schemas before SQL.
total_recordsNoExact final record count when known.
annual_ledgersNoComplete-year ledgers in this window; absent while collecting.
row_set_totalsNoExact all-set totals after acquisition completes.
delivery_limitsNoClamped controls for this call; an empty map means no clamp. Immediate cursor replay retains its original values.
output_completeNoWhether all result rows have been delivered.
row_set_offsetsNoSelected-set rows delivered before this window; others zero.
canvas_availableNoSQL canvas support is enabled.
records_returnedNoWhole records delivered in this window.
selected_filingsNoSelected filings in this window; activity description and lobbyists appear only when include names them.
attribution_basisNoWhole filings mentioning an issue; buckets overlap.
cursor_expires_atNoContinuation expiry ISO timestamp.
effective_filtersNoNormalized effective scope.
targeted_entitiesNoTargeted entities in this window.
snapshot_source_urlsNoOfficial snapshot URLs.
snapshot_retrieved_atNoFARA snapshot retrieval timestamp.
snapshot_last_modifiedNoUpstream Last-Modified header.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed35 schema fields changed
    • changedInput schema / properties / cursor / description
      Previous value: -"Continue the original scope; other query fields may be omitted."New value: +"Continue the original scope; omit the other fields or repeat them unchanged, since a changed value (page_size included) fails cursor_invalid. Only max_pages may change per call."
    • addedInput schema / properties / include
      Added value: +{
      +  "description": "Profile mode only: lobbying-activity fields to return in selected_filings, raw_filings and activities, activity_descriptions (description) and activity_lobbyists (lobbyists). Fields left out are removed from delivered rows only; totals and SQL datasets are unaffected. Default []. Fixed for the scan: a continuation omits it or repeats it unchanged.",
      +  "items": {
      +    "enum": [
      +      "activity_descriptions",
      +      "activity_lobbyists"
      +    ],
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / max_pages / description
      Previous value: -"Source pages per call; positive integers clamp to five, default one for discovery, five for analysis."New value: +"Most upstream pages fetched per call, at most 5; larger values clamp and are disclosed in delivery_limits. Discovery fetches only while fewer than page_size matches are pending. Default one for discovery, five for analysis."
    • changedInput schema / properties / page_size / description
      Previous value: -"Upstream rows per page; positive integers clamp to 25, default 25."New value: +"Whole records delivered per call: candidates in resolve mode (default 25, at most 25), analytical rows in profile mode (default 25, at most 250). Larger values clamp to the mode's ceiling and are disclosed in delivery_limits. Not the upstream page size; a page is short only at the end of the result or while acquisition is still collecting."
    • removedInput schema / properties / record_handle
      Removed value: -{
      -  "description": "Tenant/tool-bound deferred record handle.",
      -  "type": "string"
      -}
    • removedInput schema / properties / record_limit
      Removed value: -{
      -  "default": 25,
      -  "description": "Maximum object entries or array items, clamped to 25; text fragments use the response byte budget.",
      -  "minimum": 1,
      -  "multipleOf": 1,
      -  "type": "number"
      -}
    • removedInput schema / properties / record_offset
      Removed value: -{
      -  "default": 0,
      -  "description": "Key, item or Unicode-code-point offset.",
      -  "maximum": 9007199254740991,
      -  "minimum": 0,
      -  "type": "integer"
      -}
    • removedInput schema / properties / record_path
      Removed value: -{
      -  "default": "",
      -  "description": "JSON Pointer to a stored value; empty selects the root.",
      -  "type": "string"
      -}
    • changedInput schema / properties / row_sets / description
      Previous value: -"Inline analytical sets; omit for all sets. Selection never limits acquisition, totals or SQL staging. Omitted sets remain available from a new call with another selection or staged tables. Continue with omitted or equivalent row_sets."New value: +"Inline analytical sets; omit for all sets. Selection never limits acquisition, totals or SQL staging. Omitted sets remain available from a new call with another selection or staged tables. On a continuation, omit row_sets or list the sets of the first call in any order; listing every set after a first call that omitted row_sets fails cursor_invalid."
    • changedInput schema / properties / row_sets / items / enum
      Previous value: -[
      -  "annual_ledgers",
      -  "selections",
      -  "firms",
      -  "issue_codes",
      -  "targeted_entities",
      -  "selected_filings",
      -  "activities",
      -  "raw_filings"
      -]New value: +[
      +  "annual_ledgers",
      +  "selections",
      +  "firms",
      +  "clients",
      +  "issue_codes",
      +  "targeted_entities",
      +  "selected_filings",
      +  "activities",
      +  "raw_filings"
      +]
    • changedOutput schema / $defs / LdaAnnualLedger / properties / ambiguous_group_count / description
      Previous value: -"Equal-latest groups excluded from sums."New value: +"Equal-latest groups excluded from sums; counted on annual_ledgers, always 0 on firm, client and issue breakdown ledgers."
    • changedOutput schema / properties / activities / description
      Previous value: -"Selected activities in this window; no money columns."New value: +"Selected activities in this window, with no money columns; description and lobbyists appear only when include names them."
    • addedOutput schema / properties / clients
      Added value: +{
      +  "description": "Client relationship breakdowns in this window.",
      +  "items": {
      +    "additionalProperties": false,
      +    "description": "Client relationship breakdown; each selected filing belongs to exactly one.",
      +    "properties": {
      +      "annual_ledgers": {
      +        "description": "Relationship year ledgers.",
      +        "items": {
      +          "$ref": "#/$defs/LdaAnnualLedger"
      +        },
      +        "type": "array"
      +      },
      +      "client_id": {
      +        "description": "Client relationship record ID.",
      +        "type": "string"
      +      },
      +      "filing_uuids": {
      +        "description": "Selected report UUIDs.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "name": {
      +        "description": "Client name.",
      +        "type": "string"
      +      },
      +      "registrant_id": {
      +        "description": "Firm ID of this relationship.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "client_id",
      +      "name",
      +      "registrant_id",
      +      "filing_uuids",
      +      "annual_ledgers"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / properties / error / properties / data / properties / reason / description
      Previous value: -"Machine-readable failure mode. Declared by this tool: `invalid_filter`: Invalid scope, identifier, reference code or mode combination. `cursor_invalid`: Unknown, expired, stale or mismatched continuation. `acquisition_storage_unavailable`: Storage cannot safely retain a checkpoint. `pagination_invalid`: Invalid or nonprogressing upstream pagination. `source_schema_changed`: Successful source response violates its verified schema. `canvas_unavailable`: Explicit staging without a configured canvas. `canvas_not_found`: Supplied canvas expired or unknown. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `invalid_filter`: Invalid scope, identifier, reference code or mode combination, or an over-cap page_size or max_pages while clamping is disabled. `cursor_invalid`: Unknown, expired, stale or mismatched continuation. `acquisition_storage_unavailable`: Storage cannot safely retain a checkpoint. `pagination_invalid`: Invalid or nonprogressing upstream pagination. `source_schema_changed`: Successful source response violates its verified schema. `canvas_unavailable`: Explicit staging without a configured canvas. `canvas_not_found`: Supplied canvas expired or unknown. Other values are possible when a failure originates below the handler."
    • changedOutput schema / properties / issue_codes / description
      Previous value: -"Overlapping issue breakdowns in this window."New value: +"Overlapping issue breakdowns in this window; with issue_code set, every row covers only selected filings that also mention issue_code."
    • changedOutput schema / properties / methodology / properties / client_identity / const
      Previous value: -"caller_selected_relationships"New value: +"relationship_records"
    • changedOutput schema / properties / methodology / properties / client_identity / description
      Previous value: -"No corporate identity is inferred."New value: +"Each client is one relationship record; no corporate identity is inferred."
    • changedOutput schema / properties / methodology / properties / selection_method / description
      Previous value: -"Latest posting within relationship and quarter."New value: +"Latest posting within relationship and reporting period, quarter or half-year."
    • changedOutput schema / properties / mode / description
      Previous value: -"Client resolution or selected relationship analysis; absent on stored-record retrieval."New value: +"Client resolution or selected relationship analysis."
    • changedOutput schema / properties / offset / description
      Previous value: -"Final record delivery offset."New value: +"Records delivered before this window."
    • changedOutput schema / properties / raw_filings / description
      Previous value: -"All acquired versions in this window, including selected versions."New value: +"All acquired versions in this window, including selected versions; activity description and lobbyists appear only when include names them."
    • removedOutput schema / properties / record_handles
      Removed value: -{
      -  "description": "Deferred complete parents.",
      -  "items": {
      -    "additionalProperties": false,
      -    "description": "Deferred parent retrieval.",
      -    "properties": {
      -      "expires_at": {
      -        "description": "Retained parent expiry ISO timestamp.",
      -        "type": "string"
      -      },
      -      "record_bytes": {
      -        "description": "Serialized parent UTF-8 bytes.",
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "record_handle": {
      -        "description": "Opaque retained parent handle.",
      -        "type": "string"
      -      },
      -      "retrieval_tool": {
      -        "description": "Source tool for record windows.",
      -        "type": "string"
      -      },
      -      "source_id": {
      -        "description": "Original source identity.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "record_handle",
      -      "source_id",
      -      "record_bytes",
      -      "expires_at",
      -      "retrieval_tool"
      -    ],
      -    "type": "object"
      -  },
      -  "type": "array"
      -}
    • removedOutput schema / properties / record_window
      Removed value: -{
      -  "description": "Lossless stored parent window.",
      -  "oneOf": [
      -    {
      -      "additionalProperties": false,
      -      "description": "Complete or deferred object children.",
      -      "properties": {
      -        "complete": {
      -          "description": "This path and included children are fully delivered.",
      -          "type": "boolean"
      -        },
      -        "entries": {
      -          "description": "Key-ordered object window.",
      -          "items": {
      -            "additionalProperties": false,
      -            "description": "Key and pointer; value only when it fits.",
      -            "properties": {
      -              "key": {
      -                "description": "Original key.",
      -                "type": "string"
      -              },
      -              "path": {
      -                "description": "Child JSON Pointer.",
      -                "type": "string"
      -              },
      -              "value": {
      -                "$ref": "#/$defs/__schema0",
      -                "description": "Whole child value only when it fits."
      -              }
      -            },
      -            "required": [
      -              "key",
      -              "path"
      -            ],
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "kind": {
      -          "const": "object",
      -          "description": "Object-entry window.",
      -          "type": "string"
      -        },
      -        "next_offset": {
      -          "description": "Next undelivered position.",
      -          "maximum": 9007199254740991,
      -          "minimum": 0,
      -          "type": "integer"
      -        },
      -        "offset": {
      -          "description": "Start position.",
      -          "maximum": 9007199254740991,
      -          "minimum": 0,
      -          "type": "integer"
      -        },
      -        "path": {
      -          "description": "Selected JSON Pointer.",
      -          "type": "string"
      -        },
      -        "record_handle": {
      -          "description": "Stored parent handle.",
      -          "type": "string"
      -        },
      -        "returned": {
      -          "description": "Delivered entries or code points.",
      -          "maximum": 9007199254740991,
      -          "minimum": 0,
      -          "type": "integer"
      -        },
      -        "total": {
      -          "description": "Total keys, items or code points at this path.",
      -          "maximum": 9007199254740991,
      -          "minimum": 0,
      -          "type": "integer"
      -        }
      -      },
      -      "required": [
      -        "record_handle",
      -        "path",
      -        "total",
      -        "offset",
      -        "returned",
      -        "complete",
      -        "kind",
      -        "entries"
      -      ],
      -      "type": "object"
      -    },
      -    {
      -      "additionalProperties": false,
      -      "description": "Array items preserving original indexes.",
      -      "properties": {
      -        "complete": {
      -          "description": "This path and included children are fully delivered.",
      -          "type": "boolean"
      -        },
      -        "items": {
      -          "description": "Indexed array window.",
      -          "items": {
      -            "additionalProperties": false,
      -            "description": "Original index and child pointer.",
      -            "properties": {
      -              "index": {
      -                "description": "Original child index.",
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              "path": {
      -                "description": "Child JSON Pointer.",
      -                "type": "string"
      -              },
      -              "value": {
      -                "$ref": "#/$defs/__schema0",
      -                "description": "Whole child value only when it fits."
      -              }
      -            },
      -            "required": [
      -              "index",
      -              "path"
      -            ],
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "kind": {
      -          "const": "array",
      -          "description": "Array-item window.",
      -          "type": "string"
      -        },
      -        "next_offset": {
      -          "description": "Next undelivered position.",
      -          "maximum": 9007199254740991,
      -          "minimum": 0,
      -          "type": "integer"
      -        },
      -        "offset": {
      -          "description": "Start position.",
      -          "maximum": 9007199254740991,
      -          "minimum": 0,
      -          "type": "integer"
      -        },
      -        "path": {
      -          "description": "Selected JSON Pointer.",
      -          "type": "string"
      -        },
      -        "record_handle": {
      -          "description": "Stored parent handle.",
      -          "type": "string"
      -        },
      -        "returned": {
      -          "description": "Delivered entries or code points.",
      -          "maximum": 9007199254740991,
      -          "minimum": 0,
      -          "type": "integer"
      -        },
      -        "total": {
      -          "description": "Total keys, items or code points at this path.",
      -          "maximum": 9007199254740991,
      -          "minimum": 0,
      -          "type": "integer"
      -        }
      -      },
      -      "required": [
      -        "record_handle",
      -        "path",
      -        "total",
      -        "offset",
      -        "returned",
      -        "complete",
      -        "kind",
      -        "items"
      -      ],
      -      "type": "object"
      -    },
      -    {
      -      "additionalProperties": false,
      -      "description": "Unicode-code-point text fragment.",
      -      "properties": {
      -        "complete": {
      -          "description": "This path and included children are fully delivered.",
      -          "type": "boolean"
      -        },
      -        "kind": {
      -          "const": "string",
      -          "description": "Unicode text window.",
      -          "type": "string"
      -        },
      -        "next_offset": {
      -          "description": "Next undelivered position.",
      -          "maximum": 9007199254740991,
      -          "minimum": 0,
      -          "type": "integer"
      -        },
      -        "offset": {
      -          "description": "Start position.",
      -          "maximum": 9007199254740991,
      -          "minimum": 0,
      -          "type": "integer"
      -        },
      -        "path": {
      -          "description": "Selected JSON Pointer.",
      -          "type": "string"
      -        },
      -        "record_handle": {
      -          "description": "Stored parent handle.",
      -          "type": "string"
      -        },
      -        "returned": {
      -          "description": "Delivered entries or code points.",
      -          "maximum": 9007199254740991,
      -          "minimum": 0,
      -          "type": "integer"
      -        },
      -        "text": {
      -          "description": "Complete-code-point text fragment.",
      -          "type": "string"
      -        },
      -        "total": {
      -          "description": "Total keys, items or code points at this path.",
      -          "maximum": 9007199254740991,
      -          "minimum": 0,
      -          "type": "integer"
      -        }
      -      },
      -      "required": [
      -        "record_handle",
      -        "path",
      -        "total",
      -        "offset",
      -        "returned",
      -        "complete",
      -        "kind",
      -        "text"
      -      ],
      -      "type": "object"
      -    },
      -    {
      -      "additionalProperties": false,
      -      "description": "Unfragmented non-text scalar.",
      -      "properties": {
      -        "complete": {
      -          "description": "This path and included children are fully delivered.",
      -          "type": "boolean"
      -        },
      -        "kind": {
      -          "const": "scalar",
      -          "description": "Complete scalar value.",
      -          "type": "string"
      -        },
      -        "next_offset": {
      -          "description": "Next undelivered position.",
      -          "maximum": 9007199254740991,
      -          "minimum": 0,
      -          "type": "integer"
      -        },
      -        "offset": {
      -          "description": "Start position.",
      -          "maximum": 9007199254740991,
      -          "minimum": 0,
      -          "type": "integer"
      -        },
      -        "path": {
      -          "description": "Selected JSON Pointer.",
      -          "type": "string"
      -        },
      -        "record_handle": {
      -          "description": "Stored parent handle.",
      -          "type": "string"
      -        },
      -        "returned": {
      -          "description": "Delivered entries or code points.",
      -          "maximum": 9007199254740991,
      -          "minimum": 0,
      -          "type": "integer"
      -        },
      -        "total": {
      -          "description": "Total keys, items or code points at this path.",
      -          "maximum": 9007199254740991,
      -          "minimum": 0,
      -          "type": "integer"
      -        },
      -        "value": {
      -          "anyOf": [
      -            {
      -              "description": "Null value.",
      -              "type": "null"
      -            },
      -            {
      -              "description": "Boolean value.",
      -              "type": "boolean"
      -            },
      -            {
      -              "description": "Finite numeric value.",
      -              "type": "number"
      -            }
      -          ],
      -          "description": "Exact scalar value."
      -        }
      -      },
      -      "required": [
      -        "record_handle",
      -        "path",
      -        "total",
      -        "offset",
      -        "returned",
      -        "complete",
      -        "kind",
      -        "value"
      -      ],
      -      "type": "object"
      -    }
      -  ]
      -}
    • removedOutput schema / properties / records_deferred
      Removed value: -{
      -  "description": "Oversized parents available through handles.",
      -  "maximum": 9007199254740991,
      -  "minimum": 0,
      -  "type": "integer"
      -}
    • changedOutput schema / properties / records_returned / description
      Previous value: -"Complete records delivered in this window."New value: +"Whole records delivered in this window."
    • removedOutput schema / properties / retrieval_tool
      Removed value: -{
      -  "description": "Tool that retrieves this parent.",
      -  "type": "string"
      -}
    • changedOutput schema / properties / row_set_offsets / description
      Previous value: -"Selected-set rows delivered or deferred before this window; others zero."New value: +"Selected-set rows delivered before this window; others zero."
    • addedOutput schema / properties / row_set_offsets / properties / clients
      Added value: +{
      +  "description": "Client relationship breakdown records.",
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • changedOutput schema / properties / row_set_offsets / required
      Previous value: -[
      -  "annual_ledgers",
      -  "selections",
      -  "firms",
      -  "issue_codes",
      -  "targeted_entities",
      -  "selected_filings",
      -  "activities",
      -  "raw_filings"
      -]New value: +[
      +  "annual_ledgers",
      +  "selections",
      +  "firms",
      +  "clients",
      +  "issue_codes",
      +  "targeted_entities",
      +  "selected_filings",
      +  "activities",
      +  "raw_filings"
      +]
    • addedOutput schema / properties / row_set_totals / properties / clients
      Added value: +{
      +  "description": "Client relationship breakdown records.",
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • changedOutput schema / properties / row_set_totals / required
      Previous value: -[
      -  "annual_ledgers",
      -  "selections",
      -  "firms",
      -  "issue_codes",
      -  "targeted_entities",
      -  "selected_filings",
      -  "activities",
      -  "raw_filings"
      -]New value: +[
      +  "annual_ledgers",
      +  "selections",
      +  "firms",
      +  "clients",
      +  "issue_codes",
      +  "targeted_entities",
      +  "selected_filings",
      +  "activities",
      +  "raw_filings"
      +]
    • changedOutput schema / properties / selected_filings / description
      Previous value: -"Complete selected filings in this window."New value: +"Selected filings in this window; activity description and lobbyists appear only when include names them."
    • changedOutput schema / properties / selections / items / properties / exclusion_reason / description
      Previous value: -"Why excluded."New value: +"Why excluded. non_quarterly: a period that is neither quarterly nor semiannual. off_cycle_period: a quarterly period through 2007 or semiannual period from 2008, in a registrant/client/year that also filed the statutory grain."
    • changedOutput schema / properties / selections / items / properties / exclusion_reason / enum
      Previous value: -[
      -  "registration",
      -  "non_quarterly",
      -  "unknown_variant",
      -  "missing_relationship"
      -]New value: +[
      +  "registration",
      +  "non_quarterly",
      +  "off_cycle_period",
      +  "unknown_variant",
      +  "missing_relationship"
      +]
    • changedOutput schema / properties / truncated / description
      Previous value: -"More data is available through next_cursor or record_handles; no source data was discarded."New value: +"More data is available through next_cursor; no source data was discarded."
  2. First observed

TDQS

A3.8/5.0
Behavior4/5

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

Beyond the readOnly/openWorld/idempotent annotations, it discloses important semantics: IDs identify registrant relationships rather than a verified corporate identity, include controls which fields survive into delivered rows, and cursor continuation must precede ledger interpretation. Some of these statements are compressed to the point of ambiguity, keeping it from a 5.

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

Conciseness3/5

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

It is front-loaded with the resolve-then-profile workflow, which is the right structure, but the remaining sentences are tightly packed jargon ('typed rows preserve every audit filing', 'follow collecting cursors') that reads as compressed notes rather than clear instructions. Length is justified by complexity; clarity is not.

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?

For a 10-parameter, two-mode tool with an output schema, the description covers the workflow, cursor discipline, field selection, and the registrant-vs-corporate caveat. The brief mention of canvas datasets for SQL is the main underspecified element, but everything an agent needs to call it correctly is present.

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 description coverage is 100%, so the schema already carries mode, cursor, include, row_sets and page_size semantics. The description reinforces that client_ids come from candidates[].id and that client_id is secondary source data, but adds little the schema does not already state.

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?

The description states a specific two-stage operation: resolve client_name candidates, then switch to profile mode with client_ids and years. It is clearly not a plain search and is differentiated from uslobbying_search_filings by being the workflow that feeds filing UUIDs into it. The dense, jargon-heavy delivery prevents a 5.

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

Usage Guidelines4/5

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

It gives an explicit ordering rule (resolve first, profile second, with required client_ids and years), instructs the agent to follow collecting cursors before interpreting ledgers, and names uslobbying_search_filings as the downstream alternative. It stops short of stating when not to use this tool or how it relates to the other siblings.

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.