USLege

Create a new portal owned by the calling user. Caller must have access to every track id provided; the call is rejected if any track is inaccessible. New portals are created with `accessType: 'Owner'` (only the creator can see them) — call `share-portal` afterward to expand access to a Group or to the whole organization. Asset uploads (logos, banners, attachments) are NOT supported via MCP — direct users to the UI for that step. Before creating, always confirm the portal name, track list, and visibility flags with the user.

create-portal

Create a new video radar rule owned by the calling user. Video radar rules are saved natural-language queries that monitor legislative video transcripts for matches. They are persisted as `AiMonitorQueries` rows (with `AiMonitorQueriesByInstitution` for targeting and `AiMonitorSharedUsers` for the recipient list) — there is no separate "RadarVideoRule" table. Targeting accepts either individual institution ids (`organizationIds`), state-level "all institutions of type X" selections (`allSelections`), or both — at least one must be provided. State / institution access is enforced by the existing tRPC guard; unauthorized targets are rejected. `alertRecipients` is required: `Owner` (only the creator), `CustomList` (resolves `selectedEmails` against the caller's org), or `OwnerOrganization` (every user in the caller's org). Before creating, always confirm the rule definition, targeted institutions / "all" selections, alert recipients, and notification cadence with the user.

create-video-radar-rule

Create or update a video clip from a legislative video recording. **Create** (omit clipId): Creates a new clip from the specified video. Requires videoId, title, startTimeSeconds, and endTimeSeconds. By default, the clip is saved but NOT processed for download — set processClip to true to trigger processing. **Update** (provide clipId): Updates an existing clip you own. Only provided fields are changed. If start/end times change and processClip is true, clip processing is re-triggered. Do NOT process the clip for download unless the user explicitly asks. Processing creates a downloadable video file from the source video — it takes a few minutes and costs resources. Leave processClip unset (defaults to false) unless the user says they want it processed. Logos default to none. Before creating a clip, ask the user if they want a logo watermark applied. If yes, call list-logos first to show available options and let them choose. Pass the chosen logoId and optional logoPlacement. Before creating or updating, confirm the clip details with the user — especially the video, timestamps, and title. Requires the video ID. Call search-videos first to find the video. Use get-video-transcript or search-transcript to identify the right start/end timestamps; capture all the relevant discussion the user asked for and err on the side of slightly too long over too short. After creating a clip, you can provide the user a shareable link: https://app.uslege.ai/share/{clipId}?from=clips

manage-clip

Delete a comment you previously posted on a bill, along with any of its attachments. Only the comment's own author can delete it — call list-bill-comments first to find the comment ID and confirm isMine is true. This action cannot be undone. Before deleting, always confirm with the user by showing the comment's content.

delete-bill-comment

Permanently delete a bill radar rule. Deletion cascades to the rule's stored bill matches and notification records via the underlying foreign-key constraints — there is no undo. Before deleting, always confirm with the user by showing the rule name and any pending shared users.

delete-bill-radar-rule

Delete a calendar alert rule. Only the rule owner may delete. Removes the rule, its location associations, and every shared-user row. Confirm with the user before calling — this is irreversible.

delete-calendar-alert-rule

Delete a dashboard. Owner-only. Cascades to every widget on the dashboard, every member entry, and every per-user view order — all permanently lost. Before deleting, ALWAYS confirm with the user. Call get-dashboard first and show them the dashboard name, widget count, and access type so they can identify what's about to disappear. The operation cannot be undone.

delete-dashboard

Delete a single widget from a dashboard. Permanent and cannot be undone. Before deleting, ALWAYS confirm with the user. Show the widget name and type (call get-dashboard to retrieve them if you don't already have them). Caller must be Owner or Editor on the dashboard; Viewers are rejected. After deleting, consider calling reorder-widgets to backfill the gap if the user wants a tidy grid — let the user choose; some prefer the gap as a placeholder.

delete-widget

Delete a bill track and remove all associated data. This permanently removes the track along with its tracked bills, digests, video clips, and access records. The user must have access to the track to delete it. This action cannot be undone. Requires the track ID. Call listTracks first to find the ID of the track to delete. Before deleting, always confirm with the user by showing the track name and bill count.

delete-track

Permanently delete a portal. Owner-only — non-owner callers receive a permission error. Cascades cleanup of: portal-track associations, portal access entries, free email-access entries, portal-level updates, and uploaded assets (logos / banners / attachments in Supabase storage). This is irreversible. Underlying tracked bills and source tracks are NOT deleted — only the portal wrapper. Before deleting, always confirm with the user by showing the portal name and (if possible) the track count + recent update count obtained via `get-portal`.

delete-portal

Permanently delete a portal-level update. Cleans up any file attachments stored in Supabase, then deletes the update row. Irreversible. Requires paid access to the parent portal. Before deleting, confirm with the user — show the update title (or first line of content) and `updateDate` from `list-portal-updates`.

delete-portal-update

Permanently delete a video radar rule. Video radar rules are persisted as `AiMonitorQueries` rows — there is no separate "RadarVideoRule" table. Deletion is restricted to the rule's owner; sharing with the caller is not enough. Associated `AiMonitorQueriesByInstitution` rows are removed, while historical `AiMonitorMatches` rows are kept for audit. This action cannot be undone. Always confirm the rule id and intent with the user before calling.

delete-video-radar-rule

Delete a client from the calling user's organization. This cannot be undone. Requires the client id — call list-clients first to find it. Before deleting, always confirm with the user by showing the client's name.

delete-client

Modify an existing portal-level update (announcement). Partial-field semantics — at least one changeable field must be provided; omitted fields are unchanged. Attachments are managed in the UI — this tool does not add or remove file attachments. Before updating, confirm the changes with the user.

update-portal-update

Exports a video's full transcript as a downloadable file. Defaults to a DOCX file. Pass format: "json" or "md" only when the user explicitly asks for that file format — otherwise leave it unset so the user receives a DOCX. When format is "json", the downloaded file is UTF-8 JSON with this shape: { "videoId": number, "title": string | null, "institutionName": string, "recordedOn": "YYYY-MM-DD", "paragraphs": [{ "startSeconds": number, "endSeconds": number, "text": string }] } When format is "md", the downloaded file is a UTF-8 Markdown document with an institution-name heading, a title heading, a recorded-on line, and one paragraph of transcript text per line — no timestamps or speaker labels. Returns a presigned download URL (valid for 1 hour) along with video metadata and a suggested filename. The AI client should surface the downloadUrl to the user as a link or download action — there is no inline file content to decode. Requires a video ID. Use the search-videos tool first to find the video ID. To read the transcript text directly (e.g., to summarize or quote it), use get-video-transcript instead — that tool returns the paragraphs inline.

export-transcript

Fetch the full file body (HTML or text) for a single state register section — the same content the in-app RegisterViewer shows when you click a section in the tree. Use this after search-state-register-sections to read a specific rule or notice. A section may have one or more attached files. Every response includes a `files` array listing every file's id/name/type, so a single call gives you full visibility into what's attached. For TEXT-LIKE files (HTML/HTM/TXT/MD/JSON), the response includes the decoded body as `content`. For BINARY files (PDF/DOC/DOCX), `content` is null and the response instead includes `downloadUrl` — a presigned S3 URL (valid 1 hour, with `expiresAt` ISO timestamp) you can surface to the user as a download link or fetch yourself to parse the file contents (raw bytes returned as a JSON string would be unusable). By default `selectedFile` is the first attached file (a sensible starting point, and the only file for the common single-file case). To read a different file, call again with that file's id from the `files` array as the `fileId` input. Errors: - error="section_not_found" if sectionId doesn't exist - error="no_files_found" if the section has no attached files - error="file_not_attached" if fileId is provided but isn't attached to this section - error="state_access_denied" if your org isn't authorized for the section's state

get-state-register-section-content

Get per-year lobbyist <-> client compensation rows for Texas. Filterable by lobbyistId, clientId, year, and compensationMethod (Earned / Paid / Prospect). Sorted by year desc, then lobbyist name asc. Each row returns the lobbyist + client refs (with names), reporting interval, compensation method, minAmount/maxAmount in USD, the original compensationCode, and compensatedFrom/compensatedTo windows (ISO 8601). Lobbyist data is currently TX-only — non-TX-authorized callers receive a structured access-denied error.

get-lobbyist-compensation

Get a Texas lobbyist's full profile by id. Returns: - contact info (full name, firm, address, phone) - subject matters lobbied on, with the year each was reported - per-client compensation history (minAmount/maxAmount in USD, compensationCode original code, method, reporting interval, compensated-from/to dates) - political fund reimbursements (fund name + address + reporting interval per year) Lobbyist data is currently TX-only — non-TX-authorized callers receive a structured access-denied error. Returns { found: false } when no lobbyist exists for the supplied id.

get-lobbyist-details

Fetch the organization-level notification settings for a single bill and (when applicable) its current subscriber list. Call `list-bill-subscriptions` or `search-bills` first to discover the bill id. Returns `settings: null` when the caller's organization has no notification settings configured for the bill. The `subscribers` array is only populated when the bill's access type is `Group` — for `Owner` / `Track` / `Organization` access types it is empty by design, since per-user subscriptions are not tracked on those rows.

get-bill-notification-settings

Fetch a single calendar alert rule by id. Call `list-calendar-alert-rules` first to discover the rule id. Returns `rule: null` when the rule does not exist or the caller has no access — the two cases are intentionally indistinguishable.

get-calendar-alert-rule

Consolidated profile for a single campaign-finance donor (entity), assembled in one call: identity header, lifetime giving stats, the top recipients they've funded, and per-section row counts. This is the donor detail view. First call search-campaign-finance to resolve a name to an entity id (results where kind='entity'); pass that id here. If the donor is itself a registered filer, the header's resolvedFilerId points to the filer-side record — use the filer tools for that view. Money amounts are integer cents. `topRecipients.rollup` buckets ALL of the donor's giving by recipient type (candidates / committees / party / other), while `topRecipients.recipients` is only the five largest recipients by dollars. `sectionCounts` reports how many rows exist per detail section so you can tell what's worth drilling into. Campaign finance is only available for states where the "elections" product is enabled. A state your org isn't authorized for returns `state_access_denied`; an authorized state without campaign-finance data returns `state_not_supported` along with the currently-supported states. An unknown entity id (or one from another state) returns `not_found`.

get-entity

One page of a single donor's (entity's) transaction history for one section, the drill-down behind get-entity's `sectionCounts`. Resolve a donor id with search-campaign-finance (results where kind='entity'), call get-entity to see which sections have rows, then page the section you want here. Each row's `counterparty` is the filer on the other side; pass its `filerId` to the filer tools. Rows are newest-first by transaction date (id-tiebroken). Paginate with `pagination.offset`: add `limit` to `offset` for the next page and stop once `offset + rows.length >= totalCount`. An unknown or wrong-state donor id simply returns zero rows (never an error). Campaign finance is only available for states where the "elections" product is enabled. A state your org isn't authorized for returns `state_access_denied`; an authorized state without campaign-finance data returns `state_not_supported` with the currently-supported states.

get-entity-activity

One paginated activity section for a single campaign-finance filer, selected by `type`. Use it after get-filer once you have a filerId and its `sectionCounts` tell you which sections have rows — this is the drill-down that returns the actual transaction rows behind those counts. Discover the filerId first with search-campaign-finance (a result where kind='filer', or the resolvedFilerId on a donor). Call once per section you want; the response populates only the field named by `type` (e.g. type='contributions' fills `contributions`), and echoes `type` back. Pagination: `contributions`, `expenditures`, `reports`, `pledges`, `loans`, `spacPositions`, and `travel` are server-paginated — use `limit`/`offset` and page against `totalCount`. `topContributors` and `spendByCategory` are aggregates that ignore `limit`/`offset`: `topContributors` returns only the top 5 donors by total (a fixed cap — `totalCount` is at most 5 and does NOT reflect the true number of distinct contributors), while `spendByCategory` returns every category and its `totalCount` is the full category count. Period bounds: `dateFrom`/`dateTo` scope only the money sections `contributions`, `expenditures`, `topContributors`, and `spendByCategory` (on transaction date). The all-time sections `reports`, `pledges`, `loans`, `spacPositions`, and `travel` ignore them. Campaign finance is only available for states where the "elections" product is enabled. A state your org isn't authorized for returns `state_access_denied`; an authorized state without campaign-finance data returns `state_not_supported` along with the currently-supported states.

get-filer-activity

Get a committee's calendar of past and upcoming meetings/hearings, including agenda bills, participants, hearing notice links, and attached files. Fields not present in the underlying data (room, structured participants, isHost) are returned as null/empty. If a state does not have the "calendars" product enabled, returns an empty events list with an explanatory message rather than an error. If the committee does not exist OR the user is not authorized for the committee's state, returns { events: [], totalCount: 0, error: "not_found" } with the same shape — these cases are intentionally indistinguishable to prevent committee-ID enumeration.

get-committee-calendar

Get a committee's full detail plus its seated members, staff roster, parent committee, and direct subcommittees (one level deep only). Returns ONLY this committee's own membership (chair, vice chair, ranking minority chair, members of this committee). It does NOT return the full chamber/legislature roster — for that, use list-legislators. For per-meeting attendance, use a calendar event tool instead. Legislators are sorted Chair → ViceChair → RankingMinorityChair → Member, then alphabetical. Staff is sorted alphabetical by name; a staffer with multiple roles surfaces once with all StafferPositionType values aggregated into positions[].

get-committee

Consolidated profile for a single campaign-finance filer (candidate, officeholder, or PAC/committee) in one call: identity header, summary-card aggregates, headline money-in/money-out totals, officers, legislator links, and per-section row counts. Use this as the follow-up to search-campaign-finance once you have a filer id — it replaces six separate lookups. Discover the filer id first with search-campaign-finance (a result where kind='filer', or the resolvedFilerId on a donor). `sectionCounts` tells you which detail sections have rows so you can decide which paginated follow-up tools to call next. `moneyTotals` is the only period-aware section: pass `dateFrom` / `dateTo` to scope it, or omit both for all-time; the other sections are always all-time. `header` is null when no filer matches the id in the given state. Campaign finance is only available for states where the "elections" product is enabled. A state your org isn't authorized for returns `state_access_denied`; an authorized state without campaign-finance data returns `state_not_supported` along with the currently-supported states.

get-filer

Get one dashboard's full layout: metadata, the calling user's role on it, the member list (user id + role), and every widget on the grid with its name, type, display type, stored filters JSON, and grid position. Useful for understanding what a user is currently tracking before suggesting changes or fetching rendered data. Requires the dashboard id, which the user must provide directly. Member user ids returned here are internal Clerk user ids scoped to the caller's organization.

get-dashboard

Fetch a single portal by id with its tracks, paid-access users, and (if the caller is owner / paid) the email-access list. Call `list-portals` first to discover the portal id. Returns `portal: null` when the caller has no access. The `paidAccessUsers` array is empty for read-only viewers. The `emailAccess` array is populated only for callers with paid/owner access (it is owner-managed data) — for everyone else it is `null`.

get-portal

Fetch a single executive order by database ID, including the full body, scraper- supplied summary, source URL, and PDF link. Federal EOs carry state='US' with the president in the 'governor' field. Use after identifying an EO via search-executive-orders.

get-executive-order

Fetch a single social media post by its internal id, including its full text, the account that surfaced it, and the bills it references. On a Repost the text is the original author's words, not the account holder's — read `originalAuthor` to attribute the argument correctly rather than crediting the reposter. Find the id via search-social-posts. Returns "not found" for an id that doesn't exist or belongs to a state the caller cannot access; the two are indistinguishable on purpose.

get-social-post

Fetch the notification settings for a single track and the current recipients list. Call `list-tracks` or `list-track-subscriptions` first to discover the track id. Errors with "Track has no notifications configured yet" when the track exists but has no `TrackNotificationSettings` row yet. The `recipients.subscriberUserIds` array reflects the users who currently receive notifications; `recipients.accessUsers` lists every user who has access to the track (the candidate pool for `update-track-notification-settings.recipientUserIds`).

get-track-notification-settings

Get a specific vote record with the full legislator-level breakdown. Returns the vote record summary (resolution, counts, chamber, date) along with every legislator's vote: their name, legislator ID, canonical vote type (Yay, Nay, Absent, PresentNotVoting, Abstain, Pass), the state-specific source label, political party, and district number. Use this after calling search-votes, which returns vote record IDs you can pass directly here.

get-vote-record

Get a single interim topic's full detail: the topic text, its assigned committee, the source document it was extracted from, bills referenced in the topic text, and committee-report documents responding to it. Requires the interim topic ID. Call search-interim-topics first to find IDs. Use the returned committeeId with get-committee and billId values with get-bill-data to drill further. Interim topics are a per-state product. If the topic belongs to a state the caller is not subscribed to, or a state without interim topics enabled, a structured error (state_access_denied or state_not_supported) is returned instead of the topic.

get-interim-topic

Fetch the authenticated user's notification settings for bill-assignment events (when a teammate assigns them as the lead or a member on a bill). Returns the per-channel toggles. When no settings row exists yet for the user, the response is the system default — both channels ON.

get-bill-assignment-notification-settings

Get bills in a specific track. Returns bill details including bill type, number, summary, last action, author, state, session, impact, stance, assigned lead, members, and tags. Provide either the track ID or the track name — the name will be resolved automatically. Only returns tracks you have access to — your own tracks, tracks shared with you, or organization-wide tracks. If a track is not found, the user may not have access to it. Supports filtering by state and searching by bill number or keyword.

get-track-bills

Get full details for a specific legislative calendar event, including metadata and scheduled bills. Takes an eventId (and optional source hint) returned by the search-calendar-events tool. Auto-detects the data source (CalendarEvent, LegislativeEvent, or Legacy TX/CA) if source is not provided. Returns event metadata (name, date, location, participants, agenda items) plus a list of bills scheduled for that event with their authors, last action, and tracking status.

get-calendar-event-details

Fetch the authenticated user's notification settings for comment-mention events (when a teammate @-mentions them in a bill comment or note). Returns the per-channel toggles. When no settings row exists yet for the user, the response is the system default — both channels ON. The underlying read tolerates environments where the `CommentMention` enum value has not been migrated yet: on enum failures it returns defaults rather than erroring, so the panel keeps rendering.

get-comment-mention-notification-settings

Fetch the authenticated user's notification settings for core smart-action bill events (e.g. introduced, passed chamber, signed by governor). Returns the per-channel toggles. When no settings row exists yet for the user, the response is the system default — in-app ON, email OFF. Distinct from `get-bill-notification-settings`, which returns the bill-scoped notification settings for a specific bill; this tool is user-scoped and applies across every bill the user is tracking.

get-core-smart-action-notification-settings

Get detailed data for a single bill by its database ID — authors, sponsors, legislative action history, documents, videos, and related bills. Use this after identifying a bill via search-bills, which returns bill IDs you can pass directly here. search-bills already provides summary/caption — use this tool for the deeper data: authors, sponsors, full action history, documents, videos, and related bills.

get-bill-data

Fetch the full testimony history for a single witness by UUID. Returns a rich profile (bio, avatar, socials, employment history) plus panel-based testimonies with summary, pull quote, representation basis, reception, effectiveness, lead quality, referenced bills, policy areas, and individual extracted points with verbatim transcript sources. Pass the witnessId returned by search-testimony verbatim. The witness profile itself is global — the caller's 'witnesses-v2' product access restricts which testimony rows are returned.

get-witness