MCP Server

The Panda IDX MCP Server allows you to connect Claude AI directly to your account. Once connected, Claude can search properties, manage contacts, and view analytics on your behalf using natural language.

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants like Claude securely connect to external data sources and tools. Instead of copy-pasting data, Claude can query your Panda IDX account directly.

Quick Start

Connect with Claude.ai

1. Go to Settings → Connectors in Claude.ai
2. Click "Add Connector"
3. Paste the MCP Server URL:

https://api.pandaidx.com/mcp

4. Claude will automatically open a Panda IDX authorization screen
5. Click "Authorize" to grant access
6. Done — Claude can now use your Panda IDX data

Connect with Claude Code (CLI)

Add the following to your Claude Code MCP settings:

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

Available Tools

Once connected, Claude has access to these tools:

Usage Examples

Once Claude is connected, just ask naturally:

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

"Show me the details for listing A11567890"

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

"Show me my most recent contacts"

"Find contacts tagged as 'investor'"

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

"How are my website visits doing this month?"

"Show me traffic sources for the last 90 days"

"What are my top pages by visitors?"

Authentication Flow

The MCP Server uses OAuth 2.1 with automatic setup. Here's what happens behind the scenes:

1. Discovery — Claude reads /.well-known/oauth-authorization-server to find OAuth endpoints
2. Registration — Claude registers itself as an OAuth client via Dynamic Client Registration (DCR)
3. Authorization — You see a Panda IDX consent screen and approve access
4. Token Exchange — Claude receives a Bearer token (with PKCE for security)
5. API Calls — Claude includes the token in all MCP requests

You don't need to configure any of this manually — it all happens automatically when you add the connector.

Scopes

When you authorize Claude, it requests access to these scopes:

You can revoke access at any time from your Dashboard → Apps page.

Managing Connected Apps

After authorizing Claude, it will appear in your dashboard under Apps:

• View which scopes Claude has access to
• See when it was connected
• Disconnect at any time to revoke all access

When you disconnect, Claude immediately loses access to your data.

Technical Details

Server URL

https://api.pandaidx.com/mcp

Transport

The MCP Server uses Streamable HTTP transport (the modern MCP standard). It supports:

• POST — Client sends MCP requests
• GET — Resume after connection break
• DELETE — Terminate session

OAuth Endpoints

Rate Limits

MCP requests follow the same rate limits as the REST API: 1,000 requests per hour per token.

Requirements

• An active Panda IDX subscription (Starter, Pro, or Enterprise)
• A Claude Pro, Team, or Enterprise account (for Claude.ai connectors)

Troubleshooting

"Subscription Required" error

You need an active Panda IDX subscription to authorize third-party apps. Go to app.pandaidx.com to manage your subscription.

Claude can't find listings

Make sure your account has MLS data feeds assigned. Contact support if you don't see any listings.

Revoking access

Go to Dashboard → Apps, find Claude in the list, and click Disconnect. This immediately revokes all tokens.