MLS Grid

Enable your AI agent to search MLS listings in real-time, helping website visitors find properties that match their criteria through natural conversation.

6 min read

Updated May 2026

Overview

MLS Grid brings your board's live listings into ChatSpark. Visitors describe what they're looking for, your AI agent searches and responds in the same conversation. MLS Grid uses the RESO Web API standard, so field names and search behavior are consistent across all participating boards. Connect your access token and you are live.

MLS Grid Account Required

This integration requires an active MLS Grid account with a long-term access token. Tokens are generated from the MLS Grid dashboard and do not expire unless rotated manually.

Prerequisites

Before setting up the MLS Grid integration, you'll need:

An active MLS Grid account with API access approved by your MLS board
A long-term Bearer access token from the MLS Grid dashboard
Your Originating System Name (your MLS board identifier, e.g. MIBOR)
Your website URL
Your listing URL path (the URL structure for listing detail pages on your site)

Setup Instructions

Step 1: Generate Your Access Token

Log in to your MLS Grid dashboard at mlsgrid.com
Navigate to API Keys or Access Tokens
Create a new long-term token and copy it. Treat this token like a password.

Step 2: Find Your Originating System Name

The Originating System Name identifies your MLS board in the MLS Grid dataset. Common examples include MIBOR for Metropolitan Indianapolis Board of Realtors or GAMLS for Georgia MLS. You can find this value in your MLS Grid account documentation or by contacting MLS Grid support.

Step 3: Enable in ChatSpark

In ChatSpark, go to AI Actions
Find MLS Grid in the Library and click Enable
Select the AI Agent(s) that should have access
Enter your Access Token and Originating System Name
Enter your Website URL and Listing URL Path
Click Test in Sandbox & Save

Originating System Name is Required

The Originating System Name scopes all searches to your specific MLS board. Without it, searches may return results from unrelated boards or fail entirely. Make sure the value matches exactly what MLS Grid uses for your board.

Configuration Fields

Field	Required	Description
Access Token	Yes	Your long-term Bearer token from the MLS Grid dashboard
Originating System Name	Yes	Your MLS board identifier as it appears in MLS Grid. Example: `MIBOR`, `GAMLS`
Website URL	Yes	Your website base URL. Example: `https://myrealtorsite.com`
Listing URL Path	Yes	Path appended to your Website URL for each listing link. Use `{mls_id}` and `{address}` as variables. Example: `/listing/{mls_id}/`

Search Capabilities

MLS Grid is a replication feed, not a live search API. Listings are returned from your board and scoped to your Originating System Name. The AI agent can filter by listing status and property type. Filtering by city, price, bedroom count, or square footage is not available through the MLS Grid API.

Status: Active, Pending, and other MLS statuses
Property type: Residential, condo, multifamily, and more
Specific listing: Look up a listing by its MLS ID

Example Queries

“Show me active listings from my MLS”
“Find condos in my feed”
“Show me pending listings”
“Look up MLS listing 123456”

Each result displays as a property card with a photo, price, address, beds/baths/sqft, and a link to the full listing.

Testing Your Integration

Open your AI Agent widget and ask: “Show me active listings from my MLS.” You should see listings from your board returned. If you see a connection error, verify your Originating System Name is correct and your access token has not been rotated.

Adding Ask AI Buttons to Listings

Add a button to any listing page and turn property views into conversations. When a visitor clicks, ChatSpark opens with that address pre-filled, your AI agent pulls the listing details from MLS Grid, and can capture their contact details as the conversation continues.

Add the cs-trigger-agent class and a data-triggerattribute to any HTML element on your listing pages:

<button class="cs-trigger-agent" data-trigger="Tell me about 456 Birch Lane, Indianapolis, IN 46202">
  Ask AI
</button>

Use the full street address as it appears in your MLS data. See AI Agent Triggers for full setup options.

Troubleshooting

Invalid token error

If the token fails during testing:

Token rotated: Generate a new token in the MLS Grid dashboard and update ChatSpark
Pasted with extra spaces: Make sure no whitespace was added when copying the token
Account suspended: Confirm your MLS Grid account is in good standing

No results returned

If searches return no results:

Verify the Originating System Name matches exactly what MLS Grid has on file for your board
Check that the searched city or area is covered by your MLS board
Try a broader search with fewer filters

Listing links are not working

Make sure both your Website URL and Listing URL Path are set in the AI Action configuration. The Listing URL Path must include the {mls_id} variable to generate valid links.

Results from the wrong board

If you see listings from a board other than yours, the Originating System Name may be blank or incorrect. Update it in the AI Action configuration to scope results correctly.

Need Help?

For MLS Grid account or API access issues, contact MLS Grid support. For ChatSpark integration issues, reach out to our support team.

Linear

Freshdesk