MCP Server

Connect Grok, Claude, or ChatGPT to your Panda IDX account with the Model Context Protocol (MCP). Once connected, the assistant can search listings, manage contacts, work your calendar, and share properties — just by asking.

MCP URL: https://api.pandaidx.com/mcp

The public page for this guide is /docs/api/mcp-server.

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants securely connect to your tools and data. Instead of copy-pasting, the assistant queries your Panda IDX account in real time: listings, contacts, calendar, collections, saved searches, analytics, and email.

You authorize once. You can disconnect anytime from Dashboard → Apps.

Connect with Grok (Cursor)

Grok in Cursor already connects to Panda IDX as a custom MCP connector. No API key to paste.

Open Cursor Settings and add a custom MCP connector (or use the Panda IDX connector if it is already listed).
Set the server URL to https://api.pandaidx.com/mcp.
Name it Panda IDX.
Authorize on the Panda IDX consent screen (login at login.pandaidx.com).
Start asking about your listings, contacts, and calendar.

Connect with Claude.ai

Add Panda IDX as a connector in Claude.ai. No code or API keys — OAuth handles it.

Go to Settings → Connectors in Claude.ai
Click Add Connector
Paste https://api.pandaidx.com/mcp
Authorize on the Panda IDX consent screen
Ask Claude about your properties, contacts, calendar, or site traffic

Claude also has a Connectors Directory. You can add Panda IDX manually today with the URL above.

Connect with Claude Code (CLI)

Add the following to your Claude Code MCP settings (~/.claude/settings.json):

{
  "mcpServers": {
    "panda-idx": {
      "type": "url",
      "url": "https://api.pandaidx.com/mcp"
    }
  }
}

Or:

claude mcp add panda-idx --type url --url "https://api.pandaidx.com/mcp"

Claude prompts you to authorize on first use.

Connect with ChatGPT

Add Panda IDX as a custom MCP connector in ChatGPT (paid plans that support custom connectors / Developer Mode).

Open ChatGPT Settings → Connectors
Enable Developer Mode if you need custom connectors
Click Add custom connector
Name: Panda IDX
URL: https://api.pandaidx.com/mcp
Authentication: OAuth
Authorize on the Panda IDX consent screen

The ChatGPT apps / plugins store is a separate review path. You can connect with the URL today.

Available Tools

Once connected, the assistant has these tools. You do not need to call them by name — ask naturally. There are 26 tools.

Tool	Description
`search_listings`	Search MLS listings with filters: city, price, beds, baths, property type, amenities, waterfront, pool, and more. Returns public website links.
`get_listing`	Full details and photos for one MLS number.
`get_listing_changes`	Price and status changes for listings since a date.
`create_offmarket_property`	Create an off-market / custom property. Confirm type, address, and price before the assistant calls this.
`list_contacts`	List and search CRM contacts by name, email, stage, or tag.
`get_contact`	One contact, optionally with notes, collections, and saved searches.
`create_contact`	Create a CRM contact. Confirm name and email first.
`get_contact_activity`	Activity timeline: emails, calls, property views, form submissions.
`list_calendar_events`	CRM events in a date range.
`create_calendar_event`	Create an event. Syncs to the connected Google Calendar when that is set up.
`update_calendar_event`	Update an event.
`delete_calendar_event`	Remove an event (and its Google Calendar copy when configured).
`list_property_collections`	Collections for you or a CRM contact.
`create_property_collection`	Create a collection, optionally with MLS IDs.
`update_property_collection`	Rename a collection.
`add_listing_to_collection`	Add an MLS listing to a collection.
`remove_listing_from_collection`	Remove an MLS listing from a collection.
`delete_property_collection`	Delete a collection.
`list_saved_searches`	Saved searches for you or a CRM contact.
`create_saved_search`	Create a saved search from filters. Optional email updates: daily, weekly, or never.
`update_saved_search`	Update title, filters, or email frequency.
`delete_saved_search`	Delete a saved search.
`send_contact_message`	Send a freeform email to one CRM contact. Confirm the contact and the message first.
`send_property_resource_email`	Email a listing, collection, or saved search to a CRM contact. Accepted for delivery is not the same as delivered.
`get_analytics`	Website visitors, page views, conversions, traffic sources, UTM, and geography.
`get_me`	Your Panda IDX user, application, subscription status, and granted scopes.

Example Prompts

Listings

"Search for waterfront condos in Miami Beach between $800K and $2M with at least 2 bedrooms"

"Show me the details and photos for listing A11567890"

"What price changes happened this week on listings A11234567 and A11234568?"

Contacts

"Show me my most recent contacts"

"Add a contact: Maria Lopez, email maria@example.com"

"Find contacts tagged as 'investor'"

"What activity does contact John Smith have in the last 30 days?"

Calendar

"Schedule a showing Friday at 3pm"

Collections and saved searches

"Create a Brickell collection"

"Create a weekly Coral Gables search"

Email

"Email that collection to the contact"

Analytics

"How are my website visits doing this month?"

"Show me traffic sources and top pages for the last 90 days"

Scopes & Permissions

When you authorize, the assistant requests access to these 8 scopes:

Scope	Access
`profile`	Your account, application, and granted scopes
`listings`	Search and view MLS listings, details, and price changes. Create off-market properties when that tool is used.
`contacts`	Read and create CRM contacts, notes, and activity
`analytics`	Website analytics, traffic, and conversions
`calendar`	List, create, update, and delete CRM calendar events
`collections`	List, create, update, and delete property collections
`saved_searches`	List, create, update, and delete saved searches
`email`	Send email to a CRM contact (freeform or a listing / collection / saved search)

Write, delete, and email tools should be confirmed before the assistant runs them.

Manage Access

After you authorize, the connection appears in Dashboard → Apps:

Granted scopes
Created date
Disconnect at any time to revoke all access

How It Works

The MCP Server uses OAuth 2.1. Never paste an API key.

Discovery — the assistant finds Panda OAuth endpoints
Registration — the assistant registers as an OAuth client
Authorization — you approve on the Panda IDX consent screen (login.pandaidx.com)
Token — the assistant receives a Bearer token (PKCE)
Connected — every MCP request uses that token until you disconnect

Requirements

Panda IDX: an active Panda IDX subscription.
Grok / Cursor: a Cursor account that can add custom MCP connectors.
Claude: Claude Pro, Team, or Enterprise for connectors. Claude Code works from the CLI settings above.
ChatGPT: a ChatGPT plan that allows custom MCP connectors / Developer Mode.