Skip to main content
Glama

us-lobbying-mcp-server

Uslobbying Get Contributions

uslobbying_get_contributions
Read-onlyIdempotent

Retrieve complete semiannual LD-203 reports, contributions, PAC relationships and certifications, preserving original and amended reports. Child predicates must match the same item; full parent contribution lists and matched_item_indexes remain available. Report counts are not donation counts and no cross-report donation total is inferred.

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_contributions"
  }
}

Input Schema

NameRequiredDescriptionDefault
payeeNoCase-insensitive literal payee substring.
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.
honoreeNoCase-insensitive literal honoree substring.
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 LD-203 reports delivered per call, each with its complete contribution list: default 10, at most 25; larger values clamp to it 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.
amount_maxNoInclusive local same-item maximum exact decimal USD; complete parent lists remain available.
amount_minNoInclusive local same-item minimum exact decimal USD; complete parent lists remain available.
contributorNoCase-insensitive literal contributor substring.
filing_yearNoRequired first-call reporting year, 2008 through current UTC year.
lobbyist_idNoLobbyist filer ID.
filing_periodNoSemiannual period.
lobbyist_nameNoLobbyist name upstream search.
registrant_idNoRegistrant ID.
registrant_nameNoRegistrant name upstream search.
contribution_typeNoOfficial feca, he, me, ple or pic payment code.
contribution_date_afterNoInclusive earliest item calendar date.
contribution_date_beforeNoInclusive latest item calendar date.

Output Schema

NameRequiredDescriptionDefault
errorNoPresent when the call failed. Absent on success.
offsetNoRecords delivered before this window.
sourceNoOfficial source system.
noticesNoLimitations and success notices.
reportsNoFull parent reports and complete child lists.
coverageNoAcquisition progress, independent of delivery.
truncatedNoMore data is available through next_cursor; no source data was discarded.
attributionNoRequired verbatim attribution for LDA data.
next_cursorNoNext acquisition or output window cursor.
retrieved_atNoRetrieval ISO timestamp.
total_recordsNoExact final record count when known.
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.
amendment_policyNoAmendments remain separate reports.
records_returnedNoWhole records delivered in this window.
cursor_expires_atNoContinuation expiry ISO timestamp.
effective_filtersNoNormalized effective scope.
item_count_in_batchNoItems in returned complete parent lists.
snapshot_source_urlsNoOfficial snapshot URLs.
report_count_in_batchNoComplete parent reports returned.
snapshot_retrieved_atNoFARA snapshot retrieval timestamp.
snapshot_last_modifiedNoUpstream Last-Modified header.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed15 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."
    • 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 LD-203 reports delivered per call, each with its complete contribution list: default 10, at most 25; larger values clamp to it 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"
      -}
    • 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. 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. Other values are possible when a failure originates below the handler."
    • changedOutput schema / properties / offset / description
      Previous value: -"Final record delivery offset."New value: +"Records delivered before this window."
    • 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 / truncated / description
      Previous value: -"More of the parent value remains available through record windows."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?

Annotations already declare readOnly, idempotent and open-world, so the safety profile is covered; the description adds genuinely new behavior: original and amended reports are both preserved, parent contribution lists and matched_item_indexes remain available after filtering, and no cross-report donation total is inferred. Those aggregation semantics are exactly what an agent could otherwise get wrong. It stops short of covering pagination/cursor behavior or acquisition-in-progress states, which live in the schema.

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?

Four sentences, front-loaded with what is retrieved, then constraints, then aggregation caveats — no filler. The wording is compressed to the point that a phrase like 'child predicates' and 'matched_item_indexes' is opaque without opening the schema, which slightly hurts first-read clarity.

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 17-parameter, high-complexity tool with a full schema and an output schema, the description supplies the missing conceptual model: what a delivered unit is (a whole report with its contribution list), how filters combine, and what is deliberately not computed. Only the first-call requirement of filing_year and cursor reuse rules are left to the schema, which is acceptable given 100% coverage.

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?

Schema coverage is 100%, so baseline would be 3, but the description adds meaning the schema does not: child predicates (amount and date bounds, contributor, payee, honoree) are matched against the same contribution item, and parent lists are still returned in full so a filtered amount does not truncate the report. That clarifies the most error-prone interaction among the 17 parameters.

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 first sentence names a specific verb and resource — retrieve complete semiannual LD-203 reports with contributions, PAC relationships and certifications — and notes that amended reports are preserved alongside originals. That is far more specific than a name restatement. It doesn't explicitly route against siblings such as search_filings, but the LD-203 contribution focus is distinctive enough to select on.

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 description implies context (filtering child contributions inside LD-203 reports) and adds a real usage constraint — 'Child predicates must match the same item' — but never states when to use this versus search_filings or get_issue_spending, nor any prerequisites beyond what the schema encodes. Guidance is present but must be inferred from the schema.

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.