get_nomination
Retrieve specific nomination data from the U.S. Congress.gov API by filtering by congress number, nomination number, date range, or result limits to access official government nomination records.
Instructions
Retrieve nomination information from the Congress.gov API. Full documentation for this endpoint -> https://github.com/LibraryOfCongress/api.congress.gov/blob/main/Documentation/NominationEndpoint.md
Args: congress: Congress number (e.g., 118 for 118th Congress) nomination_number: Specific nomination number offset: Starting record (default 0) limit: Maximum records to return (max 250, default 20) from_datetime: Start timestamp (YYYY-MM-DDTHH:MM:SSZ format) to_datetime: End timestamp (YYYY-MM-DDTHH:MM:SSZ format)
Returns: dict: Nomination data from Congress.gov API
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| congress | No | ||
| from_datetime | No | ||
| limit | No | ||
| nomination_number | No | ||
| offset | No | ||
| to_datetime | No |
Implementation Reference
- server.py:1029-1081 (handler)MCP tool handler implementation for 'get_nomination'. Decorated with @mcp.tool(), it queries the Congress.gov API for nomination data based on provided parameters.@mcp.tool() async def get_nomination( congress: int | None = None, nomination_number: int | None = None, offset: int = 0, limit: int = 20, from_datetime: str | None = None, to_datetime: str | None = None ) -> dict: """ Retrieve nomination information from the Congress.gov API. Full documentation for this endpoint -> https://github.com/LibraryOfCongress/api.congress.gov/blob/main/Documentation/NominationEndpoint.md Args: congress: Congress number (e.g., 118 for 118th Congress) nomination_number: Specific nomination number offset: Starting record (default 0) limit: Maximum records to return (max 250, default 20) from_datetime: Start timestamp (YYYY-MM-DDTHH:MM:SSZ format) to_datetime: End timestamp (YYYY-MM-DDTHH:MM:SSZ format) Returns: dict: Nomination data from Congress.gov API """ base_url = "https://api.congress.gov/v3/nomination" url = base_url if congress: url += f"/{congress}" if nomination_number: url += f"/{nomination_number}" params = { "api_key": congress_gov_api_key, "format": "json", "offset": offset, "limit": min(limit, 250) } if from_datetime: params["fromDateTime"] = from_datetime if to_datetime: params["toDateTime"] = to_datetime try: response = requests.get(url, params=params) response.raise_for_status() return response.json() except requests.exceptions.RequestException as e: return { "error": f"Failed to retrieve nomination information: {str(e)}", "status_code": getattr(e.response, "status_code", None) }