The live tools/list response is the exact input and output contract. Inputs
reject unknown fields, and that rejection's recovery lists the arguments the
tool takes. Errors return {code, message, retryable, recovery?, details?},
and public TextContent is the JSON copy of the same structuredContent payload.
Every list-returning tool returns bounded rows; a limit or max_pages
above a tool's maximum reads the maximum. ElevenFlo MCP
exposes 16 tools: 12 bankruptcy research tools, three that manage the
connected user's own monitors, and one that shows the connected account's
plan and credits. This page is the complete list,
and a tool absent here is not available. See
Permissions and data access
for what ElevenFlo MCP cannot do.
Cases are addressed by case_id, documents by UUID document_id. Use
identifiers exactly as returned. ElevenFlo MCP accepts no aliases. When a
document row carries has_primary_pdf: true, open the document at
/api/search/open/<uuid>/ using that same UUID.
#The research loop
find_casesto resolve acase_id.list_docket_entries,search_documents, orfind_key_documentsto select documents, andlist_related_documentsto follow one document to the motion, order, objections, replies or later amended version linked to it.search_document_pagesto see which pages hold the keywords across up to 25 documents.read_document_pagesfor the text of those pages, or of the pages in one document that match a query.
#Cases and dockets
#find_cases
Resolve a case by identity. query matches case name, case number,
jurisdiction and judge with typo tolerance; legal-form words such as Inc.,
LLC, Holdings and Group do not count toward a name match. It does not match
counsel, docket text or document text (use search_documents for those).
Screening is not this tool: filter or count a population with the cases
structured dataset.
- Inputs:
query(required) andlimit(1 to 50). Any other argument is rejected withinvalid_inputnaming the argument, never an empty result. - Returns:
case_id, identifying metadata, petition date, chapter, the petition asset and liability brackets withassets_basis_qualityandliabilities_basis_quality(evidencedorlegacy_unverified), document coverage and case-type tags. Best match first.
#list_docket_entries
List observed docket entries for one case, including full entry text, docket evidence, court citations, and links to held documents. Entries can exist without a PDF or searchable document text. For current case status, verify the relevant terminal notice rather than relying on a projected date.
- Inputs:
case_id; optionallimitfrom 1 to 25,query,document_type_tags, inclusivedate_filed_from/date_filed_todates, up to 25 positivedocket_entry_numbersor an inclusivedocket_entry_number_from/docket_entry_number_torange (one bound alone is open-ended; the list and the range cannot be combined), and an opaquecursorfrom the preceding page. A cursor is valid only with the same filters. Dates describe filing dates, not independently verified entry or signature dates. - Text search:
querymatches an entry when every whitespace-separated term appears, in any order and ignoring case. When a date or docket entry number is known, start with those filters and omitqueryand type filters. - Filters:
document_type_tagsaccepts only category keys and canonical tags; an unknown value returns a typed error listing the allowed values. Only entries with classified documents carry tags; entries known only from court RSS carry the court's short label and no tags, so tag and text filters can exclude them. - Returns: the
case_id,entries, evidence and, when more entries follow,next_cursor; PDF/text flags describe held artifacts. Each entry carries itsdocket_entry_number,date_filedanddocket_text, the court's own docket text in full. Every held document with a public UUID appears once, inside its entry, with itsdocument_type_tagsand adocument_urlthat opens the document. A document repeatsdocket_text,date_filed,docket_entry_numberorcourt_locatoronly where its own value differs from the entry's; a field it omits is the entry's. An empty first page carriescoverage_note, which says whether the filters excluded recorded entries or none are recorded in that window, the case's coverage source, and whether the docket is known to be incomplete or its completeness is unknown. - Court locator: each entry and document can carry
court_locator: the courtcitation(Bankr. D. Del., No. 22-11068, ECF No. 512; adversary and claim-register forms useAdv. No.andClaim No.),court,case_number,docket_entry_numberorclaim_number,case_docket_url, and an optionalpacerlink whosetargetiscase,entry, ordocument. It says where the document sits on the court's docket, not where ElevenFlo's copy came from. A PACER link opens with the reader's own PACER login; PACER fees may apply. Document, summary, page and key-document results carry the same object.
#Monitors and case updates
#list_case_updates
Read what changed for the connected user's saved monitors, or for named cases, as a resumable feed. It reads; it does not schedule checks or send notifications.
- Inputs: optional
monitor_ids(fromlist_monitors) or one to 25case_ids, never both; with neither it reads every saved monitor. Resolve a named case withfind_casesfirst. Optionalsinceis an ISO-8601 timestamp within the last 90 days for the first call; it defaults to seven days ago.limitis 1 to 50. Optionalcursorcontinues or resumes; omitsincewith it. - Returns:
changesin sequence order. Anupsertcarries the publication (headline, body, case, sources and citation ranges), its recordstatusand the matchingmonitor_ids; aremovenames a development that no longer matches, such as a corrected asset scope or a withdrawal. The first call pages a fixedsnapshot; keepnext_cursorand pass it later to get just thechangessince. Every call returnsnext_cursoras a resume point;has_moreis true when more changes are ready now.coveragestates the scope, what unknown facts left out, and what the covered cases hold. - Limits: zero changes does not mean nothing was filed. After a monitor is
edited, added or deleted the cursor returns
monitor_changed: call again withoutcursorfor a fresh snapshot.watchedandtriggerswere removed: omitwatchedto read all your monitors, and settopicson a monitor withsave_monitorinstead oftriggers. Monitor scopes need a signed-in user; market monitors need Pro.
#save_monitor
Save a monitor for the connected user, or edit one by monitor_id.
- Inputs:
filters: eithercase_idalone (a case watch) or market filters combined with AND:chapters,subchapter_v,court_states,statuses,event_kinds,asset_classes(a class includes its subclasses),min_units(requiresasset_classes) andkeyword(every word must appear). Optionalname, andtopicsto narrow publication topics such assale. - Returns: the monitor and a 28-day dry run: publications it matches and those left out because a fact a filter needs is unknown.
- Limits: Free accounts hold five case watches; market monitors need Pro, up
to 20. An edit keeps the id and makes earlier cursors return
monitor_changed.
#list_monitors
List the connected user's monitors, oldest first, with their ids, filters,
topics and filter_revision. limit is 1 to 100 (default 50); pass next_cursor
back as cursor for the next page; it is absent on the last page. total
counts every monitor.
#delete_monitor
Delete one of the connected user's monitors by monitor_id. Its feed and email
updates stop. This cannot be undone.
#Cross-document search
These tools require every substantive query term to appear in the matching evidence. One common word cannot pull in unrelated results.
#search_documents
Search whole court documents or hearing transcripts across all cases or within one
case. Every term must
appear somewhere in the document, not necessarily in one passage. Quoted text is
an exact phrase; uppercase OR, NOT and parentheses combine terms, for
example "cash collateral" AND (objection OR NOT interim). A malformed query
returns invalid_query naming the position to fix.
- Inputs:
query; optionalcontent_type(filing, the default, ortranscript),case_id,document_type_tags(not transcripts), inclusivedate_filed_from/date_filed_todates, andlimitfrom 1 to 25. - Returns: document rows with
document_id,document_url, case,docket_text(the court's docket text in full),docket_entry_number, date and a matching excerpt. Court documents come newest first and add type tags. Transcripts come in relevance order and addtranscript_source_kind. An unknowndocument_type_tagsvalue returns the allowed values. - The filing type
venue_or_dismissal_motioncovers motions to transfer venue, motions to dismiss a bankruptcy case and motions to dismiss an adversary complaint. Narrow by the relief sought, for example"motion to dismiss" AND 1112, and check the caption and proceeding. To include responsive filings and opinions, search the text across filing types. - A transcript is one of two kinds.
certified_filingis a court reporter's transcript filed on the docket. Read it by page like other court documents.court_audio_asris a machine transcription of court audio, not a court-reporter transcript; it can misstate names and figures and reads by time.
#Exact text
#search_document_pages
See which pages hold a few keywords across up to 25 selected documents or transcripts before reading full text.
- Inputs: one to 25
document_idsandquery. - Returns:
hits, each adocument_id, 1-basedpageand short snippet, for the pages that hold every keyword, in relevance order within a document. When a document has no such page, its closest pages come back withmatched_terms.no_text_document_idslists documents with no extracted text andmissing_document_idsthose not found or not public. - Limits: a document with no hit has no entry; that does not establish the topic is absent.
#read_document_pages
Read pages of one document or transcript.
- Inputs:
document_idand one ofpages(numbers and ranges such as3-5,9),query(a few keywords) or, for a court-audio transcript,time(such as12:30); optionalmax_pagesfrom 1 to 10 (default 3). With none of the three, the firstmax_pagespages are read. - Returns: each page's text and number,
page_countand thedocument_url. For a numbered PDF page,page_urlopens that page after sign-in. One call reads 10 pages. Whenpagesnames more, the first 10 in page order are read andunread_pageslists the rest that exist in the document, written so it can be passed aspageson the next call. Withquery, the pages holding every keyword come back in relevance order, all of them listed inmatched_pages, withhas_more_matcheswhen more matched than were returned; if no page holds every keyword, the closest pages carrymatched_terms. A court-audio transcript reads as numbered blocks of speaker turns withstart_timeandend_time; a court reporter's transcript reads by page, andtimeon one returnsinvalid_request. - When text is unavailable,
source_not_searchablegives the original PDF link if ElevenFlo has a downloadable file. For a docket-only entry, it identifies the case for related-filing or hearing-transcript searches. Results from court audio should be cited as machine transcripts. - A document with text but no page map can be read by
query. A page outside the document returnspage_not_found; an unknown document returns a typed not-found error.
#Document relationships
#find_key_documents
Find key documents in a case, ranked by incoming citation count. Citation frequency is a starting point for research, not a judgment of legal importance.
- Inputs:
case_id, optionallimitfrom 1 to 25. - Returns: document rows with citation counts, each document's
docket_textanddocket_entry_number, and adocument_urlthat opens it.
#list_related_documents
List the documents one document's docket entry refers to and the documents whose docket entries refer to it, such as the motion an order rules on, the objections and replies to a motion, or the later amended version, redline notice or order whose docket entry cites an earlier filing.
- Input:
document_id. - Returns: two lists,
referencesandreferenced_by, holding up to 20 documents between them, newest filing first in each. Each list holds up to 10, and either list fills the room the other leaves. Each row hasdocument_id,document_url, the court'sdocket_text,docket_entry_number,date_filedandrelationship_type.truncatedis true when more exist; the oldest in a full list are not listed. - Limits: a link exists where one docket entry cites another by number. It does not establish that a later filing amends or replaces the cited one. An empty list does not establish that nothing relates to the document.
#Structured data
Structured datasets carry typed, source-linked fields extracted from documents. Use them when the question is about typed fields, comparable records, or many cases at once rather than the text of one document. Responses return only public fields and operations, never internal extraction metadata.
Free accounts can list and describe datasets and run aggregates that do not
name a case. Reading rows with search_dataset, and grouping by a field that
names a case (case_id, id, case_name, case_number,
lead_case_number, case_url), require ElevenFlo Pro.
#list_datasets
List every dataset, or count one case's records in each.
- Inputs: optional
case_id, a case identifier returned byfind_cases. - Returns:
columnsonce (dataset,one_row_per), thenstagesin the order a case runs. Each stage holds itsfamilies, and each family one array per dataset in the order ofcolumns: thedatasetname (the value the other dataset tools take) and what one row is. Withcase_id, each array ends withcase_rows, the records the dataset holds for that case;search_datasetfiltered oncase_idreads them. A count of zero does not establish that an event did not occur. - The whole list is one credit.
describe_datasetgives a dataset's title, freshness and coverage.
#describe_dataset
Call this before you query an unfamiliar dataset.
- Inputs:
dataset, a name returned bylist_datasets; optionalfields, up to 60 field names. - Returns: what one row is,
as_of,complete_since,grade,cases_covered, caveats, onefieldstable and example calls. Each field row gives its name, type, unit,fill(the share of rows that hold a value), allowed values, the filter operators it accepts and its meaning.extra_filterslists filters that are not fields;sortandfacetslist the fields that sort and facet. - Every description is one credit. A wide dataset describes its main fields
in
fieldsand names the rest by type inmore_fields. Pass any of those names asfieldsto get their rows; that response holds the dataset, its title, what one row is and the rows asked for, in the order asked. case_fieldslists the case facts every dataset exceptcasescarries (chapter, court, judge, petition date, size ranges and the like) with each one's type and its allowed values when the list is short. They filter, select and group like the dataset's own fields; pass one asfieldsfor its full row.- A filter has one name, the one
describe_datasetlists; there are no aliases. Sale-process dates filter onlatest_source_date_filedand fees-by-professional onlatest_date_filed. Calendar-date ranges supporteq,gt,lt,gte,lte, andbetween; numeric ranges supportgte,lte, andbetween.existstests whether a value is stated.
#search_dataset
Return typed rows from one dataset.
- Inputs:
dataset; optional typedwhere,select,sort,limit,cursor, and requestedfacetsas listed by the dataset description. - Returns:
columnsonce, then one array per record in that order, withtotal(null when not counted), facet counts when asked,next_cursorwhen more records match,as_of(null when unknown) andcomplete_since. Wide projections clamp page size to the select budget. - To find rows from a known filing, check which operators the dataset lists
for
document_idordocket_entry_number. Useeqfor one filing orinfor several. Pair docket entry numbers withcase_idto identify the case. Datasets that requirecase_idalso need it with a filing UUID. Both fields refer to the source filing identified on each row. - Stored spellings: to find how a name is stored, filter the field with
containsand request it as a facet. - Limits: a
casesscreen onassets_rangeorliabilities_rangecannot match a case whose petition reports no bracket.
#aggregate_dataset
Count and summarize records across one dataset.
- Inputs:
datasetandmetrics; optional typedwhere,group_by,sort, and alimitof up to 1,000 groups. A date field groups by a time bucket and a number field by a fixedwidth. A metric's ownwherecounts only the rows it matches, so two metrics in one call give a rate. - Returns:
columnsonce, then one array per group: the group fields, each metric and, for a field metric,<metric>_n, the rows that held a value.<metric>_is_floormarks a sum that leaves out amounts the documents do not state,partialmarks a time bucket that starts beforecomplete_since, andtotalsgives each metric over every group.
#Available datasets
cases: one row per canonical bankruptcy case for screening by chapter, Subchapter V election, court and state, petition date, entity form and NAICS code from the lead petition, industry and case-type tags, petition creditor, asset and liability brackets with their evidence basis, stage, typed outcome and document coverage. Closed facts spell absence asunknown,missingornone, so a group-by on them counts every case once; tag group-bys count a case once per tag and overlap.voluntary-petitionstop-unsecured-creditorscapital-instrumentscapital-stated-totalscapital-partiescapital-linksdip-facilitiesdip-ordersdip-cash-flow-budgetsdip-milestonescommittees: one row per official committee with its current roster.noticeslists every appointment notice with the roster that notice states, oldest first.committee-members: one row per member's time on a committee. Filteris_currenttotruefor today's roster. For the members on a date, filterjoined_datewithltethat date andon_committee_untilwithgtit.joined_date_basisandleft_date_basissay whether a notice states the date or a filing date bounds it; count departures withend_transitionequal toactual_departure.schedule-summary-totalsschedule-assets: one disclosed asset item on a Schedule A/B; filterasset_categorytoreal_propertyfor real estate.codebtors: one codebtor a debtor lists on Schedule H. Filtercodebtor_is_case_debtortotruefor codebtors whose name matches one debtor on the case's roster;falsedoes not show a codebtor is outside the group.codebtor-obligations: one schedule reference of one Schedule H row, joined to the Schedule D or E/F claim or Schedule G contract the same filing supports.case_idis required.link_statussays how far the filing supports the link:line_match(the printed line number and the creditor name agree),name_match(a checked box and exactly one row for that creditor, or the one row whose description is the debt Schedule H notes after the creditor's name),line_match_name_differs,ambiguous,no_matching_row,schedule_not_readandno_referencecarry no confirmed obligation.obligation_row_idis theidof the row inscheduled-claimsorexecutory-contracts; one debt with several codebtors repeats on each, so count distinctobligation_row_idand do not sumobligation_amount_usd. Schedule H does not say whether a codebtor is a guarantor or a co-borrower;codebtor_debt_description_as_filedcarries what a filing prints about the debt on Schedule H itself, when it prints anything.codebtor_is_case_debtoris true when the codebtor is itself a debtor on the case's roster. A debtor that files its schedules again has rows from each filing: filteris_latest_filing_for_debtortotrueto read one filing per debtor, knowing a later filing can list only what it adds. A codebtor listed against several creditors or schedules still has one row per reference, so count distinctcodebtor_row_idor codebtor names.candidate_linesgives the schedule line of each candidate row of an ambiguous reference. When the codebtor is another debtor of the case and the reference is to Schedule D or E/F,codebtor_own_row_statussays what that debtor's own schedule lists for the creditor (one_row,several_rows,no_matching_row,schedule_not_read) andcodebtor_own_row_idis its row inscheduled-claims: the same debt scheduled by a second debtor, never a second exposure.codebtor_own_row_basissays whether the row's description and lien read as the debt or it is only the one row naming the creditor, andcodebtor_own_amount_agreeswhether both debtors state one amount.scheduled_debtor_stated_roleandcodebtor_stated_rolecarryborrowerorguarantoronly where a debtor's own row prints it.scheduled-claims: one claim listed on a Schedule D or E/F, with its bucket (secured,priority_unsecured,nonpriority_unsecured), stated amounts and disputed, contingent and unliquidated checkboxes. A secured claim'sclaim_nature_as_filed,collateral_description_as_filedandlien_description_as_filedare read apart: when one agent holds several facilities on the same collateral, the lien names the facility. An aggregate needscase_idorsearch.sofa-disclosures: one answer to a Statement of Financial Affairs (Official Form 207) question, with itsdisclosure_type, party, amount, dates and the source text that states it. An aggregate needscase_id.first-day-relief: one first-day motion or order with its relief type, requested and granted payment caps in their stated currency, and the rulings the orders state (granted_statuses).bar-datesclaim-transfersrule-2019-statementsrule-2019-membershipsrule-2019-positionsmonthly-operating-reportsmonthly-operating-report-periodsmonthly-operating-report-case-periodsmonthly-operating-report-coveragekeip-kerpkeip-kerp-terms: one row per payout trigger or payment condition of a program at one stage. Joinprogram_idto akeip-kerpid. Compare therequestedandauthorizedrows that share aterm_label;order_effectsays what the order did. Readaward_amountwithaward_unitandaward_scope. Selectcitationsfor the source pages. A program without rows has no terms available in this dataset; that does not show it has none.asset-salescase-assetscontract-treatment-eventsexecutory-contractsexclusivity-periods: one row per exclusive period a motion requests or an entered order grants, kept separately for filing a plan and soliciting acceptances. Order rows (source_kindorder) carry the granted deadline,granted_days_from_petition, the linked motion, and the sequence in the case:prior_deadline_date,days_extended,extension_numberandsuperseded_on_date. For the latest surviving grant on file on a historical date, filterorder_filed_datelte andsuperseded_on_dategt that date.order_entered_dateis available when the order’s court stamp explicitly gives an entry date. Motion rows carry the requested deadline and, when an entered order is linked,ruling_dispositionandruling_deadline_date.link_basisstates how the motion and order were paired:docket_entry(the order's entry names the motion) ormatching_deadline(the order is the first to grant exactly the requested deadline; an inference from the dates). A null sequence value or ruling means no link or an intermediate order is not on file; it does not show that the court did not act.days_granted_vs_requestedon an order row is the granted deadline minus the linked motion's requested deadline; filter lte -1 for orders that gave less time than asked. An order a later order vacated hassequence_statusvacated withvacated_on_date, and is never returned as the operative order. Count requests onsource_kindmotion: arelated_paperrow is an objection, statement or other paper about a motion, whose date can be another party's proposal; it names the motion it concerns and carries no ruling.objections_on_fileon a motion row counts docket entries titled as an objection that cite the motion; 0 does not show the request was unopposed.plans: each case's current Chapter 11 plan with lifecycle status, type, proponent, and filing, confirmation, and effective dates. A withheld date is null, never zero; an empty result never proves a plan event did not occur.plan-classes: one row per class, with class-level recovery estimates and the publishedrecoverieswhen available.recovery_mid_percentcan be calculated from the class's bounds. Use the individual outcomes for elections.plan-class-recoveries: one row per published recovery outcome. Filter bycase_id. Useclass_idto join the class terms andoutcomeandoutcome_labelto check which condition applies. Selectcitationsto verify stated estimates and terms on the source page.disclosure-solicitation-eventsballot-class-resultspost-confirmation-reportspost-confirmation-report-quarterspost-confirmation-report-case-quarterspost-confirmation-report-coveragepost-confirmation-plan-comparisonconversions-dismissals-closures: court orders converting, dismissing or closing a case, newest-filed first. Rows default to rulings on the case itself; filterapplies_to_tracked_casetonoorunresolvedfor orders that end only other jointly administered cases or leave the scope open.affected_case_numberslists the case numbers the order prints.hearing-sessions: one row per current hearing session. Ahearing_datesort is calendar order: one day's sessions follow the clock. For per-case totals group bycase_id: the count is sessions, the sum ofmatter_countis agenda matters, and the minimum and maximumhearing_dateare the first and last hearing.adversary-proceedings: one row per adversary proceeding under a court number, with the parties and nature of suit the clerk announces on the bankruptcy docket and the dates of judgment, dismissal, closing and appeal entries read since. There is no status: a null date does not establish an open proceeding.bankruptcy-appeals: one row per notice of appeal, with appellants, the docket entry numbers of the orders appealed, the court the appeal was first directed to, its case number there, the district judge where the district court's own docket is on file, and the ruling once the bankruptcy docket or that district docket records one. A null disposition does not establish a pending appeal; a panel's or court of appeals' docket is not collected.counsel-appearances: one row per notice of appearance, pro hac vice motion or request for notice that names a client, a firm or an attorney: who represents whom, including creditors, lenders and ad hoc groups no retention order covers. A firm is recognized only when a retention, a fee application or the firm directory already names it. An appearance is not a court-approved retention, and a missing row does not show that a party is unrepresented.case-people: one row per person, firm and case, for the people a case's documents name as working on it: what their firm does on the case, whom it acts for, the person's title, the latest document naming them and links to the person's and the firm's ElevenFlo pages. The firm is the one on that case, not current employment; count people withcount_distinctonperson_name.professional-retentions: one row per professional engagement (counsel, financial advisers, bankers, claims agents and others) for a retaining party in a case, with its lifecycle status, the application and order it rests on, each objection, withdrawal and order inlifecycle_events, and stated rate tiers. Proposed is not approved; a status comes from an entered order.professional-retention-rates: one row per stated rate tier. Compare like with like: filterband,period=hourandcurrency_code, and filterbasis, because a requested rate is not an approved one.professional-retention-fee-terms— compare monthly, sale and restructuring terms by firm, role, fee kind, source basis and currency. Selectsource_quotefor exceptions and credits andsource_pagesfor the filed evidence.fee-applicationsfee-decisionsfees-by-professional: cumulative requested and allowed fee economics by applicant, case, and currency; group byfirm_namefor requested fees by firm. Requested fees are not court-allowed fees. Affiliates appear separately without parent-firm consolidation, and roles may be unknown. The publicrequested_amount_rejectedboolean indicates that requested economics exclude rejected documents; surviving requests in the same rollup still contribute.allowance_notestates in plain words when allowed totals are blank, when a final basis also counts interim awards, or when combined or undated awards are left out or added unchecked. Monetary sorts requirecurrency_codewitheq; the default sort is latest filing date.sourcesidentifies contributors separately for each monetary field, with availability, counts and truncation. Null provenance awaits reprojection. Order-date filters select applicants without rebasing their lifetime totals to the selected month.fee-timekeepers: named historical billing rates by firm and case. Filtertimekeeper_namewith name tokens in any order,organization_name,timekeeper_title, orhourly_rate. Group partner rates by firm, filing year, and currency; aggregates default to monthly, final, and first-and-final applications. Rates are observed billing evidence, not current market rates.fee-time-entries
This page is a static copy of the public catalog. Call
list_datasets for the live list and describe_dataset
for each dataset's fields, operations, and limits. Datasets outside the public
catalog return unknown_dataset, and its recovery names the closest dataset names.
hearing-sessions uses schema hearing-sessions.v4. scope_kind distinguishes
bankruptcy-case, single-adversary, joint-adversary and unresolved ownership.
adversary_proceedings contains canonical court numbers, captions and available
tracking URLs; scope_sources contains immutable public-document/hash references
for qualified joint conferences. Unresolved scope does not assert case ownership.
Select matter_sources for docket documents linked to the session's current
matters. Each link names the matter and the filing's role, such as notice,
adjournment or agenda. Pass its document_id to read_document_pages to
check what the filing says about the setting.
ballot-class-results uses schema ballot-class-results.v3. It returns one
row per plan class on each current ballot tabulation declaration, with the
declaration's filing date, tabulation date, voting deadline and plan on every
row. For one declaration's class counts, group by tabulation_id and
reported_result and count rows. is_operative is true only for the latest
non-supplemental declaration for the case and plan, or the latest supplemental
one when the plan has no other. classes_complete is false when the
declaration reports classes that are not rows. A declaration with no class row
does not appear. These class rows are what the declaration reports; they are
not canonical plan votes.
#Requests to ElevenFlo
Two tools send ElevenFlo staff something from the signed-in user, and only when the user asks: a request to add a case or missing documents, and a report about wrong data, an incorrect citation or a failed tool, or a suggestion. Neither costs credits. A prepaid tab has no user to answer, so neither is offered to one. Resending the same request or report returns the one already received, so a client can retry safely after a lost response.
#request_coverage
Ask ElevenFlo to add a case it does not list, or documents missing from a case it does.
- Inputs:
case_idfromfind_caseswithmissing_documentsnaming the filings, such as "Docket 412, the sale order".missing_documentsis required when the case already has documents. For a case ElevenFlo does not list:case_namewithcourtorcase_number, andconfirm_not_listedonce the user has ruled out the possible matches a first attempt returned. - Returns:
request_id, the reference to quote when following up;status(needs_review, thenfulfilledordeclined);created;documents_added;case_idonce the case is identified;case_name; and a plainmessage. Staff email the user the outcome. - Members of one ElevenFlo account share one open request per case and can read its notes. A request naming another missing filing adds it to the open request.
- If ElevenFlo lists a case matching the name or number, the tool returns
case_listedorambiguous_casewith the matches and records nothing. - A request records interest. It does not promise that ElevenFlo can obtain the documents.
#submit_feedback
Report a problem with ElevenFlo data or tools, or make a suggestion.
- Inputs:
category(data_correction,incorrect_citation,tool_failureorsuggestion), adescriptionof up to 1,000 characters, and the references that locate the problem:case_id,document_idwithpage,datasetwithrow_id,tool_name, orrequest_id, the Request ID a failed tool returned. A data correction or incorrect citation names a case, document or dataset; a tool failure names a tool or Request ID. - Returns:
feedback_id, the reference to quote when following up;status;created; and a plainmessage. - The report holds only these fields. ElevenFlo does not receive the conversation, prompts or credentials. A Request ID is accepted only from the user's own tool calls.
#Credits
MCP credits measure returned data. Each successful response costs the largest
of 1 credit, returned records divided by 10 (rounded up), or canonical response
bytes divided by 10,000 (rounded up). Protocol duplicates are counted only once.
A 100-row response of 20 KB costs 10 credits; a 45 KB text response costs 5.
Failed calls are not charged. Successful empty responses cost 1 credit.
show_plan_and_credits, request_coverage and submit_feedback cost none.
Free includes 200 MCP credits per calendar month, with no daily limit.
Pro includes 10,000 per calendar month and 2,000 per rolling 24 hours. Agents
without an account buy prepaid tabs of 100 credits for USD 5.00; see
Pay as an agent. All clients
share the account balance and its 120-request-per-minute limit. Monthly balances
reset at 00:00 UTC on the first of the month; Pro's rolling capacity recovers as
usage ages past 24 hours. A result that exceeds remaining capacity, or the caller's
elevenflo/max_credits request budget, is withheld and not charged. Every
successful result reports its cost and the remaining balance in _meta. See
current balances with show_plan_and_credits or on your account page.
#show_plan_and_credits
Show the connected account's plan and MCP credits.
- Inputs: none.
- Returns:
plan(FreeorPro) andmonthly_credits: the credits included, used and remaining this month and when they reset. Pro addsdaily_creditsfor the rolling 24 hours. A Free account also receivesupgrade: what ElevenFlo Pro includes, its price, and a link that opens the upgrade on elevenflo.com, where payment happens. - Costs no credits and works after a credit limit is reached. A client that supports MCP Apps shows the result as a panel in the conversation; any other client receives the same fields as text.
- Limits: a prepaid tab holds a balance but no plan, so the tool is not offered to one.
Website document access has a separate rolling-day budget of 75 distinct documents on Pro. Free accounts keep their monthly download allowance instead. Reopening the same document and PDF range requests do not consume additional rolling-day slots.