MLS Onboarding

The self-service onboarding wizard takes your MLS from zero to a governed data feed in four steps. No engineering required.

[i]Free for every MLS

Conduit is free for MLSs. You earn revenue from vendor queries against your data. There are no setup fees, monthly costs, or per-query charges for the MLS.

Wizard overview

MLS Profile

Enter your MLS name, coverage area, and subscriber count. This creates your MLS profile and sets your organization type.

Data Feed Configuration

Connect your upstream RESO data feed. Provide the URL, authentication type, and credentials. Conduit tests the connection before proceeding.

Governance Policy

Choose a policy template (Standard, Restricted, or Open) and set your revenue share percentage. This controls how vendor queries are filtered and rate-limited.

Review & Deploy

Review your configuration and activate governance. Your MLS data feed is now live and ready to accept vendor access requests.

Step 1: MLS Profile

Provide basic information about your MLS:

Field	Required	Description
`mls_name`	Yes	Display name of your MLS
`coverage_area`	Yes	Geographic coverage (e.g., "Greater Austin, TX")
`subscriber_count`	No	Number of MLS subscribers/members

This step also seeds the RESO field registry (60 fields across 7 categories) which is used for governance policy configuration.

Step 2: Data Feed Configuration

Connect your upstream RESO-compliant MCP server:

Field	Required	Description
`upstream_url`	Yes	URL of your RESO data feed MCP server
`auth_type`	No	Authentication type: `none`, `bearer`, or `api_key`
`auth_config`	No	Auth credentials (token or key). Stored encrypted.

This step can be skipped if you don't have a data feed ready yet. You can configure it later from the MLS cockpit.

Step 3: Governance Policy

Choose a policy template and set your revenue share:

Policy templates

Standard Access

Default for approved vendors. Moderate rate limits (60/min, 1K/hr, 10K/day). Agent emails masked, phone numbers hidden.

Restricted Access

For vendors with lower trust scores. Strict limits (20/min, 300/hr, 3K/day). Agent contact info hidden, financial data hidden.

Open Data

For trusted partners. High limits (120/min, 5K/hr, 50K/day). Phone numbers masked instead of hidden. Anti-training disabled.

Set your revenue share percentage (10-70%, default 40%). This is the portion of vendor subscription and overage revenue credited to your MLS. See Revenue & Payouts for details.

Step 4: Review & Deploy

Review your configuration and confirm. This marks onboarding as complete and redirects you to the MLS cockpit where you can:

-Review and approve vendor access requests
-Monitor query audit logs
-Track revenue and payouts
-Manage governance policies

Onboarding API

The onboarding wizard can also be driven programmatically:

bash

# Check current onboarding state
GET /api/onboard

# Submit a step
POST /api/onboard
{ "step": 1, "mls_name": "Austin MLS", "coverage_area": "Greater Austin, TX" }

POST /api/onboard
{ "step": 2, "upstream_url": "https://mls.example.com/reso/mcp", "auth_type": "bearer" }

POST /api/onboard
{ "step": 3, "template": "standard", "revenue_share_pct": 40 }

POST /api/onboard
{ "step": 4 }

Next: Policy Config →

←Billing & Usage Policy Config→