Mavvrixx.ai · The Mavvrixx Agent Protocol (MAP)

The Landlord Partner
Journey

From API key to live tenant verification — in 10 stages

This blueprint maps the complete landlord partner journey on Mavvrixx.ai — from first discovery to live production tenant screening. Designed for zero-friction, zero-sales-rep activation. A landlord gets their API key, validates IndieVerify™ in sandbox, and goes live in under a day — without a single sales call or MSA negotiation.

📄 v1.0 · May 2026
🔒 Confidential
🏠 Landlord & Proptech Track
⚡ FCRA + Fair Housing Aligned
250
Free pilot queries
<1hr
Time to first live query
10
Journey stages
0
Sales calls required
35%
Applicants self-employed
100%
Worker-consent gated
01
🏠
The Invisible Tenant Problem: 35% of rental applicants are gig workers, freelancers, or self-employed — yet most screening tools require W-2 income documentation. Landlords reject qualified tenants or accept under-documented ones. IndieVerify™ closes this gap with platform-native income verification, giving landlords a clear, FCRA-aligned signal without ever seeing the tenant's tax returns or bank statements.
👤
The Invisible Tenant
35% of applicants are self-employed, gig workers, or multi-platform earners. Traditional screening that requires pay stubs or W-2s systematically rejects otherwise-qualified tenants — costing landlords good applicants and units.
🆚
IndieVerify™ vs Traditional Screening
Traditional screening uses credit bureau pulls and employer verification. IndieVerify™ uses real-time gig platform tenure, income stability, vocation band, and income consistency — updated continuously.
⚖️
Fair Housing Act Aligned
IndieVerify™ assesses economic signals — not demographic proxies. Worker-initiated consent token per query. Designed for Fair Housing Act alignment and FCRA safe harbor from day one.
API-First Design
JSON-RPC 2.0. Single POST endpoint. Sub-200ms response. Drop into AppFolio, Buildium, Yardi, or custom screening flows — no new database schema required.

IndieVerify™ vs Traditional Tenant Screening

Dimension Traditional Screening IndieVerify™ Signal
Self-employed applicants No W-2 = rejected or manual review Platform tenure + income stability signal
Data freshness 30–90 day bureau lag Real-time platform verification
Fair Housing Act risk Employer-type rejection can be a disparate impact proxy Vocation-neutral economic signal, no demographic proxy
FCRA classification Consumer report (§604 permissible purpose required) Worker-initiated, not a consumer report
Integration Batch pull, FTP, legacy portals REST/JSON-RPC, <200ms, single endpoint
PII exposure Landlord receives full SSN/DOB report Landlord never touches PII; token-gated
💡
What the landlord sees on /landlords: The hero section with the value prop, a side-by-side screening comparison, a live "try it" demo, and the "Get API Key" CTA. No gating, no form wall. Friction: zero.
02
Pilot
Free / 250 queries
Validate IndieVerify™ on your own applicant pool. No credit card required. API key issued instantly.
  • 250 IndieVerify™ queries
  • Sandbox environment access
  • Full API docs + code snippets
  • JSON-RPC 2.0 + REST
  • Email + Slack developer support
  • FCRA + Fair Housing compliance brief
Enterprise / MAP
Custom
Full MAP protocol integration. Agentic screening, portfolio monitoring, co-marketing. Custom volume pricing (MAP).
  • Full MAP protocol access
  • Agentic screening integration
  • Portfolio-level income monitoring
  • Custom SLA (99.99%)
  • Named account manager
  • Co-authorship on validation study
  • Pioneer Partner status
⚖️
FCRA + Fair Housing Act Compliance Note: IndieVerify™ is NOT a consumer report as defined under 15 U.S.C. § 1681a(d). Each query requires a valid IndieVerify™ consent token initiated by the tenant/applicant. Using IndieVerify™ as a factor in an adverse rental decision requires compliance with applicable state and local adverse-action notice requirements. Mavvrixx.ai provides a standard FCRA + Fair Housing compliance brief with every plan. We recommend independent legal review before production deployment.

Signup Flow

  • Enter email → verify → dashboard provisioned in <60 seconds
  • Select plan → Stripe checkout (card / ACH) or invoice for Enterprise
  • API key emailed + shown in dashboard immediately
  • Sandbox pre-loaded with 15 synthetic applicant profiles across income bands
  • Optional: enroll in Product Listing Portal (Stage 1B) during signup or any time
2B
🤖
How It Works: When a Mavvrixx member is ready to rent, Mavvy — the Mavvrixx AI agent — checks their IndieVerify™ signal on-consent and matches them against enrolled landlord listings. The landlord receives a pre-verified applicant with income band, platform tenure, and screening recommendation already included. No cold applications. No unqualified prospects. Just pre-qualified, consent-verified tenants.
🏢
List Available Units
Submit unit details: location, size, rent range, minimum income band, lease terms, and pet policy. Mavvy matches your criteria against pre-verified members in real-time.
Pre-Verified Applicants
Every applicant delivered via the portal has passed IndieVerify™ screening against your minimum criteria. Screening recommendation (APPROVE/REVIEW/DECLINE) included. You review and decide.
💰
Performance Model
No listing fee. No impression fee. You pay only when you sign a lease with a Mavvrixx-referred tenant. Commission is a flat placement fee — not a percentage of rent.
📊
Listing Analytics
Track impressions, applicant matches, applications submitted, and signed leases. Available in your partner dashboard at /partners/landlords.

Listing Setup (5 minutes)

  • Unit address, type (studio, 1BR, 2BR, etc.), and available date
  • Monthly rent and security deposit requirement
  • Minimum income band accepted (e.g., income_band ≥ B)
  • Lease term (month-to-month, 6-month, 12-month)
  • Pet policy, smoking policy, other restrictions
  • Webhook URL for applicant delivery
03
🔑
API Key Format
Sandbox: mcp_landlord_sandbox_XXXX
Production: mcp_landlord_live_XXXX

Rotatable at any time. Scoped to query type. No shared credentials.
Live Query Counter
Real-time display of queries used vs pilot limit. Sub-second update latency. Visual burn-rate graph showing pilot queries remaining.
🧪
Sandbox Environment
15 pre-loaded applicant profiles across income bands, vocation types, and platform tenures. Responses are synthetic but schema-identical to production.
📎
Code Snippets
Copy-paste-ready curl and JavaScript snippets pre-filled with your API key. Test in terminal immediately.

First-run: curl in 30 seconds

# Your API key is pre-filled below — copy and run
curl -X POST https://api.mavvrixx.ai/v1/signal/query \
  -H "X-Mavvrixx-Key: mcp_landlord_sandbox_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "indieverify.screening",
    "params": {
      "consent_token": "ivt_sandbox_tenant_001",
      "query_type": "standard"
    },
    "id": 1
  }'
Dashboard milestone: After 3 successful sandbox queries, the dashboard shows a "Promote to Production" button — one click, instant key upgrade. No approval queue, no human review for Growth plan.
04

IndieVerify™ Tenant Screening Schema

identity_verified
boolean
Whether the applicant's identity has been verified against at least one connected platform identity. True = verified identity on record. False = no verification available — return 403 on missing consent.
income_band
string enum
Applicant income band classification: A (high, stable) | B (moderate-high) | C (moderate) | D (low/irregular). Derived from platform earnings data and income consistency over 12 months.
platform_tenure_months
integer
Number of months the applicant has been actively earning on at least one gig or freelance platform. Workers with 12+ months tenure show materially lower payment default rates in pilot cohorts.
income_stability_score
integer (0–100)
Composite score measuring consistency of income delivery over a rolling 12-month window. Higher = more stable and predictable monthly income. Accounts for seasonal variance in qualifying vocations.
vocation
string
Applicant's primary vocation category from the Mavvrixx vocation taxonomy. Examples: rideshare_driver, freelance_software, airbnb_host, delivery_courier. Used for income band calibration.
screening_recommendation
string enum
Non-binding screening recommendation: APPROVE | REVIEW | DECLINE. Based on income band, stability score, and platform tenure relative to your unit's minimum criteria. Final decision always rests with landlord.
fcra_compliant
boolean
Always true for valid consent-gated queries. Confirms the query was worker-initiated, consent-scoped, and does not constitute a consumer report under 15 U.S.C. §1681a(d).

Full Response Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "signal_version": "1.2.0",
    "query_id": "qry_01HX9K2M3WNVB4FCGAYZ8Q2",
    "consent_token_status": "valid",
    "signal_timestamp": "2026-05-08T00:00:00Z",

    // Core IndieVerify™ fields
    "identity_verified": true,
    "income_band": "B",
    "platform_tenure_months": 24,
    "income_stability_score": 78,
    "vocation": "freelance_designer",

    // Screening recommendation
    "screening_recommendation": "APPROVE",
    "fcra_compliant": true,

    // Metadata (never contains PII)
    "meta": {
      "query_type": "standard",
      "latency_ms": 128,
      "model_version": "indieverify-v1"
    }
  }
}
⚠️
PII Guarantee: The IndieVerify™ response never contains the applicant's name, Social Security Number, date of birth, address, or any FCRA-defined personally identifiable information. The landlord receives only the signal fields above. The consent token is a one-way opaque identifier — landlords cannot reverse-engineer the tenant's identity from it.

Transport & Authentication

  • Protocol: JSON-RPC 2.0 over HTTPS POST
  • Authentication: X-Mavvrixx-Key: mcp_landlord_<env>_<key> header
  • Base URL: https://api.mavvrixx.ai/v1/signal/query
  • Rate limit: 10 req/sec (Growth), 100 req/sec (Enterprise)
  • Timeout: 5,000ms server-side max; p99 <200ms
  • Retry: Exponential backoff on 429/503. 3 retries max.
  • SDK support: JavaScript/Node.js + curl snippets in dashboard
4B
🤖
What is MAP for Landlords? The Mavvrixx Agent Protocol (MAP) is Mavvrixx.ai's implementation of the MCP 2024-11-05 standard, extended with IndieVerify™ tools and consent management. It allows any LLM-based screening agent — embedded in AppFolio, Buildium, Yardi, or a custom platform — to call IndieVerify™ as a first-class tool with structured JSON tool descriptions, parameter validation, and consent-aware routing built in.
🔌
MCP 2024-11-05 Transport
Full compliance with the Model Context Protocol spec. Tool definitions auto-expose to any MCP host (Claude, GPT-4, custom LLMs). No custom SDK needed beyond MCP client.
🏗️
AppFolio, Buildium, Yardi
Embed IndieVerify™ into your existing property management platform's screening workflow. Pre-built adapter examples for major proptech platforms included in docs.
📐
Additive Signal
IndieVerify™ is an additive input, not a replacement for credit checks. Feed it alongside TransUnion SmartMove, Equifax, or background check results. Use it specifically for the self-employed applicant segment.
🔒
Consent-Aware Tool Calls
MAP tools validate the IndieVerify™ consent token before executing any signal query. The AI agent cannot bypass the consent gate — it's enforced at the MAP server layer.

MAP Tool Definition (MCP JSON)

{
  "name": "indieverify_screening",
  "description": "Screen a rental applicant using IndieVerify™. Requires a valid worker-initiated consent token. Returns identity_verified, income_band, platform_tenure_months, income_stability_score, vocation, screening_recommendation, and fcra_compliant.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "consent_token": {
        "type": "string",
        "description": "IndieVerify™ consent token (ivt_*) issued by the applicant"
      },
      "query_type": {
        "type": "string",
        "enum": ["standard", "portfolio_check"],
        "description": "Screening query type"
      }
    },
    "required": ["consent_token"]
  }
}

Integration Steps

1
Obtain MAP server URL
Your MAP endpoint is provisioned with your API key: https://map.mavvrixx.ai/mcp/<your-key>. Available in your dashboard immediately after plan selection.
2
Register MAP as MCP server in your LLM host
Add the MAP endpoint to your MCP client config (AppFolio plugin, Buildium integration, or custom agent). The MAP server self-describes its tools — the LLM automatically discovers indieverify_screening and consent management tools.
3
Applicant initiates consent
During the rental application, the tenant taps "Share my income signal with [Landlord]" in the Mavvrixx app or via IndieVerify™ embedded widget. An ivt_* consent token is issued and passed to your agent via webhook or deep link.
4
Agent calls IndieVerify™ as a tool
Your LLM agent calls indieverify_screening with the consent token. MAP validates consent, queries the signal engine, and returns structured JSON directly into your agent's context window — including screening_recommendation.
5
Agent incorporates signal into screening decision
The LLM reasons over IndieVerify™ alongside credit check, background check, and rental history. Returns a structured screening summary. Your property management system acts on it — the LLM informs the decision, the landlord makes it.
05
250
Free sandbox queries
15
Pre-loaded profiles
4
Platform types covered
3
Income bands tested

Sandbox Applicant Profiles

Profile ID Vocation Platform Tenure Income Band Recommendation
ivt_sandbox_tenant_001 Freelance Designer Upwork / Fiverr 31 months A APPROVE
ivt_sandbox_tenant_002 Rideshare Driver Uber / Lyft 14 months B REVIEW
ivt_sandbox_tenant_003 Airbnb Host Airbnb 48 months A APPROVE
ivt_sandbox_tenant_004 Delivery Courier DoorDash / Instacart 6 months C REVIEW
ivt_sandbox_tenant_005 Freelance Developer Toptal / Upwork 22 months A APPROVE
ivt_sandbox_tenant_006 Content Creator YouTube / Patreon 8 months D DECLINE
🧪
What to test in sandbox: Run profiles across all four income bands. Validate that Band A/B profiles generate APPROVE or REVIEW as expected. Validate that Band D profiles trigger your internal review or decline workflow. Test the consent token expiry/revocation handling using ivt_sandbox_expired and ivt_sandbox_revoked. Confirm your error handling on 403 responses. Test your Fair Housing adverse-action notice workflow for DECLINE recommendations.

Sandbox to Production Checklist

  • At least 10 sandbox queries completed successfully
  • Error handling validated (403, 429, 503)
  • Consent token lifecycle tested (valid, expired, revoked)
  • Response schema mapped to your screening workflow
  • Fair Housing Act adverse-action notice workflow confirmed
  • Legal team reviewed FCRA + Fair Housing compliance brief
  • Webhook endpoint configured (optional but recommended)
06
🔒
Hard Rule: A valid, non-expired IndieVerify™ consent token is required for every screening query. If the token is absent, expired, or revoked, the API returns HTTP 403 with {"error": {"code": -32001, "message": "consent_token_invalid"}}. There is no override. There is no admin bypass. This is enforced at the infrastructure layer — protecting landlords from accidental Fair Housing violations.

Consent Flow

1
Applicant initiates consent
During the rental application (on the landlord's platform, portal, or via Mavvy in-app), the applicant is shown a clear, plain-language consent screen: "Allow [Landlord Name] to view your IndieVerify™ income signal for this rental application?" Applicant taps Approve.
2
IndieVerify™ token issued
Mavvrixx issues a single-use, time-limited ivt_* token scoped to the specific landlord and query type. Token TTL: 30 minutes (configurable 5–60 min). Token is delivered to the landlord via webhook or the applicant shares it via deep link. No SSN or PII is shared.
3
Landlord queries signal with token
The landlord's system passes the ivt_* token in the JSON-RPC request body. MAP validates: (a) token signature, (b) token not expired, (c) token not revoked, (d) querying landlord matches token-bound landlord ID. On pass: signal returned. On fail: 403.
4
Token consumed
After a successful query, the token is marked consumed and cannot be reused. The applicant can grant a new consent for follow-up queries. Applicants can view and revoke all consent tokens via their Mavvrixx app at any time.
5
No PII stored after consent window
After the token is consumed and the consent window closes, no PII is retained in Mavvrixx's systems linked to the landlord's query. Only the audit log entry (timestamp, landlord ID, token ID, result code) is retained for 7 years for compliance purposes.
🙅
No PII, Ever
The landlord never receives names, SSNs, DOBs, or addresses. The consent token is cryptographically opaque. Reverse-engineering applicant identity from the token is computationally infeasible.
🔄
Applicant Can Revoke Anytime
Applicants see all issued consent tokens in their Mavvrixx app. One tap to revoke any token. Revoked tokens return 403 immediately — no caching, no race conditions.
📋
Fair Housing Act Alignment
IndieVerify™ returns economic signals, not demographic data. Vocation-neutral income band classification avoids the disparate impact risk of employer-type screening. Screening recommendation is based solely on income consistency and stability.
📁
7-Year Audit Retention
Full immutable audit log of all queries. Supports regulatory inquiry, Fair Housing audit, and internal compliance review. Available in dashboard and via API export.
07
🚀
Go-Live Timeline: Pilot signup → sandbox complete: 15 minutes. Sandbox complete → "Promote to Production" click: your call. Production key active → first live verification: under 60 seconds. Entire journey from zero to live tenant screening: typically under 1 hour if the landlord's integration is ready.

Go-Live Checklist

  • Sandbox checklist complete (Stage 5)
  • Production API key issued (auto on plan upgrade)
  • Key stored in secrets manager, not environment variables
  • Webhook endpoint live and receiving test payloads
  • Fair Housing Act adverse-action notice workflow confirmed with legal
  • Rate limit capacity confirmed (Growth: 10 req/sec)
  • Monitoring / alerting configured for 4xx/5xx rates
  • Volume pricing confirmed for expected screening volume

Production SLA

MetricGrowthEnterprise
Uptime99.9% monthly99.99% monthly
P99 latency<300ms<200ms
Rate limit10 req/sec100+ req/sec (custom)
Support response<4 hours (email/Slack)<1 hour (named contact)
Incident commsStatus pageDirect Slack + phone

Volume Pricing

Monthly VolumePrice per Query
1 – 500 (Pilot)Free
501 – 5,000$65
5,001 – 25,000$45
25,001+Custom (Enterprise / MAP)
08
📊
Query Volume Analytics
Daily/weekly/monthly IndieVerify™ query volume. Breakdown by vocation type and income band. Screening recommendation distribution (APPROVE / REVIEW / DECLINE). Response time histogram.
🎯
Acceptance Rate by Platform
See which platform types (Uber, Airbnb, Upwork, etc.) generate the highest APPROVE rates in your screening workflow. Optimize your intake funnel to focus on the highest-converting applicant types.
📈
Income Band Distribution
Distribution of applicants by income band (A/B/C/D). Track how your accepted tenant pool's income stability compares to your overall applicant flow. Informs rent-to-income ratio policy.
⚙️
Key Management
Rotate API keys, set key expiry, restrict key to IP allowlist, download audit log CSV, configure webhook endpoints, manage listing portal submissions.
📈
Platform Acceptance Insights: Landlords using IndieVerify™ at scale gain data-driven insight into which gig platform categories produce the most stable tenants in their market. Airbnb Hosts with 18+ months tenure have shown above-average rent payment consistency in early pilot cohorts. This data helps landlords make informed screening policy decisions — while staying compliant with Fair Housing Act requirements.
09
Batch Verification
Submit up to 1,000 consent tokens in a single batch request. Async processing with webhook callback on completion. Ideal for portfolio landlords re-screening existing tenants or proptech platforms processing high application volume.
🔔
Webhook Callbacks
Configure up to 5 webhook endpoints. Receive real-time notifications on: screening completion, consent grant/revocation, token near-expiry, SLA breach, and product listing applicant delivery.
🤖
Automated Screening Workflows
Connect IndieVerify™ to your existing property management system via MAP. Automatically screen every incoming application, route Band A/B to fast-track approval, and Band C/D to manual review — all without human-in-the-loop for routine cases.
📡
Portfolio Monitoring
Enterprise feature: subscribe to income monitoring signals for your existing tenants. Get notified when a tenant's income stability score drops materially — proactive early warning for potential rent payment risk.

Batch Verification Request

{
  "jsonrpc": "2.0",
  "method": "indieverify.batch_screening",
  "params": {
    "consent_tokens": [
      "ivt_live_tenant_001",
      "ivt_live_tenant_002",
      "ivt_live_tenant_003"
      // ... up to 1,000 tokens per batch
    ],
    "query_type": "standard",
    "callback_url": "https://your-platform.com/webhooks/mavvrixx",
    "batch_label": "portfolio_rescreen_may_2026"
  },
  "id": 1
}

// Response: batch job ID, async — results POSTed to callback_url
{
  "result": {
    "batch_id": "batch_01HX8K9P2TENANT3FCGTYZ7Q1",
    "status": "processing",
    "token_count": 500,
    "estimated_completion_ms": 22000
  }
}
📋
Batch consent requirements: Batch mode requires pre-authorized rolling consent tokens with rolling: true flag, explicitly authorized by the applicant for periodic screening or renewal checks. One-time consent tokens cannot be used in batch mode. Tenants must explicitly opt in to rolling consent in the Mavvrixx app.
10
⭐ Pioneer Partner Status
Mavvrixx Pioneer Landlord Partner
Awarded to landlords and proptech platforms reaching 5,000+ IndieVerify™ queries/month. Pioneer Partners shape the future of tenant screening — contributing outcome data, co-authoring the validation study, and co-marketing their gig-economy leasing leadership to Mavvrixx's 1.57B member target audience.
Custom volume pricing negotiation
"IndieVerify™ Accepted" badge for listings
Co-authorship on IndieVerify™ Validation Study
Joint press release + case study
Early access to new screening signal features
Named landlord profile on mavvrixx.ai/partners
Portfolio monitoring at preferential rate
Annual IndieVerify™ Proptech Summit invite
Threshold: 5,000+ queries/month for 2 consecutive months · Activation: Automatic, account team notified
🏷️
"IndieVerify™ Accepted" Badge: Pioneer Partners receive a digital badge for their listings and property marketing — signaling to prospective tenants that their application process accepts gig and freelance income via Mavvrixx IndieVerify™. This differentiates Pioneer Partner listings in the competitive rental market and attracts the fastest-growing renter demographic: the independent worker.

Full Journey Summary

Stage What Happens Landlord Action Timeline
1 · DiscoveryLands on /landlords, sees value propRead, evaluate5 min
2 · Plan SelectionSelects Pilot plan, email verifiedSign up3 min
2B · Product ListingLists available units for Mavvrixx membersOptional5 min
3 · DashboardAPI key issued, sandbox readyCopy key<1 min
4 · API DocsSchema reviewed, code snippets testedIntegrate1–2 hrs
4B · MAPMCP integration for AI screening flowOptional2–4 hrs
5 · Sandbox250 free queries, all profiles testedTest1–3 hrs
6 · ConsentConsent flow implemented, testedBuild1–2 hrs
7 · Go-LiveProduction key, first live verificationClick "Go Live"<1 min
8 · DashboardMonitor volume, platform breakdown, bandsOngoingAlways on
9 · ScaleBatch, webhooks, automated screeningConfigure1 day
10 · PioneerBadge, co-marketing, validation studyAuto at 5k/moEarned
Start Your Free Pilot →
250 free queries. No MSA. No sales call required. Live in under a day.
Mavvrixx.ai
Mavvrixx.ai Inc. · Delaware C-Corp · EIN 32-0803111
Landlord Partner Journey Blueprint · v1.0 · May 2026
CONFIDENTIAL — noindex, nofollow