Back to Browse

Factlot MCP Server

Developer ToolsLow Risk10.0MCP RegistryRemote
Free

Server data from the Official MCP Registry

Cited CRE facts and deterministic calculators for agents: rent, CAM, debt sizing, IRR, parcel IDs.

About

Cited CRE facts and deterministic calculators for agents: rent, CAM, debt sizing, IRR, parcel IDs.

Remote endpoints: streamable-http: https://api.factlot.com/mcp

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (5 strong, 3 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.

58 tools verified · Open access · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Found in Source Code

Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.

database

Applies to the server that hosts this plugin, not to your machine.

HTTP Network Access

Connects to external APIs or services over the internet.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "io-github-9mp96ygnbk-alt-factlot": {
      "url": "https://api.factlot.com/mcp"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

FactLot

An open fact layer for commercial real estate AI agents. Deterministic CRE math with an audit trail, canonical property IDs, and public-record facts that cite the document they came from. Free to use hosted, free to run yourself, open source.

CI Release MCP Registry Hosted MCP License

Try it in ten seconds

No key, no install:

curl -s https://api.factlot.com/v1/calc/debt_sizing -H 'content-type: application/json' \
  -d '{"noi":1000000,"value":15000000,"rate_annual":0.065,"amortization_years":30,"max_ltv":0.65,"min_dscr":1.25}'

The answer is a $9,750,000 maximum loan, bound by loan-to-value (the coverage test alone would allow $10.5 million), with every intermediate step, its formula, and the versioned formula ID calc.debt_sizing@3 so an agent can cite exactly how the number was made.

Check what your agent read from a lease the same way: it extracts each term with the exact quote and page, and doc_verify_facts confirms the quote is on that page and states the value, then returns cited facts or the reason it could not (document verification). No model runs on FactLot's side and nothing is stored.

Check us against your own spreadsheet: eight Excel workbooks (office, industrial, retail, hotel, lender, lease accounting and more) put live Excel formulas beside FactLot's numbers with a difference column of 0.00 (synthetic inputs; ARGUS parity is untested and not claimed). What the registry holds, county by county, and the licence and AI-use rights of every source: coverage and rights.

Lease comps, free: 6,994 federal (GSA) lease comps (5.3 MB, public domain) as cited public-record facts, and an open format with lease_comp_validate so firms can share comps with each other, each with stated rights, no names, and a derived net effective rent (lease comps). GSA leases are government-tenant leases, not market comps for every use. Search them from any agent, hosted, with lease_comp_search.

Connect your agent

ClientHow
Claude Code plugin/plugin marketplace add 9mp96ygnbk-alt/factlot, then /plugin install factlot@factlot: twelve CRE skills (loan sizing, lease economics, CAM, ASC 842, returns and more) wired to the hosted tools (plugin)
Claude Codeclaude mcp add --transport http factlot https://api.factlot.com/mcp
Claude (web and Desktop)Customize, then Connectors, then + Add, then Add custom connector: https://api.factlot.com/mcp. Or open factlot-0.5.0.mcpb
ChatGPTDeveloper mode app with https://api.factlot.com/mcp, or a Custom GPT Action importing https://api.factlot.com/openapi-3.0.json
Cursor, VS Code, other clientsRemote MCP URL https://api.factlot.com/mcp (guides)
Any MCP client, run locallynpx -y https://github.com/9mp96ygnbk-alt/factlot/releases/download/v0.5.0/factlot-mcp-standalone-0.5.0.tgz (Node.js 22.6+, no network calls)
Python agentspip install "git+https://github.com/9mp96ygnbk-alt/factlot.git@v0.5.0#subdirectory=python"
Self-hosted REST and MCPdocker run -p 8787:8787 ghcr.io/9mp96ygnbk-alt/factlot:0.5.0

The hosted endpoint is free with no key at 60 requests a minute. The local package, the Desktop extension, the Python install and the Docker image above are release v0.5.0. Their next release brings what the hosted server already runs: the tools registry_lookup_batch and registry_recorded_facts, new inputs on existing tools (registry_search_address address, city, state, postal_code and county_fips; registry_coverage fields; same_building_class, same_local_use_code and local_use_codes on the equity-candidate tools; address and label on the subject and comparables of calc_tx_unequal_appraisal; as_of on the Texas deadline rules), and MCP resources and prompts. report_create, the account tools and the model-backed tools are hosted only. It is listed in the official MCP Registry as io.github.9mp96ygnbk-alt/factlot. Runnable examples for REST, Python and agent SDKs are in examples/.

Try the registry tools on real data: the DC registry sample (23.5 MB, CC BY 4.0) holds 18,077 District of Columbia commercial parcels, 5,513 owning entities, 7,931 cited ownership links, 396 buildings, zoning districts for 16,648 parcels and the latest recorded sale for 12,594.

curl -fLO https://github.com/9mp96ygnbk-alt/factlot/releases/download/registry-sample-dc-2026-11-07/factlot-registry-sample-dc-2026-11-07.db.gz && gunzip factlot-registry-sample-dc-2026-11-07.db.gz
FACTLOT_REGISTRY_DB="$PWD/factlot-registry-sample-dc-2026-11-07.db" npx -y https://github.com/9mp96ygnbk-alt/factlot/releases/download/v0.5.0/factlot-mcp-standalone-0.5.0.tgz

Plans: the hosted endpoint is free with no key: every calculator, ID, fact, rules and document tool at 60 requests a minute per IP address, 25 registry lookups a day per IP address, and 3 reports a month per IP address; an optional free key by email counts requests and registry lookups on its own meter (the free keys used from one IP address share 60 requests a minute and 100 lookups a day), and reports stay counted per IP address too. Eight things on the hosted API need a Pro or Team key: value history before the current roll year and superseded facts (registry_get, and the subject of registry_tx_equity_candidates); registry_get with as_of (a record on an earlier date); registry_tx_equity_candidates with tax_year (a roll year you name); a parcel's recorded sales, deeds and mortgages beyond the newest sale or deed (registry_get), and registry_recorded_facts; an owner's parcels beyond the first three (registry_owned_by, and registry_get on an entity); the registry batch tools registry_lookup_batch and registry_tx_equity_candidates_batch; the model-backed tools doc_extract_lease and report_narrative; and the account tools account_status and account_usage. Pro, $49 a month or $490 a year: 1 API key, 600 requests a minute, 5,000 registry lookups a month, 50 reports a month, email support. Team, $599 a month: up to 5 API keys, 3,000 requests a minute, 100,000 registry lookups a month, 1,000 reports a month, priority support, and a vote on which regions open next. A lookup is one call to a registry_* tool that finds something: a record, a resolved ID, owners or search results. Not counted: a call that finds nothing (an empty list, urn null or a NotFound inside loaded coverage; up to an hourly limit), registry_coverage, input errors, misses outside loaded coverage (county, state, entity registry or ID system not loaded) and calls the registry could not answer. Limits are hard caps with no overage charges; at a cap the call returns HTTP 429 with the reset time. Paid plans renew until cancelled (monthly, or yearly on Pro yearly); cancel any time. A registry download licence ($2,400 a year per state file, for internal use, not redistribution, refreshed when the hosted regions are, with no promised interval; see service levels) is available on request, and Enterprise (private deployment, invoicing, a signed data-processing agreement with a no-training commitment, and SSO) is by quote: contact@factlot.com. Terms · Privacy. Questions and bug reports go in GitHub Discussions and Issues.

Hosted registry

The hosted API at https://api.factlot.com answers registry lookups on every plan, including the free tier with no key (25 registry lookups a day per IP address). These regions are hosted:

RegionHosted data
MarylandAll 24 jurisdictions; 109,249 commercial parcels and 2,812 buildings from SDAT data as of 2026-11-05, public domain
The District of Columbia18,077 commercial parcels, 5,513 registered business entities and 396 buildings, with owners of record that are organisations, zoning and recorded sales; CC BY 4.0
Juab and Summit counties in Utah1,528 parcels, snapshot as of 2025-11-26; CC BY 4.0, "State of Utah, SGID"
Eighteen Texas counties323,785 commercial parcels: Harris 87,717 with 3,511 buildings, Dallas 59,645 with 998 buildings, Travis 30,556 with 407 buildings, Collin 18,035 with 656 buildings, Cameron 14,173 with 98 buildings, Bell 13,685, Nueces 13,634 with 493 buildings, Denton 13,304 with 311 buildings, Williamson 11,758 with 402 buildings, Galveston 10,088 with 274 buildings, Jefferson 9,594 with 204 buildings, Brazos 8,252 with 64 buildings, Midland 7,641, Ector 7,036, Grayson 6,613 with 41 buildings, Johnson 4,416, Guadalupe 4,081 with 33 buildings and Kaufman 3,557 with 42 buildings; Denton and Williamson from 2027 preliminary rolls as of 2026-11-07; Midland has no values because its publisher's file has none; value history by tax year, organisation owners only, and the 91,641 Texas Comptroller entities that own a hosted parcel; registry_tx_equity_candidates and its batch form answer for these counties; appraisal-district rolls are public record with no licence stated, cited per fact with each source's rights
New York CityAll five boroughs; 164,633 commercial parcels and 5,071 buildings from the Department of Finance final assessment roll as of 2026-05-15, public record with no restrictions on use, with owners of record that are organisations, and the 66,509 New York Department of State entities that own a hosted parcel
Los Angeles County203,179 commercial parcels from the Assessor's parcel data roll as of 2026-10-14; no owner names, which the public file does not carry; the County's open-data terms allow commercial use
San Francisco19,048 commercial parcels from the Assessor's secured roll (the 2025 roll year, the latest published; file as of 2026-06-26); no owner names, which the public file does not carry; public domain (PDDL)
The City of BostonThe City of Boston only, not Chelsea, Revere or Winthrop, the rest of Suffolk County; 13,296 commercial parcels from the Assessing Department's fiscal-year 2026 file, with values as of 2025-01-01, older than the other regions; public domain (ODC-PDDL)
Denver13,539 commercial parcels from the Assessor's file as of 2026-10-29; CC BY 3.0, "City and County of Denver", and the 6,678 Colorado Secretary of State entities that own a hosted parcel
Connecticut43,398 commercial parcels in eight former counties, from the towns' grand lists in the statewide parcel and CAMA layer as of 2026-11-09; CC0, and the 23,752 Connecticut Secretary of the State entities that own a hosted parcel

The hosted API serves Maryland (all 24 jurisdictions), the District of Columbia, Juab and Summit counties in Utah, eighteen Texas counties (Harris, Dallas, Travis, Collin, Cameron, Bell, Nueces, Denton, Williamson, Galveston, Jefferson, Brazos, Midland, Ector, Grayson, Johnson, Guadalupe and Kaufman), New York City (all five boroughs), Los Angeles County, San Francisco, the City of Boston, Denver, and Connecticut (statewide, by town): 909,732 parcels in 62 counties. Call registry_coverage first: it lists exactly what is hosted, and a lookup outside it returns a coverage miss. Every answer cites its source file and the licence or attribution that goes with it. The registry is built to keep owners that are organisations and to exclude natural persons' names (if a record names you as a person, or is wrong, email contact@factlot.com and we will remove or correct it), and the Maryland, Utah, Los Angeles County and San Francisco files carry no owner names. The DC data is the same as the downloadable sample registry-sample-dc-2026-11-07.

Texas roll years on the hosted API: Eleven of the eighteen counties hold more than one roll year (Harris 2022 to 2026, Dallas 2022 to 2026, Travis 2022 to 2026, Bell 2024 to 2026, Nueces 2021 to 2026, Galveston 2023 to 2026, Jefferson 2025 to 2026, Brazos 2016 to 2026, Johnson 2024 to 2026, Guadalupe 2025 to 2026, Kaufman 2024 to 2026), six hold one, and Midland has no values because the publisher's file has none.

The other regions in the project's pipeline are available only on a self-hosted FactLot with a registry file; more hosted regions open as their terms allow. Tarrant County is not served by the hosted registry while the publisher's terms for AI use are unclear.

What FactLot is

Agents doing CRE work get stuck in the same places. They can't trust their own arithmetic, they can't cite where a number came from, and they can't tell that "Suite 400, 123 Main LLC" in one system is the same thing as a parcel number in another.

FactLot gives every agent three things it can use by default:

PackageWhat it doesLicense
@factlot/calc26 deterministic CRE calculators: rent schedules, net effective rent, proposal comparison, multifamily rent rolls, percentage rent, CAM reconciliation, capex recovery, loan sizing, amortization, ASC 842 lease remeasurement, prepayment and defeasance, WALT, NPV, IRR, DCF and direct capitalization, equity waterfalls, 1031 exchange dates, lease critical dates, lease vs. own, renew vs. relocate, hotel metrics, Texas unequal-appraisal arithmetic and reconciliation checks. Every result includes an audit trail and a versioned formula ID.Apache-2.0
@factlot/idFactLot ID gives canonical IDs for parcels, legal entities, buildings, spaces, leases, and documents. IDs are deterministic wherever the world already has a key (parcels, entities, buildings from their street address, spaces, documents), so any agent can compute them offline; leases get minted IDs.Apache-2.0
@factlot/schemaThe FactLot data model. A fact is one atomic claim with provenance (source document, page, clause, method) and rights (whether an AI may use or redistribute it).MIT
@factlot/toolsThe tool catalog, with native tool definitions for Claude, OpenAI, Gemini, Amazon Bedrock, Mistral, and OpenAPI platforms, plus one runTool dispatcher.MIT
@factlot/serverThe remote connector: Streamable HTTP MCP at /mcp, REST at /v1, and OpenAPI. Runs in Docker.Apache-2.0
@factlot/mcpAn MCP server that exposes all of the above to Claude and any other MCP-capable agent. It runs locally and needs no API key.Apache-2.0

What FactLot covers today

Be clear about scope before adopting it:

  • Calculators, IDs, and the fact model work anywhere. They need no data and no API key, and they run offline in both SDKs with identical results.
  • The registry covers the largest metros, unevenly, and not all of it is hosted. The project's registry pipeline has built commercial, industrial and multifamily parcels from public-record sources (which are verified is in coverage), with registered entities from Texas, New York, Colorado, Pennsylvania, DC and Connecticut for owner resolution (counts per county and source in coverage and on the coverage map): the largest metros (Harris, Dallas, Tarrant (not served by the hosted registry), Travis and Collin in Texas, New York City, Los Angeles, Boston, San Francisco, Denver, Charlotte, Minneapolis and DC), the rest of the top 100 counties where the licence allows, and statewide files for New York, Maryland, Massachusetts, Vermont, Arkansas and Connecticut, most of Utah, 24 Minnesota counties and Montana's apartments and industrial parcels (catalog, quality report). What you can query today on the hosted API is Maryland (all 24 jurisdictions), the District of Columbia, Juab and Summit counties in Utah, eighteen Texas counties (Harris, Dallas, Travis, Collin, Cameron, Bell, Nueces, Denton, Williamson, Galveston, Jefferson, Brazos, Midland, Ector, Grayson, Johnson, Guadalupe and Kaufman), New York City (all five boroughs), Los Angeles County, San Francisco, the City of Boston, Denver, and Connecticut (statewide, by town) (909,732 parcels in 62 counties). Tarrant County is not served by the hosted registry while the publisher's terms for AI use are unclear. Every other region needs a self-hosted FactLot with a registry file. Cook County, Florida, Fulton, Maricopa, Wayne, Fairfax, King and much of California wait on a licence decision, a form or a purchase. Several public files omit owner names (Maryland, Utah, Los Angeles, San Francisco); zoning, recorded sales, deeds and mortgages, energy benchmarks and CMBS loan data only for some metros (coverage); no tenant rosters. See the registry and the source catalog.
  • One rules pack, the Texas property-tax protest deadline, verified against the official statute text. Other jurisdictions follow only after a person verifies them.
  • Lease ingestion is a prototype: deterministic quote-on-page and value-in-quote checks, OCR for scanned pages through a pluggable backend, but no published accuracy number yet.
  • No SOC 2 report yet. The hosted service keeps no request bodies (see the privacy notice); for confidential documents, self-host FactLot so nothing leaves your network.
  • Hosted, but not yet on npm or PyPI. The hosted endpoint at https://api.factlot.com serves the calculators, IDs, fact tools, reports and registry lookups for the regions above (free at 60 requests a minute); registry regions not hosted need a self-hosted copy with a registry file. To run it yourself, install from the v0.5.0 release, from git, from source, or with Docker (getting started).

Connect FactLot to any AI platform

PlatformHow to connect
ClaudeAdd a custom connector with https://api.factlot.com/mcp, install the one-click Desktop extension (factlot-0.5.0.mcpb), use Claude Code, or call it from the Claude API
ChatGPT and OpenAICreate a ChatGPT app in developer mode (search/fetch make deep research work), import /openapi-3.0.json (the curated subset of at most 30 operations) as a Custom GPT Action, use the Responses API's remote MCP, or use function calling
Google GeminiUse Gemini API function declarations, Gemini CLI over MCP, or Vertex AI
Microsoft CopilotAdd an MCP tool in Copilot Studio, use the Power Platform connector, or build a Microsoft 365 API plugin
Amazon BedrockUse the Converse API toolConfig, or a Bedrock Agents action group backed by the Lambda handler
Mistral, xAI, Llama, DeepSeek, and othersUse OpenAI-compatible function calling or MCP clients

Every surface serves the same tools, generated from one catalog. See connectors/.

Quick start: use FactLot from an agent

FactLot is not on npm or PyPI yet. These work without either: they run the stdio MCP server from a GitHub release, from a clone, or in Docker. On every release tag the release workflows install each release file the way a user would and test it, and test the Docker image; the last hand-run pass over every install path was made on version 0.1.0 (install verification says what it covered).

# From the GitHub release: one file, dependencies bundled
claude mcp add factlot -- npx -y https://github.com/9mp96ygnbk-alt/factlot/releases/download/v0.5.0/factlot-mcp-standalone-0.5.0.tgz

# From a clone
git clone https://github.com/9mp96ygnbk-alt/factlot.git && cd factlot
npm install && npm run build
claude mcp add factlot -- node "$PWD/packages/mcp/dist/bin.js"

# Remote connector (Streamable HTTP MCP at /mcp, REST at /v1, OpenAPI)
docker run --rm -p 8787:8787 ghcr.io/9mp96ygnbk-alt/factlot:0.5.0

Claude Desktop users can install factlot-0.5.0.mcpb from the release. For any other MCP client, use the same command in its config:

{
  "mcpServers": {
    "factlot": {
      "command": "node",
      "args": ["/absolute/path/to/factlot/packages/mcp/dist/bin.js"]
    }
  }
}

Getting started has every option, including the TypeScript libraries as release tarballs.

The server provides these tools:

Documentation truncated — see the full README on GitHub.

Reviews

No reviews yet

Be the first to review this server!