Awesome MCP Servers by AI Anytime

Directory / Finance & markets

FactLot

Commercial real estate calculators (rent schedule, net effective rent, CAM, debt sizing, ASC 842, WALT, NPV, IRR) that return every step and a versioned formula ID, plus parcel and entity IDs and fact validation. Free, no API key, 60 requests/minute per address. Endpoint: https://api.factlot.com/mcp · Registry: io.github.9mp96ygnbk-alt/factlot

Live  Answered an MCP handshake without credentials and listed 67 tools.

Category
Finance & markets
Transport
http
Source
https://github.com/9mp96ygnbk-alt/factlot
Endpoint
https://api.factlot.com/mcp
MCP Registry
io.github.9mp96ygnbk-alt/factlot
Reports itself as
factlot 0.5.0
Protocol
2025-06-18
Tools
67
Context cost
about 78,706 tokens for the tool definitions (estimated at four characters per token)
Tool definitions last changed
2026-11-20
Handshake time
1022 ms
Repository
1 stars · last push 2026-11-20 · Apache-2.0
Last checked
2026-11-22 11:27:34 UTC
Listed since
2026-11-18

Health and compatibility

Endpoint reachableVerifiedResponded in 1022 ms
MCP handshake (initialize)VerifiedCompleted without credentials
Tool discovery (tools/list)Verified67 tools listed
AuthenticationVerifiedNone needed to connect
Protocol versionVerified2025-06-18
TransportVerifiedStreamable HTTP
Capabilities declaredVerifiedcompletions, prompts, resources, tools

Last checked . Verified means the check saw it happen; it says nothing about whether the server is safe.

Recent history

5 daily checks so far; median response 1253 ms. Green answered, violet asked for auth, red did not answer.

Set up in your client

Claude Code

Run this in a terminal:

claude mcp add --transport http factlot https://api.factlot.com/mcp

Claude Desktop

Open Settings → Connectors → Add custom connector and paste this URL:

https://api.factlot.com/mcp

Or bridge it through mcp-remote in claude_desktop_config.json (needs Node.js):

{
  "mcpServers": {
    "factlot": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.factlot.com/mcp"
      ]
    }
  }
}

Cursor

Add to Cursor

Or add it to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "factlot": {
      "url": "https://api.factlot.com/mcp"
    }
  }
}

VS Code

Add to VS Code

Or add it to .vscode/mcp.json:

{
  "servers": {
    "factlot": {
      "type": "http",
      "url": "https://api.factlot.com/mcp"
    }
  }
}

Or from a terminal:

code --add-mcp '{"name": "factlot", "type": "http", "url": "https://api.factlot.com/mcp"}'

Windsurf

Add it to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "factlot": {
      "serverUrl": "https://api.factlot.com/mcp"
    }
  }
}

Other clients

Most clients accept this shape. The endpoint is:

https://api.factlot.com/mcp
{
  "mcpServers": {
    "factlot": {
      "type": "http",
      "url": "https://api.factlot.com/mcp"
    }
  }
}

If it does not connect

Tools 67

Names, descriptions and input schemas exactly as the server returned them on 2026-11-22. This is the server author's own text. Nothing is run from this page. Labels such as read-only are declared by the server and are not verified. Raw JSON

audit_expense_portfolioread-onlyAudit many landlord operating-expense (CAM) statements at once, for a tenant with many locations or for a …

Audit many landlord operating-expense (CAM) statements at once, for a tenant with many locations or for a lease audit firm or tenant-rep broker acting for one. Takes up to 50 audits, each the input audit_expense_statement takes (the lease's verified facts, the statement's verified facts, optionally the prior year's lines) plus a label and optionally the landlord, and one as_of date for all. Runs audit_expense_statement on each location (the same function, not a second implementation). Returns, per location, the audit's summary (findings by class, dollars at stake by class, the dispute deadline, the checks that could not run), its findings in short form with lease and statement pages, a reference to its full result (digests of its input and result; include_results returns the whole result) and its own package_items for fact_package_send; across the portfolio, totals by finding class and by check, dollars at stake in total and by landlord, the locations ranked by dollars at stake, dispute deadlines in date order with days remaining counted from as_of, repeated issues (the same check failing at several locations, or in several statement years for one landlord) and the locations whose input failed validation, each with its issues (the other locations are still audited). Deterministic and no model: same inputs, same answer, no clock. Findings are differences against quoted terms, not legal conclusions. On the hosted API the answer carries, for each location, its own attestation …

ParameterTypeDescription
auditsobject[]requiredUp to 50 audits, one per location (or per location and year), each the input audit_expense_statement takes (lease_facts, statement_facts, prior_statement_facts, yoy_threshold) plus a label and optionally the landlord. An entry that fails validation is …
as_ofstringrequiredToday's date, YYYY-MM-DD, for every location. The tool reads no clock: every deadline's days remaining is counted from this date.
yoy_thresholdnumberoptionalA line that rose by more than this fraction over the prior year is listed as a question to ask (default 0.10 = 10%), for every location that does not set its own. Must be greater than 0.
include_resultsbooleanoptionalTrue: each location also carries its whole audit_expense_statement result (every finding with its quotes, pages and calculation steps) under result. Default false: each location carries its summary, its findings in short form and result_ref (the digests of …

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "audit_expense_portfolio",
    "arguments": {
      "audits": [],
      "as_of": "..."
    }
  }
}
audit_expense_statementread-onlyAudit a landlord's operating-expense (CAM) statement for a tenant, from verified facts only. Give the lease's …

Audit a landlord's operating-expense (CAM) statement for a tenant, from verified facts only. Give the lease's facts (doc_abstract_lease or doc_verify_facts: pro-rata share, cap, base year or stop, admin fee, gross-up, excluded categories, capital-item treatment, audit right) and the statement's facts (each billed line, share applied, fee, gross-up, cap applied, totals, estimates, the date the tenant received it), each with its quote and page and passing fact_validate; optionally the prior year's lines. Returns findings, each with a stable code, the landlord's figure, the figure the lease yields, the dollar difference, the lease and statement fact ids with the quotes and pages, the calculation steps, a confidence class (follows_from_terms: the arithmetic follows from a quoted term and the statement's own numbers; depends_on_reading: it depends on how the lease sentence is read; question_to_ask: a question, never an overcharge) and what a person must confirm; totals; the last day to dispute or invoke the audit right with the notice form the lease requires; whether the difference crosses the lease's cost-shifting threshold; package_items ready for fact_package_send (state_ours with the landlord's figure as their_value for each finding, accept_theirs for lines with no finding); and checks_not_run with the reason (a missing lease term is never guessed). Twelve checks: management fee, cap, capital items, gross-up, pro-rata share, excluded categories, duplicates, base year or stop, …

ParameterTypeDescription
lease_factsobject[]requiredThe lease's verified facts (doc_abstract_lease's facts, or doc_verify_facts' verified[].fact), each with its quote and page. Read by predicate: lease.pro_rata_share (number; required: every finding rests on it), lease.pro_rata_basis {tenant_sf, building_sf}, …
statement_factsobject[]requiredThe landlord's statement as verified facts, each with its quote and page. Read by predicate: statement.period {year, statement_date, received_date}, statement.line {label, amount (building-level USD), controllable?, variable?, capital?, grossed_up_amount?, …
prior_statement_factsobject[]optionalOptional: the prior year's statement.line and statement.period facts, for the year-over-year questions.
as_ofstringrequiredToday's date, YYYY-MM-DD. The tool reads no clock: deadlines are counted from this date.
yoy_thresholdnumberoptionalA line that rose by more than this fraction over the prior year is listed as a question to ask (default 0.10 = 10%). Never an overcharge. Must be greater than 0.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "audit_expense_statement",
    "arguments": {
      "lease_facts": [],
      "statement_facts": [],
      "as_of": "..."
    }
  }
}
calc_amortization_scheduleread-onlyPeriod-by-period schedule of a fixed-rate loan, monthly or quarterly: an optional interest-only period, then …

Period-by-period schedule of a fixed-rate loan, monthly or quarterly: an optional interest-only period, then level payments on an amortization term that can run past maturity (balloon), with 30/360, actual/360, or actual/365 interest (the payment on a 30/360 basis). Rows are in cents that foot: interest is rounded each period, the final payment repays the whole balance, and the totals are the row sums. Deterministic: the same inputs always give the same result, with formula ID calc.amortization_schedule@1, every step, and any warnings.

ParameterTypeDescription
principalnumberrequiredLoan amount funded, USD. Must be greater than 0.
rate_annualnumberrequiredFixed nominal annual interest rate as a decimal, e.g. 0.065 for 6.5%. Must be less than 1.
payment_frequencystringoptionalPayment period: monthly (12 a year) or quarterly (4 a year). Term, amortization, and interest-only months must be whole periods. One of: monthly, quarterly
term_monthsintegerrequiredMonths from funding to maturity, when any remaining balance (the balloon) is repaid.
amortization_monthsintegerrequiredAmortization period in months that sets the level payment after any interest-only period, e.g. 360 for a 30-year schedule; 0 means interest-only to maturity. Must be at least term_months − interest_only_months (a shorter schedule would repay the loan before …
interest_only_monthsintegeroptionalMonths of interest-only payments at the start of the loan; amortization over amortization_months begins after them. At most term_months.
day_countstringoptionalInterest day count: "30/360" (each period is 30 days a month: interest = balance × rate ÷ periods a year), "actual/360" or "actual/365" (balance × rate × actual days in the period ÷ 360 or 365; needs start_date). Under actual day counts the level payment is … One of: 30/360, actual/360, actual/365
start_datestringoptionalFunding date, YYYY-MM-DD. Payment k falls k periods later on the same day of the month (clamped to month end); the first period runs from this date to the first payment date. Required for actual/360 and actual/365; optional for 30/360, where it only dates the …

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_amortization_schedule",
    "arguments": {
      "principal": 0,
      "rate_annual": 0,
      "term_months": 0,
      "amortization_months": 0
    }
  }
}
calc_cam_reconciliationread-onlyReconcile a tenant's annual CAM charge: exclusions, occupancy gross-up of variable expenses, pro rata share, …

Reconcile a tenant's annual CAM charge: exclusions, occupancy gross-up of variable expenses, pro rata share, controllable-expense caps (compounding_from_base, simple_from_base, year_over_year), an admin fee (before or after the cap, inside or outside it, with per-line exclusions), base year or expense stop, partial-year occupancy (move-in/move-out prorates share, cap, and base by days), and estimates paid. Returns balance due and a full trace with order-of-operations warnings. Deterministic: the same inputs always give the same result, with formula ID calc.cam_reconciliation@2, every step, and any warnings.

ParameterTypeDescription
yearintegerrequiredCalendar or lease year being reconciled.
pro_rata_sharenumberrequiredTenant's pro rata share, 0 < share ≤ 1 (e.g. 12,000 / 150,000 = 0.08). Must be greater than 0.
expensesobject[]requiredBuilding operating expense lines for the year.
gross_upobjectoptionalGross up variable expenses to the target occupancy when actual occupancy is lower. Omit if the lease has no gross-up.
structureobjectoptionalExpense structure from the lease. Default: net.
capobjectoptionalCap on the tenant's share of controllable expenses. Omit if the lease has no cap.
admin_feeobjectoptionalAdministrative fee the lease adds to the tenant's share. Omit if the lease has none.
occupancyobjectoptionalPartial-year occupancy: the tenant's share, cap limit, and base-year or stop deduction are prorated by occupied days ÷ period days (both inclusive), so a full-year cap and base are not applied to a part year. Omit for a full year.
estimates_paidnumberoptionalEstimated CAM payments the tenant made during the year, USD (total for the year, not monthly).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_cam_reconciliation",
    "arguments": {
      "year": 0,
      "pro_rata_share": 0,
      "expenses": []
    }
  }
}
calc_cam_reconciliation_batchread-onlyReconcile CAM for a whole building in one call: the expense pool and gross-up once, then up to 500 tenants …

Reconcile CAM for a whole building in one call: the expense pool and gross-up once, then up to 500 tenants each with share, base year or expense stop, cap, admin fee, occupancy, estimates paid, and lease-specific excluded categories. Returns each tenant's statement (identical to calc_cam_reconciliation for that tenant, with its trace and warnings) and a building reconciliation: total billed against the recoverable pool, the unrecovered amount, and why (unleased or vacant share, lease exclusions, gross-up, caps, base years and stops, admin fees, zero floor, rounding). Deterministic: the same inputs always give the same result, with formula ID calc.cam_reconciliation_batch@1, every step, and any warnings.

ParameterTypeDescription
yearintegerrequiredCalendar or lease year being reconciled.
expensesobject[]requiredThe building's operating expense pool for the year, entered once for every tenant: category, amount, controllable, recoverable, variable, admin_fee_applies.
gross_upobjectoptionalGross up variable expenses to the target occupancy when actual occupancy is lower. Omit if the lease has no gross-up.
tenantsobject[]requiredEvery tenant to reconcile (up to 500): each one's share, structure (base year or stop), cap, admin fee, occupancy, estimates paid, and lease-specific exclusions. Each statement equals calc_cam_reconciliation for that tenant.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_cam_reconciliation_batch",
    "arguments": {
      "year": 0,
      "expenses": [],
      "tenants": []
    }
  }
}
calc_capex_recoveryread-onlyRecoverable capital expenditure under a lease clause: amortize a capital cost over its useful life or the …

Recoverable capital expenditure under a lease clause: amortize a capital cost over its useful life or the lease-specified period, straight-line (declining interest) or level payment, with interest on the unamortized balance or none; optionally cap each year's recovery at demonstrated cost savings (with or without carry-forward); and allocate each year to tenants by pro rata share. Every assumption is echoed with an optional lease clause citation. Deterministic: the same inputs always give the same result, with formula ID calc.capex_recovery@1, every step, and any warnings.

ParameterTypeDescription
costnumberrequiredCapital cost of the improvement to recover, USD (building level). Must be greater than 0.
amortization_yearsintegerrequiredYears over which the cost is recovered: the useful life, or the amortization period the lease specifies.
period_basisstringoptionalWhere amortization_years comes from: useful_life (e.g. under GAAP or tax guidance) or lease_specified (a period the lease states). Labels only. One of: useful_life, lease_specified
methodstringoptionalstraight_line: equal principal (cost ÷ years) plus interest on the declining unamortized balance, so recovery falls each year. level_payment: a level annual payment like a mortgage, cost × r ÷ (1 − (1 + r)^−years), split into interest and principal. Identical … One of: straight_line, level_payment
interest_rate_annualnumberoptionalAnnual interest on the unamortized balance as a decimal, e.g. 0.08; 0 (default) for none. Charged on the balance at the start of each year. Must be greater than -1. Must be less than 10.
first_yearintegeroptionalCalendar or lease year of the first recovery year, e.g. 2026; labels the schedule rows. Omit to number years 1, 2, 3.
cost_savings_capobjectoptionalCost-savings limit: recovery in each year may not exceed the operating-cost savings the improvement demonstrably produces. Omit if the lease has none.
tenantsobject[]optionalTenants to allocate the annual recoverable amount to by pro rata share. Shares may sum to less than 1 (the landlord bears the rest), not more. Omit for the building-level schedule only.
clausesobjectoptionalLease clause behind each assumption, free text, echoed in the result's assumptions so a reviewer can check each against the lease.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_capex_recovery",
    "arguments": {
      "cost": 0,
      "amortization_years": 0
    }
  }
}
calc_compare_proposalsread-onlyRank 2–20 lease proposals with different terms, sizes, free rent, TI, concessions, and operating-expense …

Rank 2–20 lease proposals with different terms, sizes, free rent, TI, concessions, and operating-expense structures (gross, NNN, base year, expense stop, with opex growth) on one discounted $/SF/yr basis, per rentable or usable SF (load factor): effective occupancy cost (tenant perspective) or discounted net effective rent after landlord-borne opex and optional pre-commencement downtime (landlord perspective). Cash flows monthly in advance at annual rate ÷ 12; warns when the usable-SF ranking differs and when terms differ. schedule.unit (kw, mw, unit, acre, key, room, space, the same for every proposal) ranks per kW, MW, unit, acre, key, room, or space instead of per SF. Deterministic: the same inputs always give the same result, with formula ID calc.compare_proposals@2, every step, and any warnings.

ParameterTypeDescription
perspectivestringoptionalWhose economics to rank on: tenant (effective occupancy cost, lower is better) or landlord (discounted net effective rent, higher is better). One of: tenant, landlord
discount_rate_annualnumberoptionalAnnual discount rate as a decimal, e.g. 0.08, applied to every proposal (monthly rate = annual ÷ 12, cash flows at the start of each month). Default 0.08, named in warnings when omitted: the ranking can change with the rate. Must be less than 1.
area_basisstringoptionalArea the $/SF/yr metric is divided by: rentable (schedule.area_sf, the default) or usable (each proposal's usable_sf, or area_sf ÷ load_factor). Rents and expenses stay quoted per rentable SF; use usable when proposals have different load factors and the … One of: rentable, usable
proposalsobject[]required2–20 proposals to compare.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_compare_proposals",
    "arguments": {
      "proposals": []
    }
  }
}
calc_critical_datesread-onlyDated list of a lease's notice deadlines and option windows, from its expiration date and options: each …

Dated list of a lease's notice deadlines and option windows, from its expiration date and options: each renewal option's notice deadline or notice window and renewal term (successive options count back from the term before), each termination option's last day to give notice, an expansion option deadline, and other deadlines (a stated date, or N days after a date such as a ROFO notice). Calendar months; N months before a date keeps the day of month, clamped to a shorter month's end (a warning gives the month-end reading when it is later). Deadlines on a weekend or US federal holiday (5 U.S.C. §6103, observed days included) are flagged, or rolled to the preceding or following business day when business_day_roll says so. With as_of: days to each event, passed deadlines warned, and the next deadline. Steps show each computation. Deterministic: the same inputs always give the same result, with formula ID calc.critical_dates@1, every step, and any warnings.

ParameterTypeDescription
expiration_datestringrequiredExpiration date of the current term (YYYY-MM-DD), as the lease or the latest amendment states it.
commencement_datestringoptionalCommencement date (YYYY-MM-DD). Optional; listed as an event and checked to be before expiration_date.
as_ofstringoptionalDate to measure from (YYYY-MM-DD), usually today. Deadlines before it are flagged as passed; next_deadline is the first one on or after it.
renewal_optionobjectoptionalRenewal options, as lease.renewal_option states them: each is exercised by notice counted back from the expiration in effect when it is exercised.
termination_optionsobject[]optionalEarly termination options, as lease.termination_option states them; notice counts back from each effective_date.
expansion_option_deadlinestringoptionalLast day to exercise an expansion option (lease.expansion_option_deadline), YYYY-MM-DD.
other_deadlinesobject[]optionalOther deadlines: expansion rights, ROFO or ROFR response periods, contraction rights.
business_day_rollstringoptionalWhat to do with a deadline that falls on a weekend or holiday: "none" (default) keeps the date and flags it; "preceding" moves it to the business day before (never later than the lease date: the safe choice); "following" moves it to the next business day, … One of: none, preceding, following
holidaysstringoptionalHolidays that are not business days: "us_federal" (the eleven US federal holidays of 5 U.S.C. §6103(a), with the federal observed day when one falls on a weekend) or "none" (weekends only). One of: us_federal, none

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_critical_dates",
    "arguments": {
      "expiration_date": "..."
    }
  }
}
calc_dcf_pro_formaread-onlyProperty-level discounted cash flow from an in-place rent roll: each lease's rent, escalations, remaining …

Property-level discounted cash flow from an in-place rent roll: each lease's rent, escalations, remaining term, and expense recovery (NNN, gross, base year), then at expiration one blended lease weighted by the renewal probability (renewal vs new-tenant rent, free rent, TI, leasing commissions, and new-tenant downtime, with fractional downtime and free rent kept as part months rather than rounded); market rent growth, general vacancy and credit loss, operating expenses, management fee, and capital reserves. Returns the annual cash-flow table (NOI and cash flow before debt) for the hold plus one year, the exit value at a cap rate on forward (or trailing) NOI less selling costs, the value (PV at the discount rate, end-of-year or mid-year), and with a purchase price the NPV, unlevered IRR, and equity multiple, with every lease event and convention stated. Deterministic: the same inputs always give the same result, with formula ID calc.dcf_pro_forma@2, every step, and any warnings.

ParameterTypeDescription
hold_yearsintegerrequiredHolding period in years. The property is sold at the end of the last year; one more year is projected for the forward NOI.
leasesobject[]requiredRent roll: one entry per lease or vacant suite (at most 200). The building area is the sum of their areas.
market_leasingobjectrequiredMarket leasing assumptions applied at every lease expiration (and to space vacant at the start). A lease's own `leasing` object overrides any of them.
market_rent_growth_ratenumberoptionalAnnual market rent growth, e.g. 0.03. Market rent and TI in analysis year y = today's × (1 + g)^(y − 1). Must be greater than -1. Must be less than 1.
operating_expenses_psf_annualnumberoptionalYear-1 recoverable operating expenses, USD/SF/yr over the whole building area.
non_recoverable_expenses_annualnumberoptionalYear-1 operating expenses no tenant reimburses, USD/yr.
expense_growth_ratenumberoptionalAnnual growth of operating expenses and capital reserves, e.g. 0.03: year y = year 1 × (1 + g)^(y − 1). Must be greater than -1. Must be less than 1.
management_fee_ratenumberoptionalManagement fee as a share of effective gross revenue, e.g. 0.03; not recovered. Must be less than 1.
general_vacancy_ratenumberoptionalGeneral vacancy allowance as a share of gross revenue (base rent after free rent, plus recoveries), on top of the downtime modelled at rollover. Must be less than 1.
credit_loss_ratenumberoptionalCredit loss as a share of gross revenue, on top of general vacancy. Must be less than 1.
capital_reserve_psf_annualnumberoptionalYear-1 capital reserve, USD/SF/yr over the building area, below NOI. Grows with expense_growth_rate.
exit_cap_ratenumberrequiredExit (terminal) cap rate applied to the exit NOI, e.g. 0.07. Must be greater than 0. Must be less than 1.
exit_noi_basisstringoptional"forward": the NOI of the year after the hold (the usual convention); "trailing": the NOI of the final hold year. One of: forward, trailing
selling_cost_ratenumberoptionalSelling costs as a share of the gross sale price, e.g. 0.02. Must be less than 1.
discount_ratenumberrequiredAnnual unlevered discount rate, e.g. 0.08. The present value at this rate is the value. Must be less than 1.
timingstringoptional"end_of_year": each year's cash flow is discounted (1 + r)^y (Excel NPV). "mid_year": operating cash flows at (1 + r)^(y − 0.5); the sale is always discounted at the end of the hold. One of: end_of_year, mid_year
purchase_pricenumberoptionalPrice paid at the start, USD. Adds the NPV (value − price), the unlevered IRR and the going-in cap rate on price. Must be greater than 0.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_dcf_pro_forma",
    "arguments": {
      "hold_years": 0,
      "leases": [],
      "market_leasing": {},
      "exit_cap_rate": 0,
      "discount_rate": 0
    }
  }
}
calc_debt_sizingread-onlySize the maximum loan under any combination of max LTV, min DSCR, and min debt yield for a given NOI, rate, …

Size the maximum loan under any combination of max LTV, min DSCR, and min debt yield for a given NOI, rate, and amortization. Reports the binding constraint, debt service, and resulting metrics; optionally a stress table over NOI, rate, and value shocks (max loan, binding constraint, LTV, DSCR, debt yield per scenario) and the refinance shortfall against an existing loan balance. Deterministic: the same inputs always give the same result, with formula ID calc.debt_sizing@3, every step, and any warnings.

ParameterTypeDescription
noinumberrequiredUnderwritten net operating income, USD/yr. Must be greater than 0.
valuenumberoptionalAppraised or underwritten value, USD. Required when max_ltv is set. Must be greater than 0.
rate_annualnumberrequiredAnnual interest rate, e.g. 0.065. Must be less than 1.
amortization_yearsintegerrequiredAmortization in years; 0 means interest-only.
max_ltvnumberoptionalMaximum loan-to-value, e.g. 0.65. Must be greater than 0.
min_dscrnumberoptionalMinimum debt service coverage ratio, e.g. 1.25. Must be greater than 0.
min_debt_yieldnumberoptionalMinimum debt yield (NOI ÷ loan), e.g. 0.09. Must be greater than 0. Must be less than 1.
round_down_tonumberoptionalRound the final loan amount down to this increment (lenders often use 1,000 or 10,000). Must be greater than 0.
existing_loan_balancenumberoptionalBalance of the loan being refinanced, USD. Adds a refinance result (shortfall or excess proceeds against the max loan) and a shortfall per stress scenario. Must be greater than 0.
stressobjectoptionalStress table: every combination of the NOI, rate, and value shocks (up to 1,000 scenarios), each sized under the same constraints and rounding. The base result is unchanged.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_debt_sizing",
    "arguments": {
      "noi": 0,
      "rate_annual": 0,
      "amortization_years": 0
    }
  }
}
calc_direct_capread-onlyValue by direct capitalization: (NOI − capital reserve) ÷ cap rate, then below-the-line deductions for …

Value by direct capitalization: (NOI − capital reserve) ÷ cap rate, then below-the-line deductions for lease-up costs, free-rent burn-off, and other adjustments to an as-is value (optionally rounded); and the cap rate a price implies, before and after reserves and all-in after the below-the-line costs. Records the NOI basis (trailing, forward, stabilized). Deterministic: the same inputs always give the same result, with formula ID calc.direct_cap@1, every step, and any warnings.

ParameterTypeDescription
noinumberrequiredNet operating income to capitalize, USD/yr, before capital reserves (they are deducted separately below). Must be greater than 0.
noi_basisstringoptionalWhat the NOI is: trailing 12 months (T-12), forward 12 months (year 1 of a pro forma), or stabilized. The cap rate must be on the same basis; this is recorded in the steps, not checked. One of: trailing_12, forward_12, stabilized
cap_ratenumberoptionalCapitalization rate as a decimal, e.g. 0.065 for 6.5%. Gives the value. Provide cap_rate, price, or both. Must be greater than 0. Must be less than 1.
pricenumberoptionalPurchase or asking price, USD. Gives the implied cap rate. Provide cap_rate, price, or both. Must be greater than 0.
capex_reserve_annualnumberoptionalAnnual capital (replacement) reserve deducted from NOI before capitalizing, USD/yr. 0 if the NOI is already after reserves.
lease_up_costsnumberoptionalOne-time costs to reach the stabilized NOI (TI, leasing commissions, lost rent during lease-up), USD, deducted from the capitalized value.
free_rent_burn_offnumberoptionalFree rent still to be given under signed leases (rent the stabilized NOI assumes but the owner will not collect), USD, deducted from the capitalized value.
other_adjustmentsobject[]optionalFurther below-the-line value adjustments, applied after capitalizing.
area_sfnumberoptionalRentable area in SF, for value per SF. Optional. Must be greater than 0.
round_value_tonumberoptionalAlso report the as-is value rounded to this increment (half away from zero), e.g. 100000 as appraisers round. Optional. Must be greater than 0.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_direct_cap",
    "arguments": {
      "noi": 0
    }
  }
}
calc_equity_waterfallread-onlySplit periodic project equity cash flows between LP and GP: preferred return (compounding or simple) and …

Split periodic project equity cash flows between LP and GP: preferred return (compounding or simple) and return of capital pro rata to capital in either order, an optional GP catch-up, IRR-hurdle tiers with promote splits measured on the LP's IRR, and a residual split. Returns per-period LP and GP contributions and distributions (with the GP's promote) that foot to the cent, and LP, GP, and project IRRs and multiples, with the conventions to confirm against the operating agreement. Deterministic: the same inputs always give the same result, with formula ID calc.equity_waterfall@1, every step, and any warnings.

ParameterTypeDescription
cash_flowsnumber[]requiredProject-level equity cash flows at t = 0, 1, 2, … periods: negative = capital contributed by the investors, positive = cash available to distribute. At most 600.
periods_per_yearintegeroptionalCash-flow periods per year: 1 annual, 4 quarterly, 12 monthly. Sets the pref accrual per period and annualizes the IRRs.
lp_sharenumberrequiredShare of every contribution funded by the LP, e.g. 0.9; the GP co-invests the rest (1 for no GP capital). Capital, pref, and the non-promote part of every split are shared in this ratio. Must be greater than 0.
prefobjectoptionalPreferred return on unreturned capital, paid to all investors pro rata to capital. Omit for none.
distribution_orderstringoptionalWhich comes first from each distribution: accrued pref, then return of capital (the usual order), or capital first. One of: pref_then_capital, capital_then_pref
catch_upobjectoptionalGP catch-up after the pref and return of capital. Omit for none.
tiersobject[]optionalIRR-hurdle tiers after the catch-up, in increasing until_irr order: each distributes with its promote until the LP's IRR reaches until_irr.
residual_promotenumberoptionalGP promote share of everything after the last tier, e.g. 0.3 for a 70/30 split. Must be less than 1.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_equity_waterfall",
    "arguments": {
      "cash_flows": [],
      "lp_share": 0
    }
  }
}
calc_exchange_1031read-onlyNot tax advice: arithmetic only. The 45-day identification and 180-day exchange deadlines of IRC §1031(a)(3) …

Not tax advice: arithmetic only. The 45-day identification and 180-day exchange deadlines of IRC §1031(a)(3) (the exchange period ends earlier at a given tax-return due date), the three-property, 200%, and 95% identification tests of Treas. Reg. §1.1031(k)-1(c)(4), and the cash boot, mortgage boot, debt replacement, and trade-down of an exchange, with the boot-limited gain when the basis is given. Deterministic: the same inputs always give the same result, with formula ID calc.exchange_1031@2, every step, and any warnings.

ParameterTypeDescription
relinquished_transfer_datestringrequiredDate the relinquished property was transferred (closed), YYYY-MM-DD. With several relinquished properties, the earliest transfer starts both periods.
tax_return_due_datestringoptionalDue date, including extensions, of the taxpayer's federal return for the year of the transfer, YYYY-MM-DD. IRC §1031(a)(3)(B) ends the exchange period on this date if it is earlier than day 180. FactLot does not compute it.
as_ofstringoptionalDate to count the days remaining from, YYYY-MM-DD. Optional.
relinquishedobjectrequiredThe property given up.
cash_received_at_salenumberoptionalCash the taxpayer took from the sale proceeds instead of leaving them with the qualified intermediary, USD.
replacementobjectoptionalThe property acquired (in total). Omit to check only the deadlines and identification.
identified_propertiesobject[]optionalReplacement properties identified in writing. Empty to skip the identification checks.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_exchange_1031",
    "arguments": {
      "relinquished_transfer_date": "...",
      "relinquished": {}
    }
  }
}
calc_hotel_metricsread-onlyOccupancy, ADR, RevPAR, TRevPAR, and a USALI-style profit ladder for a period: departmental profit, GOP and …

Occupancy, ADR, RevPAR, TRevPAR, and a USALI-style profit ladder for a period: departmental profit, GOP and margin, GOPPAR, management fees, EBITDA, FF&E reserve, and NOI (EBITDA less replacement reserve). Deterministic: the same inputs always give the same result, with formula ID calc.hotel_metrics@1, every step, and any warnings.

ParameterTypeDescription
nightsintegerrequiredNights in the period, e.g. 365 for a year or 30 for a month.
roomsintegerrequiredRooms in inventory (keys).
rooms_out_of_orderintegeroptionalRoom-nights (rooms × nights, not rooms) taken off the market in the period, e.g. 20 rooms closed for a 30-night renovation = 600. Subtracted from rooms × nights to give rooms available. USALI (11th ed.) keeps short-term out-of-order rooms in rooms available; …
rooms_soldintegerrequiredRoom-nights occupied by paying guests in the period (USALI: rooms sold, excluding complimentary rooms).
room_revenuenumberrequiredRooms revenue for the period, USD (USALI Rooms department revenue, net of taxes and allowances).
fb_revenuenumberoptionalFood and beverage revenue, USD (USALI Food and Beverage department revenue).
other_revenuenumberoptionalOther operated departments plus miscellaneous income, USD (USALI Other Operated Departments and Miscellaneous Income).
departmental_expensesnumberoptionalTotal departmental expenses, USD: rooms, F&B, and other operated departments (USALI Total Departmental Expenses).
undistributed_expensesnumberoptionalTotal undistributed operating expenses, USD: administrative and general, information and telecommunications, sales and marketing, property operation and maintenance, utilities (USALI Total Undistributed Operating Expenses).
management_fee_ratenumberoptionalBase management fee as a share of total operating revenue, e.g. 0.03 (USALI Management Fees). Must be less than 1.
management_fee_fixednumberoptionalFixed or incentive management fee for the period, USD, added to the percentage fee (USALI Management Fees).
non_operating_expensesnumberoptionalProperty taxes, insurance, ground rent, and other non-operating expenses, USD (USALI Non-Operating Income and Expenses).
ffe_reserve_ratenumberoptionalFF&E replacement reserve as a share of total operating revenue, e.g. 0.04 (USALI Replacement Reserve, below EBITDA). Must be less than 1.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_hotel_metrics",
    "arguments": {
      "nights": 0,
      "rooms": 0,
      "rooms_sold": 0,
      "room_revenue": 0
    }
  }
}
calc_irrread-onlyPeriodic and annualized IRR of periodic cash flows, as decimals (0.085 = 8.5%), solved deterministically by …

Periodic and annualized IRR of periodic cash flows, as decimals (0.085 = 8.5%), solved deterministically by scanning a 1-point grid of per-period rates and bisecting each sign change; reports every root it finds when cash flows have multiple IRRs (two roots within one grid step can be missed). Errors when the flows do not change sign or no root lies between -99.99% and 1000% per period. Deterministic: the same inputs always give the same result, with formula ID calc.irr@2, every step, and any warnings.

ParameterTypeDescription
cash_flowsnumber[]requiredPeriodic cash flows at t = 0, 1, 2, …; negative for outflows (e.g. purchase price at t = 0). At most 1200.
periods_per_yearintegeroptionalCash-flow periods per year, used only to annualize the result: 1 for annual flows, 4 for quarterly, 12 for monthly.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_irr",
    "arguments": {
      "cash_flows": []
    }
  }
}
calc_lease_remeasurement_asc842read-onlyRemeasure a lessee's lease liability and right-of-use asset under ASC 842 after a modification, lease-term …

Remeasure a lessee's lease liability and right-of-use asset under ASC 842 after a modification, lease-term reassessment, contingency resolution, or residual value guarantee change: new liability (PV of remaining payments), liability and ROU adjustments with any gain (ASC 842-20-35-4), and the per-period amortization table (operating: straight-line single lease cost; finance: interest plus amortization) in cents that foots: every row rolls forward exactly, totals are the row sums, and the final period trues up liability and ROU asset to zero. Warns where judgment is needed. Deterministic: the same inputs always give the same result, with formula ID calc.lease_remeasurement_asc842@2, every step, and any warnings.

ParameterTypeDescription
classificationstringrequiredLessee classification (ASC 842-10-25-2): operating (single straight-line lease cost) or finance (interest on the liability plus straight-line ROU amortization). One of: operating, finance
paymentsobject[]requiredRemaining lease payments after the event, in ascending period order. Periods not listed carry no payment (rent-free).
remaining_periodsintegeroptionalRemaining lease term in periods after the event. Defaults to the last period index in payments; set it higher when the final periods are rent-free.
payment_timingstringoptionalWhether each payment falls at the beginning (in advance) or end (in arrears) of its period. One of: begin, end
discount_rate_annualnumberrequiredAnnual discount rate applied to the remaining payments, e.g. 0.06. Nominal: the periodic rate is this ÷ periods_per_year. Must be less than 1.
periods_per_yearintegeroptionalPayment periods per year (12 for monthly, 4 for quarterly).
discount_rate_updatedbooleanrequiredTrue when discount_rate_annual was determined at the remeasurement date (ASC 842-10-35-5: required for modifications and lease-term or purchase-option reassessments); false when it is the rate from commencement (kept for contingency resolutions and residual …
liability_beforenumberrequiredCarrying amount of the lease liability immediately before the remeasurement, USD.
rou_asset_beforenumberrequiredCarrying amount of the right-of-use asset immediately before the remeasurement, USD (after any impairment).
eventstringrequiredWhat triggered the remeasurement: modification_extend_term / modification_shorten_term / modification_change_in_payments (a modification not accounted for as a separate contract, ASC 842-10-25-8 and 25-11), reassessment_of_term_or_option (ASC 842-10-35-1 and … One of: modification_extend_term, modification_shorten_term, modification_change_in_payments, reassessment_of_term_or_option, contingency_resolved, residual_value_guarantee_change, index_or_rate_change

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_lease_remeasurement_asc842",
    "arguments": {
      "classification": "operating",
      "payments": [],
      "discount_rate_annual": 0,
      "discount_rate_updated": false,
      "liability_before": 0,
      "rou_asset_before": 0,
      "event": "modification_extend_term"
    }
  }
}
calc_lease_vs_ownread-onlyCompare leasing with buying over a fixed horizon: NPV of each case's annual cash costs (rent, free rent, …

Compare leasing with buying over a fixed horizon: NPV of each case's annual cash costs (rent, free rent, tenant expenses, and move-in costs versus equity, debt service, owner expenses, reserves, and a sale at the horizon by stated value or exit cap rate), optionally after tax, with the year-by-year tables and the break-even residual value at which owning equals leasing. Deterministic: the same inputs always give the same result, with formula ID calc.lease_vs_own@2, every step, and any warnings.

ParameterTypeDescription
horizon_yearsintegerrequiredAnalysis horizon in years. Both cases are compared over this period; the own case sells at the end of it.
discount_rate_annualnumberrequiredAnnual discount rate as a decimal, e.g. 0.08, applied to both cases' year-end cash flows (year 0 = closing / move-in). Must be less than 1.
leaseobjectrequiredThe lease alternative.
ownobjectrequiredThe purchase alternative.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_lease_vs_own",
    "arguments": {
      "horizon_years": 0,
      "discount_rate_annual": 0,
      "lease": {},
      "own": {}
    }
  }
}
calc_multifamily_rent_rollread-onlyAnalyze an apartment rent roll (up to 5,000 units with status occupied, notice, vacant, model, or down; …

Analyze an apartment rent roll (up to 5,000 units with status occupied, notice, vacant, model, or down; market and lease rent per month; lease dates; concessions as weeks free, months free, or dollars): gross potential rent, vacancy, non-revenue units, loss to lease, concessions amortised straight-line over each lease term, effective rent income, physical and economic occupancy, effective rent per unit and per SF, a lease expiration schedule by month, and a per-unit-type summary. Single-lease mode (lease instead of units) returns the effective monthly rent after a weeks-free or months-free concession. Deterministic: the same inputs always give the same result, with formula ID calc.multifamily_rent_roll@1, every step, and any warnings.

ParameterTypeDescription
as_ofstringoptionalRent roll date, YYYY-MM-DD. Required with units: leases that ended before it are month-to-month, and expirations are scheduled from it.
unitsobject[]optionalRent roll mode: every unit in the property, one row each (up to 5,000). Give units or lease, not both.
leaseobjectoptionalSingle-lease mode: the effective monthly rent of one lease after a weeks-free, months-free, or dollar concession. Give units or lease, not both.
include_unitsbooleanoptionalRent roll mode: include a per-unit table with loss to lease, amortised concession, and effective rent (can be long).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_multifamily_rent_roll",
    "arguments": {}
  }
}
calc_net_effective_rentread-onlyCompute effective rent, straight-line net effective rent, and discounted net effective rent ($/SF/yr) after …

Compute effective rent, straight-line net effective rent, and discounted net effective rent ($/SF/yr) after free rent, TI allowance, leasing commissions, and other landlord concessions. Rent is monthly in advance from the commencement day (no calendar proration), discounted at annual rate ÷ 12. schedule.unit (kw, mw, unit, acre, key, room, space) reports $/kW/yr, $/acre/yr and so on instead of $/SF/yr. Deterministic: the same inputs always give the same result, with formula ID calc.net_effective_rent@1, every step, and any warnings.

ParameterTypeDescription
scheduleobjectrequiredThe lease's base-rent terms (same input as calc_rent_schedule).
ti_allowance_psfnumberoptionalLandlord-funded tenant improvement allowance, USD per SF (per schedule.unit when set), paid once at commencement (not per year).
leasing_commissionsnumberoptionalTotal leasing commissions paid by landlord, USD.
other_concessionsnumberoptionalAny other landlord concessions paid at commencement (moving allowance, buyout), USD.
discount_rate_annualnumberoptionalAnnual discount rate as a decimal, e.g. 0.08 (monthly rate = annual ÷ 12); 0 gives the undiscounted (straight-line) NER. Must be less than 1.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_net_effective_rent",
    "arguments": {
      "schedule": {}
    }
  }
}
calc_npvread-onlyNPV of periodic cash flows (t = 0, 1, 2, ...; the t = 0 flow is not discounted) at a per-period discount rate …

NPV of periodic cash flows (t = 0, 1, 2, ...; the t = 0 flow is not discounted) at a per-period discount rate given as a decimal. Deterministic: the same inputs always give the same result, with formula ID calc.npv@1, every step, and any warnings.

ParameterTypeDescription
cash_flowsnumber[]requiredPeriodic cash flows at t = 0, 1, 2, …; negative for outflows (e.g. purchase price at t = 0). At most 10000.
ratenumberrequiredDiscount rate per period as a decimal, e.g. 0.08 for 8%. Match the cash-flow period: for monthly flows pass the monthly rate (e.g. 0.06 ÷ 12 = 0.005). Must be greater than -1.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_npv",
    "arguments": {
      "cash_flows": [],
      "rate": 0
    }
  }
}
calc_percentage_rentread-onlyPercentage (overage) rent for a lease year: net sales after exclusions over a natural or fixed breakpoint, …

Percentage (overage) rent for a lease year: net sales after exclusions over a natural or fixed breakpoint, prorated for partial years, less amounts already paid. Deterministic: the same inputs always give the same result, with formula ID calc.percentage_rent@1, every step, and any warnings.

ParameterTypeDescription
gross_salesnumberrequiredGross sales reported for the lease year (or partial year), USD.
sales_exclusionsnumberoptionalSales excluded by the lease (returns, sales tax, gift cards, employee sales, …), USD.
ratenumberrequiredPercentage rent rate, e.g. 0.06 for 6%. Must be greater than 0. Must be less than 1.
base_rent_annualnumberrequiredAnnual base rent, USD per year (a full lease year, even for a partial period); used for the natural breakpoint.
breakpointobjectoptionalBreakpoint above which percentage rent applies. Default: natural.
period_fractionnumberoptionalFraction of a full lease year covered (e.g. 0.5 for a six-month partial year). Prorates the breakpoint. Must be greater than 0.
percentage_rent_paidnumberoptionalPercentage rent already paid during the period, USD.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_percentage_rent",
    "arguments": {
      "gross_sales": 0,
      "rate": 0,
      "base_rent_annual": 0
    }
  }
}
calc_prepayment_and_defeasanceread-onlyPrepayment premium, total payoff, and cost as a share of balance for a fixed-rate amortizing or interest-only …

Prepayment premium, total payoff, and cost as a share of balance for a fixed-rate amortizing or interest-only loan under yield maintenance (PV of remaining payments or rate differential, with a minimum and an explicit discounting convention), a step-down schedule, a flat percentage, or defeasance (cost of the securities portfolio that funds the remaining payments plus stated costs). Deterministic: the same inputs always give the same result, with formula ID calc.prepayment_and_defeasance@1, every step, and any warnings.

ParameterTypeDescription
balancenumberrequiredOutstanding principal balance at the payoff date, USD. Must be greater than 0.
note_rate_annualnumberrequiredFixed annual note rate, e.g. 0.055. Must be less than 1.
remaining_term_monthsintegerrequiredMonths from the payoff date to the loan's maturity date (the balloon is due with the final payment).
amortization_monthsintegerrequiredRemaining amortization basis in months at the payoff date (e.g. 300 for a 30-year schedule with 5 years elapsed); 0 for interest-only. Must be at least remaining_term_months.
accrued_interestnumberoptionalAccrued but unpaid interest to the payoff date, USD; added to the total payoff.
prepaymentobjectrequiredPrepayment provision from the note.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_prepayment_and_defeasance",
    "arguments": {
      "balance": 0,
      "note_rate_annual": 0,
      "remaining_term_months": 0,
      "amortization_months": 0,
      "prepayment": "..."
    }
  }
}
calc_reconcile_camread-onlyReconcile FactLot's CAM reconciliation for one expense pool with another system's per-tenant results (Yardi …

Reconcile FactLot's CAM reconciliation for one expense pool with another system's per-tenant results (Yardi or any other; parity is not claimed and is untested against a real export): give the calc_cam_reconciliation_batch input plus, per tenant, what the other system reported (share, gross-up, cap limit and reduction, admin fee, base-year or stop deduction, billed amount, estimates, balance; billed_amount required) and a tolerance. Returns per tenant and line FactLot's amount, the other amount, the difference and whether it is within tolerance, tenants missing on either side, and likely causes worded as hypotheses to check: a different pro rata share (and, when every share differs by one factor, the pool's denominator), or a FactLot rerun that matches the other system with lines left to the default controllable: true set uncontrollable, the cap's base year one year off, the other cap method, the other gross-up target or no gross-up, the admin fee before or after and within or outside the cap, or no fee on uncontrollable lines; and differing estimates paid. Deterministic: the same inputs always give the same result, with formula ID calc.reconcile_cam@1, every step, and any warnings.

ParameterTypeDescription
camobjectrequiredThe FactLot CAM input for one expense pool, exactly as calc_cam_reconciliation_batch takes it (the same pool, shares and lease terms you entered in the other system).
otherobjectrequiredWhat the other system reported for the same pool and year.
toleranceobjectoptionalWhen two amounts agree: |FactLot − other| ≤ max(absolute, relative × |other|); shares within share. Default: 1.00 USD, 0, and 0.000001.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_reconcile_cam",
    "arguments": {
      "cam": {},
      "other": {}
    }
  }
}
calc_reconcile_dcfread-onlyReconcile FactLot's DCF with another system's export (ARGUS or any other model; parity is not claimed and is …

Reconcile FactLot's DCF with another system's export (ARGUS or any other model; parity is not claimed and is untested against real ARGUS output): give the calc_dcf_pro_forma input plus the other system's annual lines {label, values: [year 1, …]}, optionally its value, unlevered IRR and sale price, a tolerance (absolute and relative) and your label mapping. Labels map to FactLot lines by your mapping, else by common CRE line names (Potential Base Rent, Absorption & Turnover Vacancy, Free Rent, Expense Reimbursements, General Vacancy, Credit Loss, Effective Gross Revenue, Operating Expenses, Net Operating Income, Tenant Improvements, Leasing Commissions, Capital Reserves, Cash Flow Before Debt Service); positive deductions are negated (sign_convention). Returns per line and year FactLot's amount, the other amount, the difference and whether it is within tolerance; unmapped labels; and for each differing line a likely_cause from FactLot's documented conventions, worded as a hypothesis to check: differences only in rollover years (fractional downtime and free rent), a rate on a different base (general vacancy), only the exit year, a one-year shift, management fee inside operating expenses, a growth rate, a constant factor or amount, rounding; and for the value FactLot rerun with mid-year or end-of-year discounting, the other exit NOI basis, or no selling costs. Deterministic: the same inputs always give the same result, with formula ID calc.reconcile_dcf@1, every step, and any …

ParameterTypeDescription
dcfobjectrequiredThe FactLot DCF input, exactly as calc_dcf_pro_forma takes it (the same rent roll and assumptions you entered in the other system).
otherobjectrequiredWhat the other system reported for the same property.
mappingobject[]optionalYour label mappings; they override the defaults (common CRE line names such as Potential Base Rent, General Vacancy, Net Operating Income, Cash Flow Before Debt Service).
sign_conventionstringoptionalFactLot reports deductions (free rent, vacancy, credit loss, expenses, fees, TI, commissions, reserves) as negative amounts. "auto": a deduction line whose amounts are all zero or positive is read as positive deductions and negated; "as_reported": compare as … One of: auto, as_reported, deductions_positive
toleranceobjectoptionalWhen two amounts agree: |FactLot − other| ≤ max(absolute, relative × |other|); the IRR within irr. Default: 1.00 USD, 0, and one basis point.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_reconcile_dcf",
    "arguments": {
      "dcf": {},
      "other": {}
    }
  }
}
calc_renew_vs_relocateread-onlyCompare renewing in place with moving over one horizon: NPV and discounted effective rent of each case (rent …

Compare renewing in place with moving over one horizon: NPV and discounted effective rent of each case (rent schedule with free rent, TI net of allowance, fees, moving, downtime, double rent, termination, and disruption costs), the starting rent at which they break even, and year-by-year cash flows. Deterministic: the same inputs always give the same result, with formula ID calc.renew_vs_relocate@2, every step, and any warnings.

ParameterTypeDescription
horizon_monthsintegerrequiredAnalysis horizon in months; both cases run for this term (e.g. 120 for a ten-year renewal versus a ten-year new lease).
discount_rate_annualnumberoptionalAnnual discount rate as a decimal, e.g. 0.08, applied to both cases (monthly rate = annual ÷ 12). Must be less than 1.
current_rent_monthlynumberoptionalTotal monthly rent under the existing lease, USD per month for the whole premises (not $/SF). Prices the double-rent overlap in the relocate case.
renewobjectrequiredStay and renew the existing lease.
relocateobjectrequiredMove to new premises.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_renew_vs_relocate",
    "arguments": {
      "horizon_months": 0,
      "renew": {},
      "relocate": {}
    }
  }
}
calc_rent_scheduleread-onlyBuild a base-rent schedule from commencement date, term, area, starting $/SF/yr, escalations (percent or …

Build a base-rent schedule from commencement date, term, area, starting $/SF/yr, escalations (percent or fixed $/SF), and abated months. Lease months run from the commencement day-of-month with no calendar proration (warns when commencement is mid-month). Returns rent steps, totals, expiration date, and a calculation trace. Optional unit (kw, mw, unit, acre, key, room, space) relabels area and $/SF for data-center, ground, yard, residential, hotel, or parking leases without changing any number. Deterministic: the same inputs always give the same result, with formula ID calc.rent_schedule@1, every step, and any warnings.

ParameterTypeDescription
commencement_datestringrequiredRent commencement date, YYYY-MM-DD. Month n starts on this day-of-month (clamped to month end).
term_monthsintegerrequiredLease term in months, e.g. 120 for ten years.
area_sfnumberrequiredRentable square feet, or the quantity leased in unit (kW, MW, units, acres, keys, rooms, spaces) when unit is set. Must be greater than 0.
starting_rent_psf_annualnumberrequiredYear-one base rent in dollars per SF per year (annual, not monthly), e.g. 42.5; per unit per year when unit is set (a $/kW/month quote × 12).
escalationobjectoptionalHow base rent escalates. Omit for flat rent.
abated_monthsinteger[]optionalFully abated (free) months, 1-based from commencement (e.g. [1,2,3] for three months free up front). Each listed month's base rent is zero.
round_rate_to_centsbooleanoptionalRound each step's $/SF/yr to cents, as many lease rent tables do.
include_monthlybooleanoptionalInclude a month-by-month table (can be long).
unitstringoptionalWhat area_sf and the per-SF fields measure: sf (default, square feet), kw or mw (data-center critical load), unit (apartment or other unit), acre (ground or yard lease), key or room (hotel), or space (parking). Every number is computed exactly as for square … One of: sf, kw, mw, unit, acre, key, room, space

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_rent_schedule",
    "arguments": {
      "commencement_date": "...",
      "term_months": 0,
      "area_sf": 0,
      "starting_rent_psf_annual": 0
    }
  }
}
calc_tx_unequal_appraisalread-onlyEvidence calculation only: not an appraisal or an opinion of value, not legal or tax advice, and not a …

Evidence calculation only: not an appraisal or an opinion of value, not legal or tax advice, and not a substitute for the advice of an attorney. The arithmetic of Tex. Tax Code §41.43(b)(3) and §42.26(a)(3), the subject's value against the median appraised value of a reasonable number of comparable properties appropriately adjusted. Takes 3–200 comparables chosen by the caller, each with its roll value and the caller's adjustments (percent, USD amount, or $/SF, each with a reason); optionally normalizes each comparable to value per SF of improvement or land area times the subject's area; applies percentages summed or compounded, then amounts; and returns every comparable's normalized and adjusted value, the sorted list, the median (for an even count, the mean of the two middle values), and the subject's value minus the median in USD (subject_minus_median) and as a fraction of the median (subject_minus_median_pct: 0.1554 means 15.54%, a decimal like every rate in FactLot, not 0.1554%), with the statutes cited. Warns on mixed value bases, §42.26(d) and the §23.231 limitation, comparables in another county, fewer than 5 comparables, total adjustments over 25%, a comparable identical to the subject, no adjustments at all (the median is then unadjusted), and, with normalize_by none, a comparable whose area differs from the subject's by more than 25%. Each comparable row carries flags (code and sentence, facts about the inputs, never a reason the tool drops anything): value per SF …

ParameterTypeDescription
tax_yearintegerrequiredTax year of the values compared, e.g. 2027. Decides which text of §42.26(d) applies.
subjectobjectrequiredThe property whose value is compared.
normalize_bystringoptional"none" compares whole values. "improvement_area_sf" or "land_area_sf" converts each comparable to value per SF of that area and multiplies by the subject's same area before adjusting; the subject and every comparable must then have that area. One of: none, improvement_area_sf, land_area_sf
adjustment_combinestringoptional"sum" adds a comparable's percentage adjustments and applies the total once (the usual adjustment grid); "compound" multiplies (1 + each percentage). One of: sum, compound
comparablesobject[]requiredThe comparable properties, 3 to 200, chosen by the caller. Values must be on the same basis as the subject's.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_tx_unequal_appraisal",
    "arguments": {
      "tax_year": 0,
      "subject": {},
      "comparables": []
    }
  }
}
calc_waltread-onlyWeighted average remaining lease term in years as of a date (actual days ÷ 365.25), weighted by each lease's …

Weighted average remaining lease term in years as of a date (actual days ÷ 365.25), weighted by each lease's area_sf (weight_by "area") or annual_rent (weight_by "rent"). Deterministic: the same inputs always give the same result, with formula ID calc.walt@1, every step, and any warnings.

ParameterTypeDescription
as_ofstringrequiredDate to measure remaining term from, YYYY-MM-DD.
weight_bystringoptionalHow each lease is weighted: "area" uses its area_sf, "rent" its annual_rent (that field is then required on every lease). Default "area". One of: area, rent
leasesobject[]requiredLeases in the portfolio or building.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "calc_walt",
    "arguments": {
      "as_of": "...",
      "leases": []
    }
  }
}
doc_abstract_leaseread-onlyCurrent-state lease abstract from a lease and its amendments, with amendment precedence, as of as_of. Give …

Current-state lease abstract from a lease and its amendments, with amendment precedence, as of as_of. Give each document's pages with the candidates you extracted (checked exactly as doc_verify_facts checks them), or the facts doc_verify_facts already returned for it (without pages only the value against its quote is rechecked, marked quote_on_page: false). Documents may come in any order: give the lease role original and each amendment role amendment with its effective_date (without a role the lease is inferred only when that is unambiguous, otherwise it is an input error; two or more amendments need effective dates). The original applies first, then amendments by effective_date; a later document's value for a predicate controls, and the earlier one moves to history and is linked through supersedes. An amendment effective after as_of is pending: its values are listed under pending and pending_facts with a warning and do not control. A rent schedule restated from a later date keeps the earlier steps before it (carried_forward). Each field gives its value, the controlling document, page, quote and fact, the superseded history, conflicts (two different values from one document, or from two documents of the same rank), pending values and open_items (a candidate for that predicate in the controlling or a later document that needs review or was rejected, so the value may not be final). FactLot only orders what you extracted: it does not find terms you missed, and an amendment …

ParameterTypeDescription
documentsobject[]requiredThe lease and its amendments. Each needs pages with candidates or facts, or facts alone.
as_ofstringrequiredDate the facts are stated as of (YYYY-MM-DD), usually today.
subjectstringoptionalFactLot URN the facts are about, e.g. your lease's fl:lease:… ID. Default: the document ID.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "doc_abstract_lease",
    "arguments": {
      "documents": [],
      "as_of": "..."
    }
  }
}
doc_check_use_conflictread-onlyCheck a proposed use (a description, plus an optional use category or 2022 NAICS code) against a center's …

Check a proposed use (a description, plus an optional use category or 2022 NAICS code) against a center's verified lease.exclusive_use and lease.prohibited_uses facts (from doc_verify_facts or doc_abstract_lease; each must pass fact_validate). Deterministic and textual: a restriction is a potential conflict when it shares a use category with the proposed use (FactLot's published use-category vocabulary, matched on keywords, the category given and NAICS codes) or shares words with it (two or more, or every significant word of the restriction). Each hit is labelled "potential conflict — needs human review" and returns the controlling quote and citation, the categories and words that matched, and the exclusive's carve-outs, flagging those that mention the proposed use. FactLot does not interpret the lease, decide whether a carve-out applies, or give legal conclusions; an empty result does not mean there is no conflict. Superseded facts are ignored.

ParameterTypeDescription
factsobject[]requiredVerified lease.exclusive_use and lease.prohibited_uses facts for the center, from doc_verify_facts or doc_abstract_lease (each must pass fact_validate). Facts another fact supersedes are ignored; other predicates are skipped.
proposed_useobjectrequiredThe use to check.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "doc_check_use_conflict",
    "arguments": {
      "facts": [],
      "proposed_use": {}
    }
  }
}
doc_compareread-onlyCompare values another document asserts (an estoppel, rent roll or offering memo, mapped by you to …

Compare values another document asserts (an estoppel, rent roll or offering memo, mapped by you to predicates) with verified lease facts from doc_abstract_lease or doc_verify_facts. Each asserted value comes back match, mismatch (with the differing fields), not_in_lease, or ambiguous_in_lease (two current lease facts disagree), with the controlling lease citation (document, page, quote). Values compare exactly as JSON: numbers by value, strings exactly (a name written differently is a mismatch), and for an object only the fields you assert. Facts another fact supersedes are ignored. When the lease fact is an extracted fact whose quote does not confirm part of its value (a true/false value, an enum), the result lists those parts in lease_not_checked. The lease facts must pass fact_validate; FactLot does not re-read the lease, so pass the facts its document tools returned.

ParameterTypeDescription
lease_factsobject[]requiredVerified lease facts: the facts from doc_abstract_lease (or doc_verify_facts). Facts another fact supersedes are ignored.
assertedobject[]requiredValues another document states (an estoppel, a rent roll, an OM), mapped to predicates.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "doc_compare",
    "arguments": {
      "lease_facts": [],
      "asserted": []
    }
  }
}
doc_predicatesread-onlyLook up the lease predicates doc_verify_facts and doc_abstract_lease know (lease.expiration_date, …

Look up the lease predicates doc_verify_facts and doc_abstract_lease know (lease.expiration_date, lease.base_rent_schedule, lease.go_dark, ...) before extracting: for each, its value shape as JSON Schema, one valid example with a quote that states it (and whether that example verifies), which parts of the value are checked against the quote and how (number, ratio, date, verbatim name, as-written words, a worded enum, a number inside free text), which count as checked only when the quote writes them out (summaries, some enums), and which always need review (true/false values and enums no wording confirms, such as a CAM cap method or a kick-out party) unless a person confirms them. Generated from the same tables the checks use. Give predicate for one, prefix (e.g. lease.renewal) for a group, or neither for all. Also returns notes on statuses, paths, human confirmation and the generic rules for any other dotted predicate. Reads no document.

ParameterTypeDescription
predicatestringoptionalOne predicate to describe, e.g. lease.go_dark. Omit both predicate and prefix for every lease predicate.
prefixstringoptionalOnly predicates starting with this, e.g. "lease.renewal" or "lease.". Give predicate or prefix, not both.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "doc_predicates",
    "arguments": {}
  }
}
doc_spread_statementread-onlySpread a T-12, operating statement, budget or rent roll summary YOU read, onto FactLot's published chart of …

Spread a T-12, operating statement, budget or rent roll summary YOU read, onto FactLot's published chart of accounts (multifamily, commercial, or hotel after the USALI summary), deterministically; FactLot runs no model. Send the pages as text and one line per item: {label, amount, quote, page}, optionally your category, a period column, and for a subtotal the indexes of the lines it sums; give the statement's own totals (effective_gross_income, total_operating_expenses, net_operating_income, ebitda, ...) as lines with that total as category. Each line is checked: the quote is on the page (a quote under 12 characters, such as a short row, only where it stands as whole words), the amount (as a number, any common written form; (1,200) and -1,200 read as negative) and the label are written in it; a line that fails is excluded with the reason, and a stated total that does not foot names the lines left out. The label is mapped to the chart by keywords: your category is used when it is in the chart, and an exception flags it for review when the dictionary maps the label elsewhere; an ambiguous or unknown label without a category is excluded. Vacancy, concessions, credit loss and other contra lines are always subtracted. Returns per period the sections, the computed totals (EGI, operating expenses, NOI, capital items, net cash flow; for hotels departmental profit, GOP, EBITDA and NOI after the replacement reserve), whether each total and subtotal the statement states foots (within …

ParameterTypeDescription
documentobjectrequiredThe statement's pages.
property_typestringrequiredWhich chart of accounts to use: multifamily, commercial (office, retail, industrial), or hotel (USALI summary). One of: multifamily, commercial, hotel
statement_typestringoptionalWhat the document is; echoed back. One of: t12, operating_statement, budget, rent_roll_summary, other
periodstringoptionalDefault period label for lines that give none.
linesobject[]requiredThe statement's lines as you read them: every income, expense and capital line, the statement's own subtotals (with sums) and totals (with a total category), and statistics such as units or occupancy.
tolerancenumberoptionalLargest difference, in the statement's units, at which a subtotal or total still foots. Default: 0.5 for each line added (rounding).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "doc_spread_statement",
    "arguments": {
      "document": {},
      "property_type": "multifamily",
      "lines": []
    }
  }
}
doc_verify_claimread-onlyCheck one claim against a document page: {predicate, value} (anything doc_verify_facts accepts) or a short …

Check one claim against a document page: {predicate, value} (anything doc_verify_facts accepts) or a short claim sentence ({text} or a bare string), plus the verbatim quote and page it rests on. Returns supported (the quote is on the page and every checked number, date and name in the claim is written in it), contradicted (the quote is on the page and states other numbers or dates of the same kind, listed in quote_states), or unverifiable (the quote is not on the page, nothing in the claim can be checked, or the quote states no value of that kind), with the evidence (document_id, page, quote, span) and each part checked. Textual, not semantic: for a sentence only its numbers and dates are compared, never its meaning, and a quote that mentions the right number for a different term still supports it.

ParameterTypeDescription
documentobjectrequiredThe document the quote is from.
claimstring | objectrequired
quotestringrequiredVerbatim text from the page that the claim rests on.
pageintegerrequired1-based page the quote is on.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "doc_verify_claim",
    "arguments": {
      "document": {},
      "claim": "...",
      "quote": "...",
      "page": 0
    }
  }
}
doc_verify_factsread-onlyCheck values YOU extracted from a document against its text, deterministically; FactLot runs no model. Send …

Check values YOU extracted from a document against its text, deterministically; FactLot runs no model. Send the pages as text and one candidate per value: {predicate, value, quote, page}. Each candidate is checked in order: (1) the value's shape (Ingest predicates such as lease.expiration_date YYYY-MM-DD, lease.pro_rata_share in (0, 1], ordered lease.base_rent_schedule steps; any other dotted predicate needs a non-empty value); (2) the quote, at least 12 characters, is on the cited page, where only whitespace, line breaks, letter case and typographic quotes and dashes may differ (a word hyphenated across a line must keep its hyphen; a quote found on exactly one other page is accepted with the page corrected); (3) every number, date and party name in the value is written in the quote, in any common form: 1250000 matches "$1,250,000.00", 0.03 matches "3%" or "three percent", 2031-06-30 matches "June 30, 2031" or "6/30/2031"; text the lease states as written (a prohibited use, a carve-out, a protected use) is written in it as words, ignoring case, punctuation and line breaks; (4) a confidence you give below 0.8 holds it for review; (5) every other part of the value must be confirmed by the quote too: a true/false value, an enum or a summary not written in the quote holds the candidate for review, named in the reason. Verified means every part of the value was found in the quote. Returns verified (FactLot facts: method extracted, citing document_id, page, quote and character …

ParameterTypeDescription
documentobjectrequiredThe document the candidates were read from.
candidatesobject[]requiredValues you extracted, each with its quote and page.
as_ofstringrequiredDate the facts are stated as of (YYYY-MM-DD), usually today.
subjectstringoptionalFactLot URN the facts are about, e.g. your lease's fl:lease:… ID. Default: the document ID.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "doc_verify_facts",
    "arguments": {
      "document": {},
      "candidates": [],
      "as_of": "..."
    }
  }
}
estoppel_prepareread-onlyPrepare the standard statements of a tenant estoppel certificate from verified lease facts, for a lender or …

Prepare the standard statements of a tenant estoppel certificate from verified lease facts, for a lender or buyer who wants the tenant to confirm the lease. Give the lease's facts (doc_abstract_lease or doc_verify_facts, each with its quote and page and passing fact_validate: parties, commencement and expiration, rentable area, base rent schedule, security deposit, free rent, TI allowance, renewal, expansion, termination and purchase options and their notice deadlines), the lease and amendment documents, the premises and as_of, and optionally what the landlord's own records say (rent paid through, deposit held). Returns numbered statements: the lease and amendment list with document fingerprints, commencement, expiration, premises, current base rent and the next step (annual and monthly, worked and shown), security deposit, free rent, TI allowance, each option, each carrying the source quote and page, with a superseded sentence shown as superseded when an amendment changed it; and statements only the tenant can know (no other agreements, deposit paid, rent paid through, no rent paid more than one month ahead, landlord obligations outstanding, no other options, no landlord default, no tenant default, no assignment or sublease), marked tenant to confirm with no lease source. Flags every gap (a term the facts do not supply) and every conflict between the lease and an amendment, and withholds that statement rather than guess. Also returns key figures, totals, package_facts and …

ParameterTypeDescription
lease_factsobject[]requiredThe lease's verified facts, for the lease and every amendment (doc_abstract_lease's facts, or doc_verify_facts' verified[].fact), each with its quote and page and passing fact_validate. Read by predicate: lease.landlord, lease.tenant, lease.commencement_date, …
partiesobjectrequiredThe parties.
premisesobjectrequiredThe leased premises.
as_ofstringrequiredThe date of the certificate, YYYY-MM-DD. The tool reads no clock: the current rent step and the next one are found from this date.
documentsobject[]optionalOptional: which cited document is the lease and which are amendments. Without it, a document whose facts carry valid_from is an amendment and the one remaining is the lease; anything unclear is flagged, never guessed.
landlord_recordsobjectoptionalOptional figures from the landlord's own records. They have no lease source and are marked as the landlord's.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "estoppel_prepare",
    "arguments": {
      "lease_facts": [],
      "parties": {},
      "premises": {},
      "as_of": "..."
    }
  }
}
fact_package_createread-onlyBundle FactLot facts (each must pass fact_validate) into a fact package a counterparty can verify: canonical …

Bundle FactLot facts (each must pass fact_validate) into a fact package a counterparty can verify: canonical JSON (RFC 8785) of every fact, an RFC 6962 Merkle tree over the facts, the source documents the facts cite with their sha256 where known, and a digest over all of it. Returns the unsigned package, its digest, and signing_message, the exact text to sign. FactLot never holds private keys: to sign, the holder signs signing_message with their own Ed25519 key on their own machine (factlot.sign_fact_package in Python, signFactPackage in @factlot/tools, or fact_package_sign in the local MCP server). Deterministic: no clock time is added (pass created_at), and the same facts always give the same digest.

ParameterTypeDescription
factsobject[]requiredThe facts to package, in order: verified facts from the doc_* tools or any facts that pass fact_validate.
titlestringoptionalA title for the package.
created_atstringoptionalWhen the package was made (ISO 8601 with offset). FactLot adds no clock time, so the same input always gives the same package.
created_bystringoptionalThe organization making the package.
documentsobject[]optionalSource documents to describe beyond what the facts cite (a title, the file's sha256). Every document a fact cites is listed automatically.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "fact_package_create",
    "arguments": {
      "facts": []
    }
  }
}
fact_package_sendcan modifyexternal accessSend a fact package to another firm for confirmation through the FactLot record, and get back a link for …

Send a fact package to another firm for confirmation through the FactLot record, and get back a link for them. For an expense (CAM) reconciliation: the tenant's facts (lease terms and the landlord's statement figures, each with its quote and page, from doc_verify_facts or doc_abstract_lease) go in a package from fact_package_create, the arithmetic is calc_cam_reconciliation's output as calculation, and each line is an item: accept_theirs where the sender accepts the counterparty's figure, state_ours where the lease gives a different figure and the counterparty is asked to agree or dispute it. The counterparty opens the link on a plain web page (no account needed), sees every item with both figures, the quote, page and document fingerprint, and agrees or disputes each. Every accepted or agreed item is recorded as a reliance, citing the package digest. The FactLot record keeps each fact, its quote, the page and each document's SHA-256, never the documents. A send goes to an outside party and cannot be recalled. Refuses without approved_by, the full name of the person who reviewed every item, and approval_confirmed: true. Refuses a package that fails fact_package_verify's integrity checks, and an item whose fact_ids are not in the package. Real or test: a package is sent for real only through the hosted FactLot API with the subscription's own FactLot key (paid, or an email-confirmed free key) or a connection signed in with one; a real send records reliances between the named …

ParameterTypeDescription
packageobjectrequiredThe package from fact_package_create (signed or not).
kindstringrequiredWhat is being confirmed. estoppel: the statements from estoppel_prepare, answered by the tenant and then open to a lender or buyer through relying_parties. rent_roll: a certified rent roll from rent_roll_certify, asserted by the sender (no answer step) and … One of: expense_reconciliation, fact_confirmation, estoppel, rent_roll
titlestringrequiredA title the counterparty sees.
subjectobjectrequiredThe property or lease the facts are about.
fromobjectrequiredThe sender: organisation, person, email.
toobjectrequiredThe counterparty.
itemsobject[]requiredThe line items. The counterparty answers each state_ours item.
calculationobjectoptionalA calc tool's output (for example calc_cam_reconciliation) shown to the counterparty with every step.
relying_partiesstring[]optionalEstoppel and rent_roll only: a label for each lender or buyer that is to get its own view link and token (for example the lender's name). Each can read the package and record its own reliance; none can answer for the tenant. For an estoppel with none given …
estoppel_linksstring[]optionalRent roll only: the sender's status link (status_link_for_sender) of each estoppel that backs a matches_lease_confirmed_by_tenant line. The FactLot record opens each with its private token to check the tenant agreed the statements; the token is not stored.
attestationobjectoptionalThe attestation that the hosted FactLot service returned with package_items from audit_expense_statement, estoppel_prepare or rent_roll_certify, passed unchanged. The FactLot record checks the service's signature and that the items, grades, figures and facts …
approved_bystringrequiredThe full name of the person at the sender who reviewed every item and approved sending this package. Recorded with the package and shown to the counterparty.
approval_confirmedbooleanrequiredConfirms that the person named in approved_by reviewed every item, both figures, the quote and page behind each, the calculation and the recipient, and approved sending. The tool refuses unless it is true.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "fact_package_send",
    "arguments": {
      "package": {},
      "kind": "expense_reconciliation",
      "title": "...",
      "subject": {},
      "from": {},
      "to": {},
      "items": [],
      "approved_by": "...",
      "approval_confirmed": false
    }
  }
}
fact_package_statusread-onlyexternal accessRead the status of a package sent with fact_package_send: for each item, whether the counterparty agreed or …

Read the status of a package sent with fact_package_send: for each item, whether the counterparty agreed or disputed it (with their reason and who answered), which items the sender accepted, the reliances recorded, and the package's integrity. For an estoppel it also gives the statement number and text, the tenant's own version where it gave one, the signer's name and title with the electronic signature record (time in UTC, consent wording version and text, SHA-256 of the signed statements, and whether they are unchanged), reliers (each lender or buyer that recorded reliance, its role, the statements and when), and for each relying-party link the first and last time it was opened and how many times, with the name, firm and role given once reliance is recorded and the statements confirmed and disputed at that moment. Give the sender's private status_link (or package_id with token). Needs no account and costs nothing; it reads only your own package, and the counterparty's link cannot read it. The answer also gives attestation (attested or unattested, with the line the pages show: computed by FactLot and unchanged since, or not verified) and package_signature (the outcome of checking the signature fact_package_create's holder made, when there is one). The answer says whether the package was sent in test mode (test_mode true: it does not count in the FactLot record's measure) or for real.

ParameterTypeDescription
status_linkstringoptionalThe sender's private status link from fact_package_send.
package_idstringoptional
tokenstringoptionalThe sender's private token (with package_id), if there is no link.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "fact_package_status",
    "arguments": {}
  }
}
fact_package_verifyread-onlyVerify a fact package from fact_package_create: recompute every fact's hash, the Merkle root and the digest …

Verify a fact package from fact_package_create: recompute every fact's hash, the Merkle root and the digest from the content (any changed fact, title, date or document list shows as a mismatch); check each fact against fact_validate; check the Ed25519 signature, against the public_key you pass (base64url, the signer's key you trust) or, without one, only against the key inside the package (which proves nothing about who signed); and, given the source documents' pages, check every quote is on its cited page. Returns valid plus each check's details, checks_run and checks_not_run (what was and was not checked), and values_not_checked: the parts of extracted facts' values that their quotes do not confirm (a true/false value, an enum, a summary), which do not change valid. Not checked: that the pages you pass are the original files (pass sha256 to tie them to the file hash), or what the facts mean.

ParameterTypeDescription
packageobjectrequiredA fact package from fact_package_create, signed or not.
public_keystringoptionalThe signer's Ed25519 public key you trust: 32 bytes as base64url (a JWK's x). With it the signature must verify for the package to be valid.
documentsobject[]optionalOptional: the source documents' pages (with sha256 when the facts cite the file's hash). Each fact's quote is then checked on its cited page.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "fact_package_verify",
    "arguments": {
      "package": {}
    }
  }
}
fact_validateread-onlyCheck one FactLot fact against the published fact schema (spec/schemas/fact.json): subject URN, dotted …

Check one FactLot fact against the published fact schema (spec/schemas/fact.json): subject URN, dotted predicate, as_of date, provenance, optional rights; unknown fields are rejected at every level. Rules: every fact except a computed one cites at least one source (an inferred fact cites the evidence it was inferred from); a computed fact names its formula or cites a source; valid_from is not after valid_to; a source span does not end before it starts. For Ingest predicates (lease.expiration_date, lease.rentable_area_sf, lease.base_rent_schedule, ...) the value must have the predicate's shape and every source quote must state the value, by the same written-form rules as doc_verify_facts (a quote saying "2,500 square feet" does not support 1000). Not checked: that the quote is in the document, that the document or sha256 exists, that supersedes IDs exist, and quotes for other predicates; doc_verify_facts with the document's pages checks the quote. Returns { valid, issues }. Meant for checking facts before they are stored or shared.

ParameterTypeDescription
factobjectrequiredA FactLot fact: subject, predicate, value, as_of, provenance (with sources), optional rights.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "fact_validate",
    "arguments": {
      "fact": {}
    }
  }
}
fetchread-onlyFetch the full text of a FactLot knowledge document by the id returned from search. With a registry loaded, a …

Fetch the full text of a FactLot knowledge document by the id returned from search. With a registry loaded, a registry fact's source document_id (fl:document:sha256-…) returns that source snapshot: publisher, dataset, URL, retrieval date, as-of date, licence, AI-use and redistribution rights, file name and size.

ParameterTypeDescription
idstringrequiredDocument id from search, e.g. tool:calc_cam_reconciliation, or a registry source snapshot's FactLot document ID (fl:document:sha256-…) when a registry is loaded.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "fetch",
    "arguments": {
      "id": "..."
    }
  }
}
id_buildingread-onlyDeterministic FactLot ID for a building from its street address: county FIPS, ZIP code, and street line. …

Deterministic FactLot ID for a building from its street address: county FIPS, ZIP code, and street line. Every condominium unit, suite, and floor at the address gets the same building ID, offline. id_space takes it for a suite, and registry_get shows the building's parcels.

ParameterTypeDescription
state_fipsstringrequired2-digit state FIPS code, e.g. "11" for the District of Columbia.
county_fipsstringrequired3-digit county FIPS code, e.g. "001".
zipstringrequired5-digit ZIP code of the address, e.g. "20002" (ZIP+4 accepted).
streetstringrequiredStreet line: house number and street, e.g. "208 Massachusetts Ave NE". A suite, unit or floor is ignored, and so is anything after a comma (city, state).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "id_building",
    "arguments": {
      "state_fips": "...",
      "county_fips": "...",
      "zip": "...",
      "street": "..."
    }
  }
}
id_documentread-onlyContent-addressed FactLot ID (SHA-256) for a document such as a lease, amendment, or estoppel.

Content-addressed FactLot ID (SHA-256) for a document such as a lease, amendment, or estoppel.

ParameterTypeDescription
content_base64stringoptionalBase64 of the exact file bytes (preferred: every party gets the same ID).
textstringoptionalDocument text, UTF-8 encoded before hashing. Use only when bytes are unavailable.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "id_document",
    "arguments": {}
  }
}
id_entityread-onlyDeterministic FactLot ID for a legal entity (LLC, LP, corporation, trust) from its registry jurisdiction and …

Deterministic FactLot ID for a legal entity (LLC, LP, corporation, trust) from its registry jurisdiction and file number, or from its LEI (an LEI whose ISO 17442 check digits do not match is rejected).

ParameterTypeDescription
jurisdictionstringrequiredRegistry jurisdiction, e.g. "us-de" for Delaware, or "lei" for a Legal Entity Identifier.
registry_numberstringrequiredFile number issued by that registry, or the 20-character LEI (its ISO 17442 check digits are verified).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "id_entity",
    "arguments": {
      "jurisdiction": "...",
      "registry_number": "..."
    }
  }
}
id_parcelread-onlyDeterministic FactLot ID for a parcel from state FIPS, county FIPS, and the assessor's parcel number (APN). …

Deterministic FactLot ID for a parcel from state FIPS, county FIPS, and the assessor's parcel number (APN). The same parcel always yields the same ID, offline. It serves as the join key across systems. APNs that differ only in where a separator falls ("12-34", "1-234") get different IDs; in a county with a documented fixed-width format the variants of one APN converge (NYC BBL "3-1234-56" = "3012340056").

ParameterTypeDescription
state_fipsstringrequired2-digit state FIPS code, e.g. "06" for California.
county_fipsstringrequired3-digit county FIPS code, e.g. "037" for Los Angeles County.
apnstringrequiredAssessor's parcel number exactly as the county prints it. Letter case and the separator characters are normalized; where a separator falls is kept, except in counties with a documented fixed-width format (NYC BBL, Los Angeles AIN, Cook County PIN, DC SSL).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "id_parcel",
    "arguments": {
      "state_fips": "...",
      "county_fips": "...",
      "apn": "..."
    }
  }
}
id_parseread-onlyValidate a FactLot URN and return its kind, components, and short ID.

Validate a FactLot URN and return its kind, components, and short ID.

ParameterTypeDescription
urnstringrequiredA FactLot URN to validate, e.g. fl:parcel:us-06037:5432001012.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "id_parse",
    "arguments": {
      "urn": "..."
    }
  }
}
id_spaceread-onlyFactLot ID for a suite or unit within a building, given the building's FactLot URN (from id_building). Suite …

FactLot ID for a suite or unit within a building, given the building's FactLot URN (from id_building). Suite designators are normalized: "Suite 100", "Ste 100" and "#100" agree, while "1-20" and "120" stay distinct.

ParameterTypeDescription
building_urnstringrequiredFactLot building URN from id_building, e.g. fl:building:us-11001:20002:208-massachusetts-ave-ne (a minted fl:building:<26-character token> also works).
suitestringrequiredSuite or unit as written ("Suite 400", "STE 400", "#400", "3rd Floor" all normalize).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "id_space",
    "arguments": {
      "building_urn": "...",
      "suite": "..."
    }
  }
}
lease_comp_searchread-onlySearch the 6,994 lease comps from the U.S. General Services Administration's Lease Inventory (October 2026 …

Search the 6,994 lease comps from the U.S. General Services Administration's Lease Inventory (October 2026 file, FactLot release lease-comps-gsa-2026-11-04), bundled with FactLot: works offline and on the hosted API, no registry needed. Caveat: the tenant in every one of these leases is the federal government (GSA, for an agency); they are not market comps for private tenants, and the rent is the current annual rent in GSA's file divided by the rentable SF, not the starting rent (no escalations, free rent, TI or commissions are known). Filter by state, 5-digit county FIPS, city, ZIP, a radius around a latitude/longitude (GSA's own coordinates; nothing is geocoded), rentable SF, commencement date, rent per SF, property type (office, industrial, other) and expense basis; sort; limit (default 25, at most 200). Each comp gives its FactLot lease ID, GSA lease number, address, county FIPS, building ID, landlord (organisations only; individuals are never stored), rentable SF, commencement, expiration, term, early-termination date, annual rent, rent per SF per year, property type, expense basis and the row of the GSA file it comes from. summary gives the count and the median, quartiles and range of rent per SF over every match, labelled as statistics of GSA leases. Every answer carries the caveat and the citation (GSA file URL, SHA-256 document ID, as-of and retrieval dates, licence: public domain). These are statistics of GSA leases, kept apart from market comps.

ParameterTypeDescription
statestringoptionalTwo-letter state or territory code, e.g. "TX".
county_fipsstringoptional5-digit county FIPS code (state + county), e.g. "48201" for Harris County, Texas. Connecticut uses its planning regions (09110 to 09190).
citystringoptionalCity as GSA writes it, matched whole and ignoring case, e.g. "Houston".
zipstringoptional5-digit ZIP code (ZIP+4 accepted), e.g. "77002".
nearobjectoptionalComps within a radius of a point, by great-circle distance to the coordinates GSA's file gives for each lease (FactLot geocodes nothing; give the point's coordinates yourself). Comps without coordinates are left out and counted in warnings.
min_rentable_sfnumberoptionalSmallest lease rentable area, SF.
max_rentable_sfnumberoptionalLargest lease rentable area, SF.
commencement_fromstringoptionalEarliest lease commencement (effective) date, YYYY-MM-DD.
commencement_tostringoptionalLatest lease commencement (effective) date, YYYY-MM-DD.
min_rent_psf_yrnumberoptionalLowest current rent, USD per rentable SF per year (GSA's current annual rent divided by the RSF).
max_rent_psf_yrnumberoptionalHighest current rent, USD per rentable SF per year.
property_typestringoptionaloffice, industrial (GSA warehouse) or other (GSA special space): the largest use in the lease. One of: office, industrial, other
expense_basisstringoptionalfull_service (GSA fully serviced) or not_full_service. One of: full_service, not_full_service
sortstringoptionalOrder of results: distance_asc (the default with near; needs near), commencement_desc (the default otherwise), commencement_asc, expiration_asc, expiration_desc, rent_psf_desc, rent_psf_asc, rentable_sf_desc, rentable_sf_asc. Ties go by GSA lease number. One of: commencement_desc, commencement_asc, expiration_asc, expiration_desc, rent_psf_desc, rent_psf_asc, rentable_sf_desc, rentable_sf_asc …
limitintegeroptionalMaximum comps returned (1–200, default 25); the summary covers every match.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "lease_comp_search",
    "arguments": {}
  }
}
lease_comp_validateread-onlyCheck a lease comparable one firm shares with others, as a FactLot fact with predicate lease.comp, and derive …

Check a lease comparable one firm shares with others, as a FactLot fact with predicate lease.comp, and derive its net effective rent. The fact goes through fact_validate (schema, citations, rights), then the comp's own rules: shape (spec/schemas/fact.json LeaseComp: area, commencement, term or expiration, starting or current rent, escalation, free rent, TI, leasing commissions, expense basis, confirming party, verification), an expiration after commencement, a term that matches the dates, free rent within the term, no email, phone or ID number in the text. A comp names no person or company. With the default share profile it also needs the deal's starting rent, escalations, free rent, TI, property type, an expense basis other than unknown, and stated rights. When valid and a starting rent is given, ner.fact is a computed lease.net_effective_rent fact (formula calc.net_effective_rent@1, straight-line and discounted at discount_rate_annual, on the comp's own expense basis; no conversion between full service and net). Returns { valid, issues, warnings, ner }. Meant for checking a comp before it is shared.

ParameterTypeDescription
factobjectrequiredA FactLot fact with predicate lease.comp: subject (an fl:lease: URN), value (the comp), as_of, provenance (with at least one source: your own record is fine, cited by document_id or sha256 without sharing it), and rights (ai_use and redistribution).
profilestringoptionalshare (default): a comp offered to other firms: needs the deal's starting rent, escalations, free rent, TI, expense basis, property type, a term and stated rights. observed: a rent seen in a public record (current_rent_psf_yr is enough); no NER is derived … One of: share, observed
discount_rate_annualnumberoptionalAnnual discount rate for the discounted NER (an assumption, not part of the comp). 0 gives the straight-line NER only. Must be less than 1.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "lease_comp_validate",
    "arguments": {
      "fact": {}
    }
  }
}
registry_coverageread-onlyThe counties (with parcel and building counts), entity registries, and crosswalk systems this FactLot …

The counties (with parcel and building counts), entity registries, and crosswalk systems this FactLot Registry file holds, each with its sources and as-of dates. A miss outside these regions means not loaded, not absent. Requires a FactLot Registry (public-record facts about commercial property, each cited to the source file and record).

ParameterTypeDescription
fieldsbooleanoptionaltrue: each county also carries fields, the share of its parcels with each fact group it holds and its roll years with their value types.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "registry_coverage",
    "arguments": {}
  }
}
registry_getread-onlyEverything the FactLot Registry knows about a parcel, legal entity, or building: status, current cited facts …

Everything the FactLot Registry knows about a parcel, legal entity, or building: status, current cited facts (owner of record, situs address, property category, areas, values), ownership links, external IDs, and for a parcel the building it belongs to (condominium units roll up into one building). value_history (parcels) lists market and appraised value by tax year from every snapshot, newest first, each value cited; a tax year two snapshots value differently appears once per value. as_of gives the facts as they stood on a date. A parcel's recorded sales and documents (transaction.sale, transaction.deed, debt.mortgage_recorded, debt.mortgage_satisfaction_recorded; one fact each, newest first) are kept to the newest 50 in facts and in history; when there are more, recorded_facts_truncated gives what was kept and the totals by predicate with the years left out, and registry_recorded_facts reads them all. warnings flags area facts that look wrong (building area above 40 times the land area, a land area of 0); the facts themselves are as the source publishes them. A building record can carry debt.cmbs_loan facts (one per CMBS trust holding a note of its loan: balance, rate, maturity, payment status, servicer, special-servicing dates, NOI, DSCR) and an entity record can carry entity.parent facts (the SEC registrant that lists it as a subsidiary in Exhibit 21), each cited to its SEC filing. A miss says whether the county or entity registry is loaded. On the hosted API, a call …

ParameterTypeDescription
urnstringrequiredFactLot URN of a parcel, entity, or building, e.g. fl:parcel:us-48201:0011440000001 (Harris County, Texas) or fl:parcel:us-36061:1000020002 (Manhattan: a New York City borough-block-lot).
include_historybooleanoptionalAlso return every fact from every snapshot, superseded ones included (history lists current facts too; a source loaded once has no superseded facts).
as_ofstringoptionalDate (YYYY-MM-DD): return the facts and ownership links current on that date, from the snapshots dated on or before it, instead of the latest. With include_history, history stops at that date. On the hosted API a dated lookup needs a Pro or Team key.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "registry_get",
    "arguments": {
      "urn": "..."
    }
  }
}
registry_lookup_batchread-onlyUp to 50 parcels in any loaded state in one call (a loan tape, a broker's list, a client's accounts), each …

Up to 50 parcels in any loaded state in one call (a loan tape, a broker's list, a client's accounts), each item naming one parcel by exactly one of: urn (a FactLot parcel URN); apn with state_fips and county_fips (3 digits), or with a 5-digit county_fips alone (as registry_resolve_parcel takes them); or address with the optional place fields registry_search_address takes (state, city, postal_code, county_fips). ref, your own row id, is echoed back. Each item is answered as the single tools answer it: registry_get for a URN, registry_resolve_parcel for an account, registry_search_address (20 results) for an address, then registry_get on the URN found. results lists one entry per item in input order (index, ref, by: urn, account or address, status): found gives parcel, a compact row: urn, label, record_status, account, property_category, use_code, improvement_area_sf, year_built, value (the newest roll year's entry of registry_get's value_history: tax_year, market and appraised value, as_of, value types, file and each value's citation), owner_of_record (the owner of record fact exactly as registry_get gives it, with the entity linked to it, or null; organisations only, natural persons are never stored), citations (each field's fact id, document id, locator and as-of date), sources (each cited document with its title, URI, read date, licence, ai_use and redistribution) and warnings; an address item also gives match (exact, and how many parcels the search returned). not_found …

ParameterTypeDescription
itemsobject[]requiredThe parcels (1–50), each by exactly one of urn, apn (with its county) or address.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "registry_lookup_batch",
    "arguments": {
      "items": []
    }
  }
}
registry_owned_byread-onlyCommercial parcels currently linked to a legal entity as owner of record (inferred links carry a confidence), …

Commercial parcels currently linked to a legal entity as owner of record (inferred links carry a confidence), each with the building it belongs to, plus a per-building summary so condominium units count once per building. On the hosted API, a call without a Pro or Team key gets the first three parcels, with every row of each and their buildings (the answer says how many were left out in portfolio_withheld and portfolio_note); a Pro or Team key gets every parcel. Requires a FactLot Registry (public-record facts about commercial property, each cited to the source file and record).

ParameterTypeDescription
entity_urnstringrequiredFactLot entity URN, e.g. fl:entity:us-tx:0801111111.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "registry_owned_by",
    "arguments": {
      "entity_urn": "..."
    }
  }
}
registry_recorded_factsread-onlyEvery recorded sale and document of a parcel (transaction.sale, transaction.deed, debt.mortgage_recorded, …

Every recorded sale and document of a parcel (transaction.sale, transaction.deed, debt.mortgage_recorded, debt.mortgage_satisfaction_recorded), newest first in registry_get's order, each a whole fact with its citation, a page at a time. registry_get keeps the newest 50 of them (on the hosted API without a Pro or Team key, the newest sale or deed only); when it holds more, its recorded_facts_truncated gives the totals, and this tool reads the rest. predicate limits the page to one of the four. Pass next_cursor back as cursor for the next page; next_cursor is null on the last. totals counts each predicate's facts. A price or amount is as recorded, zero or nominal included; the sources do not say whether a sale was at arm's length. Parties are organisations only. On the hosted API this tool needs a Pro or Team key. Requires a FactLot Registry (public-record facts about commercial property, each cited to the source file and record).

ParameterTypeDescription
urnstringrequiredFactLot parcel URN, e.g. fl:parcel:us-36061:1012920015.
predicatestringoptionalOnly this predicate's facts. One of: transaction.sale, transaction.deed, debt.mortgage_recorded, debt.mortgage_satisfaction_recorded
cursorstringoptionalnext_cursor from the previous page; omit for the first page.
limitintegeroptionalFacts per page (1 to 100).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "registry_recorded_facts",
    "arguments": {
      "urn": "..."
    }
  }
}
registry_resolve_externalread-onlyFind the FactLot URN for an ID from another system, e.g. system "sdat_account" (a Maryland SDAT account …

Find the FactLot URN for an ID from another system, e.g. system "sdat_account" (a Maryland SDAT account number), "hcad_account" (a Harris CAD account number), "nyc_bbl" (a New York City borough-block-lot), "la_ain" (a Los Angeles County Assessor ID number), "sf_parcel", "boston_pid", "denver_schednum" or "ct_cama_link". registry_coverage lists the systems a registry holds. Requires a FactLot Registry (public-record facts about commercial property, each cited to the source file and record).

ParameterTypeDescription
systemstringrequiredCrosswalk system name, e.g. "sdat_account" (Maryland), "hcad_account" (Harris County, Texas) or "nyc_bbl" (New York City).
external_idstringrequiredThe ID in that system.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "registry_resolve_external",
    "arguments": {
      "system": "...",
      "external_id": "..."
    }
  }
}
registry_resolve_parcelread-onlyFind a parcel's FactLot URN from state FIPS, county FIPS, and APN, if the registry holds it. A miss returns …

Find a parcel's FactLot URN from state FIPS, county FIPS, and APN, if the registry holds it. A miss returns urn null with coverage: whether that county is loaded in this registry. Requires a FactLot Registry (public-record facts about commercial property, each cited to the source file and record).

ParameterTypeDescription
state_fipsstringrequired2-digit state FIPS, e.g. "48" for Texas, "36" for New York.
county_fipsstringrequired3-digit county FIPS, e.g. "201" for Harris County, Texas, or "061" for New York County (Manhattan).
apnstringrequiredParcel or account number as the county prints it: an appraisal district account number in Texas, a borough-block-lot (e.g. 1000020002) in New York City, an AIN in Los Angeles County, a parcel number in San Francisco, a PID in Boston, a schedule number in …

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "registry_resolve_parcel",
    "arguments": {
      "state_fips": "...",
      "county_fips": "...",
      "apn": "..."
    }
  }
}
registry_search_addressread-onlyFind commercial parcels by situs address. Matches whole words of the street line (the part before the first …

Find commercial parcels by situs address. Matches whole words of the street line (the part before the first comma), normalized: 'Street' = 'St', 'Northwest' = 'N.W.' = 'NW'; a suite, unit, '#' or floor is ignored. A numbered street matches however it is written ('Fifth Avenue' = '5th Ave' = '5 Avenue', 'Forty-Second St' = '42nd St'), and a house number matches a lot whose address is a range holding it ('350 5th Ave' finds '338-350 5 AVENUE'): a range whose ends are both odd or both even holds only the numbers of that parity, one side of the street, and one whose ends differ holds every number between. Give a house number ('1200 Main', '1200 Main St NW') or a street name with its type ('Main St'); a city or a part of a word alone matches nothing. Give the place after the first comma ('1200 Main St, Houston, TX 77002') or as state, city, postal_code and county_fips: a state named after a city (or given as state) keeps the answer to that state, and county_fips to that county, before the limit is applied; the ZIP code and the city only order the matches (same ZIP code first, then same city, then the rest) and never filter; a bare state with no city in the query, and suite, floor or box text, are ignored. Within each place group, matches of the street as written come first, then other spellings, then house-number ranges, an exact address first, then the parcel whose label names the unit the query names (a unit never filters), then by label; parcels sharing one label come largest …

ParameterTypeDescription
querystringoptionalStreet address ('1200 Main St, Houston, TX 77002'), or a house number and street words, or a street name with its type; the city, state and ZIP code after the first comma narrow and order the matches. Give query or address, not both.
addressstringoptionalThe same as query (give one of the two).
statestringoptionalState, two letters or full name ('TX', 'Texas'): keeps the answer to that state, as a state after the city in the query does; it replaces one named there.
citystringoptionalCity ('Houston'): matches in it come first; it never filters. Replaces a city named in the query.
postal_codestringoptional5-digit ZIP code (or ZIP+4): matches with it come first; it never filters, since some rolls write ZIP codes wrongly. Replaces one named in the query.
county_fipsstringoptionalCounty FIPS code, 5 digits ('48201') or 3 with state ('201'): keeps the answer to that county, read from each parcel's URN.
limitintegeroptionalMaximum results (1–100).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "registry_search_address",
    "arguments": {}
  }
}
registry_search_entitiesread-onlyFind registered business entities (LLCs, LPs, corporations) by name. Natural persons are not searchable. …

Find registered business entities (LLCs, LPs, corporations) by name. Natural persons are not searchable. Requires a FactLot Registry (public-record facts about commercial property, each cited to the source file and record).

ParameterTypeDescription
querystringrequiredEntity name or part of one.
limitintegeroptionalMaximum results (1–100).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "registry_search_entities",
    "arguments": {
      "query": "..."
    }
  }
}
registry_tx_equity_candidatesread-onlyCandidate comparable parcels for a Texas unequal-appraisal comparison (Tax Code §41.43(b)(3)), from one tax …

Candidate comparable parcels for a Texas unequal-appraisal comparison (Tax Code §41.43(b)(3)), from one tax year of the subject's appraisal district roll (the newest year whose roll gives the subject a value, or tax_year), with every field of the subject and the candidates read from that year's roll only: same county and tax year, the same state property category code, improvement area within area_band of the subject's, year built within year_band years when both are known; parcels sharing the subject's neighborhood code first (when the roll gives one), then its ZIP code, then the rest of the county if fewer than min_matches. Optional narrowing, off by default: same_building_class, same_local_use_code, local_use_codes. Each candidate and the subject carry their roll fields: id, apn (the district's account number), value and value_basis, value_per_sf (that value divided by the improvement area, to the cent: the roll's figures and one division, not an opinion of value), market and appraised value, improvement and land area, year built, state property category, local use code, neighborhood code, building class, situs address, tax year, and the citation of the value fact; the subject adds its value history by tax year. Separate land and improvement values are not returned. calc_args gives the same subject and candidates with exactly calc_tx_unequal_appraisal's input fields (tax_year, subject, comparables; id = the FactLot URN, label = the situs address, nulls left out, no …

ParameterTypeDescription
urnstringoptionalFactLot parcel URN of the subject, e.g. fl:parcel:us-48201:0011440000001. Give this, or county_fips and apn.
state_fipsstringoptionalWith county_fips and apn: "48" (Texas), the only state served.
county_fipsstringoptional3-digit Texas county FIPS, e.g. "201" for Harris County.
apnstringoptionalAppraisal district account number as the district prints it.
area_bandnumberoptionalImprovement area band as a share of the subject's (0.35: within ±35%). Must be greater than 0.
year_bandintegeroptionalYear-built band in years, applied when both the subject's and the candidate's are known.
min_matchesintegeroptionalWiden from the neighborhood and ZIP code tiers to the whole county when they hold fewer than this.
limitintegeroptionalMaximum candidates returned (1–200; a larger value is refused). Fewer are returned when fewer meet the rule, or when the neighborhood and ZIP code tiers hold at least min_matches, because the rest of the county is then not included; a warning gives the counts.
tax_yearintegeroptionalRoll year to compare in: the subject and every candidate are read from that year's roll files only (building class also from that year's buildings file, named in selection.building_class_sources); selection.compared_files lists the files the compared values …
same_building_classbooleanoptionalOnly parcels whose building class (from the compared roll year) is exactly the subject's. Not applied, with a warning, when the subject has none. Default false: building class is not compared.
same_local_use_codebooleanoptionalOnly parcels whose local use code (the district's own use or class code) is exactly the subject's. Not applied, with a warning, when the subject has none or local_use_codes is given. Default false.
local_use_codesstring[]optionalOnly parcels whose local use code is one of these, compared exactly as the roll prints them (1–50 codes). Default: no use-code test.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "registry_tx_equity_candidates",
    "arguments": {}
  }
}
registry_tx_equity_candidates_batchread-onlyregistry_tx_equity_candidates for many subjects in one call (1–50, e.g. a consultant's client parcels): each …

registry_tx_equity_candidates for many subjects in one call (1–50, e.g. a consultant's client parcels): each subject's id (your label, echoed back) and its urn, or county_fips and apn, plus the rule parameters once for every subject (area_band, year_band, min_matches, limit, tax_year, same_building_class, same_local_use_code, local_use_codes). Each entry of results is that subject's answer from registry_tx_equity_candidates (subject, candidates, calc_args, selection, selection_rule, sources, warnings) or that subject's error (error, message, issues, and coverage on a miss), so one subject outside Texas, in Tarrant County, or not in the registry does not fail the others; the Texas-only and Tarrant checks apply to each subject. The selection rule and the notice appear once at the top (rule, notice) instead of in every answer; summary counts subjects, answered and errors. Candidates per subject only: this tool never runs calc_tx_unequal_appraisal and never picks comparables; a person decides, for each subject, which candidates (if any) to use, and only those go to calc_tx_unequal_appraisal (each subject's calc_args is its candidate list in that tool's input shape, for review and editing first). Each candidate's source rights are in that subject's sources. For evidence calculations only: FactLot does not represent property owners, file protests, or advise whether to protest. Not an appraisal or an opinion of value (Tex. Occ. Code §1103.003(1)); not legal or tax advice and not a …

ParameterTypeDescription
subjectsobject[]requiredThe subject parcels (1–50): each one's id and its urn, or county_fips and apn (with state_fips 48, or none).
area_bandnumberoptionalImprovement area band as a share of the subject's (0.35: within ±35%). Must be greater than 0.
year_bandintegeroptionalYear-built band in years, applied when both the subject's and the candidate's are known.
min_matchesintegeroptionalWiden from the neighborhood and ZIP code tiers to the whole county when they hold fewer than this.
limitintegeroptionalMaximum candidates returned (1–200; a larger value is refused). Fewer are returned when fewer meet the rule, or when the neighborhood and ZIP code tiers hold at least min_matches, because the rest of the county is then not included; a warning gives the counts.
tax_yearintegeroptionalRoll year to compare in: the subject and every candidate are read from that year's roll files only (building class also from that year's buildings file, named in selection.building_class_sources); selection.compared_files lists the files the compared values …
same_building_classbooleanoptionalOnly parcels whose building class (from the compared roll year) is exactly the subject's. Not applied, with a warning, when the subject has none. Default false: building class is not compared.
same_local_use_codebooleanoptionalOnly parcels whose local use code (the district's own use or class code) is exactly the subject's. Not applied, with a warning, when the subject has none or local_use_codes is given. Default false.
local_use_codesstring[]optionalOnly parcels whose local use code is one of these, compared exactly as the roll prints them (1–50 codes). Default: no use-code test.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "registry_tx_equity_candidates_batch",
    "arguments": {
      "subjects": []
    }
  }
}
rent_roll_certifyread-onlyCertify a commercial rent roll for a lender or buyer: check each line of the roll, given as verified facts …

Certify a commercial rent roll for a lender or buyer: check each line of the roll, given as verified facts (each value with its verbatim quote and page from the rent roll document), against the leases' verified facts (and, where there is one, the answers of a confirmed estoppel), and grade it. Compares per line the tenant name, suite, rentable area, lease start and expiration, current base rent (per year, per month and per SF, the lease's worked from its rent schedule and area), next rent step, security deposit, free rent outstanding, renewal options and recoveries structure, wherever both the roll and a lease fact state it. Each line is graded: matches lease; matches lease and confirmed by tenant (the tenant agreed the premises, expiration and base rent statements of an estoppel); differs (both figures, the dollar difference and the quotes); no lease supplied; or not checkable, with the reason. A field no lease fact covers is not checked, never assumed. Totals: occupied and vacant area, occupancy, annual base rent as stated against as the leases yield and the difference, WALT (calc_walt, by area and by rent), rollover by year and top-tenant concentration. Flags: leases expiring within 12 months, tenants on the roll with no lease, leases with no roll line, rent on the roll above the lease, the roll's own arithmetic. Returns package_items and package_calculation for fact_package_send kind rent_roll. Deterministic, no model, no clock (as_of is an input). Facts and arithmetic, …

ParameterTypeDescription
propertyobjectrequired
as_ofstringrequiredThe date of the rent roll, YYYY-MM-DD. The tool reads no clock: the current rent step, the leases expiring within 12 months and WALT are all measured from this date.
partiesobjectrequiredThe parties.
roll_documentobjectoptionalOptional: the rent roll document.
building_area_sfnumberoptionalOptional: the building's total rentable area. Vacant area is then the building area less the occupied area (stated as derived); with vacant lines on the roll as well, the two are compared and a difference is flagged. Must be greater than 0.
roll_linesobject[]requiredThe rent roll's lines.
leasesobject[]optionalThe leases, one entry per tenant with the facts of the lease and its amendments.
toleranceobjectoptional

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "rent_roll_certify",
    "arguments": {
      "property": {},
      "as_of": "...",
      "parties": {},
      "roll_lines": []
    }
  }
}
report_createcan modifyHosted FactLot tool (api.factlot.com only). Builds a client-ready document by code, with no model: …

Hosted FactLot tool (api.factlot.com only). Builds a client-ready document by code, with no model: tx_unequal_appraisal (calc_tx_unequal_appraisal: evidence packet PDF or adjustment-grid workbook with live formulas; send registry_tx_equity_candidates' sources as context.sources to print each cited source's as-of date, URL and rights, the rows of its subject and of the candidates used as comparables as context.candidates (value and improvement area must match the calculation) to print each property's account number, codes, land area and year built as sent, with value per SF computed by FactLot, and its selection_rule as context.selection_rule to print the candidate rule as applied), lease_abstract (doc_abstract_lease), cam_reconciliation (calc_cam_reconciliation or _batch), debt_sizing (calc_debt_sizing), asc842_schedule (calc_lease_remeasurement_asc842), compare_proposals (calc_compare_proposals), dcf_summary (calc_dcf_pro_forma), critical_dates (calc_critical_dates; also ics: a calendar with each notice window and deadline dated on its contractual day and a reminder 30 days before; dates before today are left out unless include_past is true), tx_protest_deadline (rules_tx_property_tax_protest_deadline on tax_year, notice_delivered_date?, as_of?, or the _batch rule when arguments has items: ics, one calendar with each notice's statutory filing deadline and conservative file-by date as all-day events, reminders 30 and 7 days before the file-by date, the rule's basis, status, …

ParameterTypeDescription
kindstringrequiredWhich report. One of: tx_unequal_appraisal, lease_abstract, cam_reconciliation, debt_sizing, asc842_schedule, compare_proposals, dcf_summary, critical_dates …
formatstringrequiredxlsx, pdf, or ics (critical_dates and tx_protest_deadline). tx_protest_deadline comes as ics or pdf; property_sheet as pdf or xlsx. One of: xlsx, pdf, ics
inputobjectoptionallease_abstract only: the doc_abstract_lease result, used when arguments are not sent (each page then says the values are the caller's). For other kinds a result sent here is not used; the answer says whether it matches FactLot's run (result_mismatch).
argumentsobjectoptionalThe tool's arguments. Required for every kind but lease_abstract: FactLot runs the tool on them and builds the document from that run only. tx_protest_deadline: rules_tx_property_tax_protest_deadline's (tax_year, notice_delivered_date?, as_of?), or with items …
contextobjectoptionalOptional title, prepared-for line, and citations (text only).
include_pastbooleanoptionalics only: also put dates before today in the calendar (critical_dates: today in UTC; tx_protest_deadline: today in US Central time, and the passed tax year's dates beside next season's). By default they are left out.
inlinebooleanoptionalAlso return the file as base64 (an embedded resource) when it is under 1 MiB.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "report_create",
    "arguments": {
      "kind": "tx_unequal_appraisal",
      "format": "xlsx"
    }
  }
}
rules_tx_property_tax_protest_deadlineread-onlyDeadline to file a Texas property tax protest with the appraisal review board: the later of May 15 or 30 days …

Deadline to file a Texas property tax protest with the appraisal review board: the later of May 15 or 30 days after the notice of appraised value was delivered, rolled past weekends and Texas legal holidays, plus a conservative file-by date (the last business day on or before the unadjusted deadline). status says where as_of (default: today in US Central time; echoed in as_of) falls: not_yet_open before January 1 of the tax year, open from then through the deadline, passed after it; days_remaining counts the days to the deadline (null once passed), and once passed next_season gives the same rule for the next tax year (May 15 basis). notes says what the rule does not cover (late protests, other §41.44 deadlines, §25.25 corrections) and which sections to read. Returns the statute citations, the rule's verification status and a disclaimer. Information about a statutory deadline: not legal or tax advice and not a substitute for the advice of an attorney. Verification status: verified. The answer carries rule rules.tx.property_tax_protest_deadline@2 and the statutes it rests on.

ParameterTypeDescription
tax_yearintegerrequiredTax year being protested, e.g. 2026.
notice_delivered_datestringoptionalDate the appraisal district's notice of appraised value was delivered (Tax Code §25.19), YYYY-MM-DD. A mailed notice is presumed delivered on the day it was deposited in the mail (§1.07(c)). Omit if unknown (May 15 is then the only basis).
as_ofstringoptionalDate the status is measured from, YYYY-MM-DD. Default: the current date in US Central time (America/Chicago), when the call is answered; pass it to fix the date (for a report, or for El Paso and Hudspeth counties, which keep Mountain time).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "rules_tx_property_tax_protest_deadline",
    "arguments": {
      "tax_year": 0
    }
  }
}
rules_tx_property_tax_protest_deadline_batchread-onlyTexas property tax protest deadlines for many notices in one call (1–200 items, e.g. a consultant's client …

Texas property tax protest deadlines for many notices in one call (1–200 items, e.g. a consultant's client list): each item's id, tax year and, if known, notice delivery date. Each result is exactly what rules_tx_property_tax_protest_deadline returns for that item under rule rules.tx.property_tax_protest_deadline@2 (deadline, unadjusted deadline, governing basis, conservative file-by date, skipped days, status, days_remaining, next_season, the item's warnings), echoed with its id; an item with invalid input carries its error and the others are still answered. One as_of (default: today in US Central time) applies to every item. summary counts the items per deadline, earliest first, with the earliest and latest deadline, and per status (by_status). The as_of used, the notes, the statute citations, the rule's verification status and the disclaimer appear once (value.as_of, value.notes, value.rule, value.disclaimer). A rules tool: never a registry lookup. Information about statutory deadlines: not legal or tax advice and not a substitute for the advice of an attorney; it does not say whether to protest. Verification status: verified. The answer carries rule rules.tx.property_tax_protest_deadline_batch@1 and the statutes it rests on.

ParameterTypeDescription
itemsobject[]requiredThe notices to compute deadlines for (1–200): each one's id, tax year and, if known, notice delivery date. Each result equals rules_tx_property_tax_protest_deadline for that item.
as_ofstringoptionalDate the status is measured from, YYYY-MM-DD. Default: the current date in US Central time (America/Chicago), when the call is answered; pass it to fix the date (for a report, or for El Paso and Hudspeth counties, which keep Mountain time). One date for every …

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "rules_tx_property_tax_protest_deadline_batch",
    "arguments": {
      "items": []
    }
  }
}
schema_getread-onlyReturn the FactLot data model (Fact, Provenance, SourceRef, Rights, Relationship) as JSON Schema.

Return the FactLot data model (Fact, Provenance, SourceRef, Rights, Relationship) as JSON Schema.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "schema_get",
    "arguments": {}
  }
}
searchread-onlySearch FactLot's knowledge base (tools, inputs, CRE predicates, ID and fact specifications). Returns matching …

Search FactLot's knowledge base (tools, inputs, CRE predicates, ID and fact specifications). Returns matching document ids, titles, and URLs; call fetch for full text. A query on a subject the knowledge base does not cover returns no results and a note.

ParameterTypeDescription
querystringrequiredWhat you are looking for, e.g. 'CAM cap non-cumulative' or 'loan sizing DSCR'.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "search",
    "arguments": {
      "query": "..."
    }
  }
}

Resources 29

Prompts 10

Badge

Maintain this server? Put its live status in your README:

MCP status badge

[![MCP status](https://mcp.aianytime.net/badge/factlot.svg)](https://mcp.aianytime.net/s/factlot/)

Edit this entry · Report a problem

More in Finance & markets

Checks record what a server answered, not whether it is safe. A listing is not a security audit; read a server's source and permissions before you connect it. Add a server · JSON · llms.txt · llms-full.txt

Browse: Agents, IDEs & developer tools · Search & discovery · Knowledge, memory & context · Media & generation · Security · Finance & markets · Marketing, content & social · Cloud, ops & data · Commerce, travel & logistics · Work & productivity · No account needed · Local servers