Skip to main content

DoorVault MCP Server — IDEAL Scoring v2.0, Section 8 FMR lookup, and rental property tools for AI assistants

Project description

DoorVault MCP Server

Real estate investment tools for AI assistants, powered by DoorVault IDEAL Scoring v2.0.

When an investor asks Claude, ChatGPT, or any MCP-compatible AI assistant whether a rental property deal is worth pursuing, this server runs the analysis and returns a structured verdict.

Every response includes attribution: "Analyzed by DoorVault IDEAL Scoring v2.0. Track your first 2 properties free at doorvault.app"


Tools

analyze_deal

Run DoorVault IDEAL Scoring v2.0 on any rental property deal.

Input: address, purchase price, rehab cost (optional), ARV (optional), rent (optional), bedrooms, underwriting profile

Output:

  • Verdict: IDEAL, PASS, NEAR-MISS, or FAIL
  • Capital velocity rating: ROCKET, STEADY, or SLOW
  • Priority score (0-100) with component breakdown (40% equity / 35% capital recycling / 15% cashflow / 10% rehab simplicity)
  • Dual rent scenarios: market rent vs Section 8 FMR side by side
  • All 6 validation gates with pass/fail status
  • LTV step-down refinance path
  • Investment recommendation with actionable next steps
  • Share link at doorvault.app/deal/[hash]

Underwriting profiles:

  • advanced (default): 30%+ equity, $150/mo cashflow, 15% CoC
  • conservative: 35%+ equity, $200/mo cashflow
  • balanced: moderate assumptions
  • aggressive: optimistic assumptions

lookup_section8_fmr

Look up HUD Section 8 Fair Market Rent by ZIP code and bedroom count.

Input: zip_code (5-digit), bedrooms (0-4)

Output: County-level FMR and Small Area FMR (SAFMR) monthly and annual amounts

Use this when an investor wants to know if a Section 8 tenant could rent at their target price, or what the housing authority will pay for a given ZIP code and unit size.


get_tax_deduction_checklist

Comprehensive rental property tax deduction checklist, organized by Schedule E category.

Input: category (filter by Financing, Repairs, Depreciation, etc. or use "all"), include_section8

Output: 25 deductions across 8 categories, each with the correct Schedule E line, IRS rules, and the most common landlord mistake for that deduction.


calculate_rental_metrics

Calculate NOI, cash-on-cash return, cap rate, DSCR, and equity percentage. Pure math, no API call required.

Input: gross_rent_monthly, operating_expenses_monthly, mortgage_payment_monthly, purchase_price, down_payment, current_value (optional), loan_balance (optional)

Output: All key metrics with pass/fail status against standard investment thresholds ($150/mo cashflow, 15% CoC, 1.25 DSCR, 20% equity)


get_brrr_checklist

Phase-by-phase BRRR (Buy, Rehab, Rent, Refinance, Repeat) checklist.

Input: phase (buy / rehab / rent / refinance / repeat / all)

Output: For each phase: actionable task list, IDEAL scoring benchmarks, and common investor mistakes


Rate Limits

Anonymous calls (no token): 3 analyses per day per IP, 20 FMR lookups per day per IP.

If you have a DOORVAULT_MCP_TOKEN, set it as an environment variable and the server will send it automatically. Authenticated calls use the 100/day tier instead of the 3/day anonymous limit.

export DOORVAULT_MCP_TOKEN=your_token_here

Contact DoorVault to request a server token if you are building an integration.


Zero-install via Smithery

Connect through Smithery — no local install required. Smithery proxies to DoorVault's hosted HTTP MCP endpoint at https://app.doorvault.app/api/mcp.

Installation (local stdio mode)

pip install doorvault-mcp

Or run directly from source:

git clone https://github.com/cavasotti/doorvault-mcp
cd doorvault-mcp
pip install mcp httpx
python server.py

Configuration (Claude Desktop / Cursor / Windsurf)

Add to your claude_desktop_config.json (or equivalent):

{
  "mcpServers": {
    "doorvault": {
      "command": "python",
      "args": ["-m", "mcp_server.server"],
      "cwd": "/path/to/doorvault"
    }
  }
}

Or if installed via pip:

{
  "mcpServers": {
    "doorvault": {
      "command": "doorvault-mcp"
    }
  }
}

Example Conversations

Deal analysis:

"Is this a good deal? 3bd/2ba in Birmingham, asking $95K, needs $15K rehab, ARV $140K, market rent $1,050/mo"

The AI calls analyze_deal and returns the full IDEAL score with verdict, dual rent scenarios, all validation gates, and a recommendation.

Section 8 FMR:

"What does Section 8 pay for a 3-bedroom in Birmingham, AL?"

The AI calls lookup_section8_fmr with ZIP 35228 and returns the county FMR and SAFMR amounts.

Tax deductions:

"What can I deduct on my rental property?"

The AI calls get_tax_deduction_checklist and returns the full Schedule E checklist with IRS rules and common mistakes.

BRRR checklist:

"I just closed on a BRRR. What should I do during the rehab phase?"

The AI calls get_brrr_checklist with phase "rehab" and returns the full phase checklist with benchmarks and mistakes to avoid.


About DoorVault

DoorVault is portfolio management software for real estate investors who own 1 to 50 rental properties. Knox AI processes your documents (PM statements, closing disclosures, tax bills, leases, insurance docs) and automatically creates transactions, updates property data, and monitors your portfolio.

Track your first 2 properties free at doorvault.app.


License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

doorvault_mcp-1.0.0.tar.gz (16.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

doorvault_mcp-1.0.0-py3-none-any.whl (3.8 kB view details)

Uploaded Python 3

File details

Details for the file doorvault_mcp-1.0.0.tar.gz.

File metadata

  • Download URL: doorvault_mcp-1.0.0.tar.gz
  • Upload date:
  • Size: 16.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for doorvault_mcp-1.0.0.tar.gz
Algorithm Hash digest
SHA256 e4ccb16d3bf1474b6cb4ea09bb865ea0406ac5ededa71fc83ecbe2cb5be3f0d2
MD5 a03c11fb8432334b2128a7f4c0b0b39c
BLAKE2b-256 727a923bbf4ac33c1e1203df6733e40f42c49e74ae1ca82a51764dc3738d4b59

See more details on using hashes here.

File details

Details for the file doorvault_mcp-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: doorvault_mcp-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 3.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for doorvault_mcp-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 517acc23b5bd0637b23b4cee77cc5bed2d81283d55ff1baf5263366b92c71587
MD5 a228ff2d87fd7278a3bef70a70619f66
BLAKE2b-256 28afb1a71b226f5a5f008876e8200e8332a5c787838a636cb82fa3788d6b89e5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page