MCP server
IDX Broker MCP by usefulapi
Read IDX Broker leads, agents, listings and MLS data; create and update leads and notes.
- Runs
- Remotely
- Version
- 1.23.0
- Listing updated
- 4 days ago
About IDX Broker MCP by usefulapi
IDX Broker MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Install
Run in a terminal
claude mcp add --transport http idx-broker https://idx-broker.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://idx-broker.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"idx-broker": {
"url": "https://idx-broker.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"idx-broker": {
"type": "http",
"url": "https://idx-broker.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"idx-broker": {
"serverUrl": "https://idx-broker.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"idx-broker": {
"type": "http",
"url": "https://idx-broker.usefulapi.io/mcp"
}
}
}Tools this server provides (27)
Read directly from the server.
- idx_get_account_info
- The IDX Broker client account this access key belongs to: company and contact details and account settings (access keys and passwords are never returned). The reply also shows how many of the key's hourly API accesses are used. GET /clients/accountinfo.
- idx_get_account_type
- The IDX Broker plan of the account (Lite or Platinum). It sets the hourly API limit: 300 accesses per key on Lite, 500 on Platinum. GET /clients/accounttype.
- idx_list_agents
- Agents on a multi-user IDX Broker account (id, name, office, contact details, category, language, login dates). Filter by one field or by a time window. GET /clients/agents.
- idx_list_offices
- Offices on a multi-user IDX Broker account. Filter by one field or by a time window. GET /clients/offices.
- idx_list_leads
- List the account's leads (website registrants) with contact details, status, agent owner, and last viewed listings and searches. A reply holds up to 500 leads; pass offset to page on and look for pagination information in the reply. Filter by a time window on signup, edit, login or activity date. Uses one of the key's hourly API accesses. GET /leads/lead.
- idx_get_lead
- One lead by id with its details, last 5 viewed listings and searches, and the total number of listings viewed. GET /leads/lead/{leadID}.
- idx_list_lead_notes
- Notes on a lead, or one note when note_id is given. GET /leads/note/{leadID}[/{noteID}].
- idx_list_lead_searches
- Saved property searches of a lead (or one search when search_id is given), with the results URL of each. GET /leads/search/{leadID}[/{searchID}].
- idx_list_lead_saved_properties
- Properties a lead saved (or one when property_id is given). GET /leads/property/{leadID}[/{propertyID}].
- idx_get_lead_traffic
- Website traffic history of one lead: date, page, referrer and IP of each visit (at most 5,000 rows per request; use interval/offset/limit to narrow it). GET /leads/leadtraffic/{leadID}.
- idx_list_featured_listings
- The account's featured (active) listings with address, price, status, photos and agent. Only the account's own listings are returned, never general MLS data. GET /clients/featured.
- idx_list_sold_pending_listings
- The account's sold and pending listings, that is those removed from the MLS feed. GET /clients/soldpending.
- idx_list_off_market_listings
- The account's off-market listings. GET /clients/offmarket.
- idx_list_supplemental_listings
- The account's supplemental (non-MLS) listings with a basic set of fields. GET /clients/supplemental.
- idx_list_saved_links
- Saved links (pre-built property search pages) of the account with id, name and URL. GET /clients/savedlinks.
- idx_get_saved_link_count
- The total number of properties a saved link currently matches. GET /clients/savedlinks/{savedLinkID}/count.
- idx_list_widgets
- The JavaScript widgets on the account with id, name, URL and options. GET /clients/widgets.
- idx_get_widget
- One JavaScript widget with its settings. GET /clients/widgets/{id}.
- idx_list_system_links
- The system pages of the account's site (search, featured, contact...) with name, id and URL, which can be linked to directly. GET /clients/systemlinks.
- idx_list_approved_mls
- The MLSs approved for display on the account, with their IDX ids (such as a001) and names. Use the id in the other MLS tools. GET /mls/approvedmls.
- idx_get_mls_age
- When an MLS feed was last downloaded and processed and when its images were last gathered (UTC). GET /mls/age/{idxID}.
- idx_list_mls_property_types
- Property types of an MLS with the IDX type id, the MLS name, the parent type and subtypes. GET /mls/propertytypes/{idxID}.
- idx_list_mls_search_fields
- The fields of an MLS that can be searched under MLS rules: field name, display name and the property types they belong to. GET /mls/searchfields/{idxID}.
- idx_list_mls_locations
- Cities, counties or postal codes present in an MLS's data, with ids and a count of occurrences. Filter fields: cities = cityID, cityName, stateAbrv, mlsPtID; counties = countyID, countyName, stateAbrv, mlsPtID; postalcodes = id, stateAbrv, mlsPtID. GET /mls/{cities|counties|postalcodes}/{idxID}.
- idx_create_lead
- WRITE: creates a new lead in the IDX Broker account (and may trigger the account's own lead notifications). Needs a correctly formatted email with a valid MX record; IDX rejects bad addresses with a server error. Extra fields go in `fields` by their IDX name, as seen on a lead returned by idx_get_lead. Returns the new lead id. PUT /leads/lead.
- idx_add_lead_note
- WRITE: adds a note to a lead (visible to the account's agents). Returns the new note id. PUT /leads/note/{leadID}.
- idx_update_lead
- WRITE: changes fields of an existing lead; the given values replace the stored ones. Only pass what must change. Field names are the IDX lead field names as seen on a lead returned by idx_get_lead (for example firstName, lastName, email, phone, status). POST /leads/lead/{leadID}.
IDX Broker MCP by usefulapi FAQ
How do I add IDX Broker MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http idx-broker https://idx-broker.usefulapi.io/mcp