IDX Broker MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.19.5更新于 Nov 8, 2026

Read IDX Broker leads, agents, listings and MLS data; create and update leads and notes.

发布方自己的服务:Ably MCP by usefulapi

已验证Streamable HTTP可网页运行数据与分析商业与电商

概览

AI 生成的概览

面向 IDX Broker 账户的托管 MCP 服务器:读取线索、经纪人、房源和 MLS 数据,并可创建、更新线索和备注。

可以做什么
  • 列出并查看线索,包括其备注、已保存搜索、已保存房源和网站访问记录
  • 创建线索、更新线索字段、为线索添加备注
  • 列出账户下的经纪人和办事处,读取账户信息与套餐类型
  • 列出账户自有的精选、已售/待定、场外和补充房源,以及保存链接、小部件和系统链接
  • 查询已授权的 MLS、MLS 数据更新时间、房源类型、可搜索字段以及城市、县或邮编
  • 查看每月工具调用用量、提交功能请求、管理或取消付费订阅
适用场景
适合运营 IDX Broker 网站的房产经纪人和团队,希望助手回答关于线索、其浏览与搜索行为以及账户房源的问题,或在聊天客户端中新增和更新线索记录与备注。
运行要求
仅需远程端点,无需本地安装。将服务器 URL 添加为远程 MCP 服务器;服务器通过 OAuth 登录,登录页会要求填写 IDX Broker 凭据。不要在客户端配置中添加 Authorization 头或 API 密钥。超出免费月度调用额度后需要付费套餐。
安装前请注意
有三个写入工具会改动 IDX Broker 账户:创建线索、更新线索字段(新值会替换原值)以及添加对账户经纪人可见的备注;创建线索可能触发账户自身的线索通知。线索记录包含联系方式和访客 IP 地址。该服务器是代理你 IDX Broker 账户的第三方托管方。订阅工具可发起付费 Stripe 结账或取消 Pro;取消当期不退款。

安装

在 SourceWeft 中

  1. 打开 控制台中的 IDX Broker MCP by usefulapi,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Fidx-broker/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "idx-broker-by-usefulapi": {
      "type": "http",
      "url": "https://idx-broker.usefulapi.io/mcp"
    }
  }
}

README

IDX Broker MCP by usefulapi

Use IDX Broker from Claude, Cursor, or any MCP client — look up leads and what they viewed, searched and saved, agents and offices, your account's own featured, sold, off-market and supplemental listings, saved links, widgets and MLS metadata, and create or update leads and add lead notes (each write needs an explicit confirmation). Hosted, no local install: connect with an IDX Broker access key.

Live endpoint: https://idx-broker.usefulapi.io/mcp · Homepage: https://usefulapi.io/idx-broker

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://idx-broker.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http idx-broker https://idx-broker.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "idx-broker": {      "url": "https://idx-broker.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your IDX Broker credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/idx-broker/

Tools

ToolTypeWhat it does
idx_get_account_inforeadGet account info
idx_get_account_typereadGet account type
idx_list_agentsreadList agents
idx_list_officesreadList offices
idx_list_leadsreadList leads
idx_get_leadreadGet lead
idx_list_lead_notesreadList lead notes
idx_list_lead_searchesreadList lead saved searches
idx_list_lead_saved_propertiesreadList lead saved properties
idx_get_lead_trafficreadGet lead traffic
idx_list_featured_listingsreadList featured listings
idx_list_sold_pending_listingsreadList sold and pending listings
idx_list_off_market_listingsreadList off-market listings
idx_list_supplemental_listingsreadList supplemental listings
idx_list_saved_linksreadList saved links
idx_get_saved_link_countreadCount properties of a saved link
idx_list_widgetsreadList widgets
idx_get_widgetreadGet widget
idx_list_system_linksreadList system links
idx_list_approved_mlsreadList approved MLSs
idx_get_mls_agereadGet MLS data age
idx_list_mls_property_typesreadList MLS property types
idx_list_mls_search_fieldsreadList MLS search fields
idx_list_mls_locationsreadList MLS cities, counties or postal codes
idx_create_leadwriteCreate lead
idx_add_lead_notewriteAdd lead note
idx_update_leadwriteUpdate lead
idx_usage_statusmetaUsage status (free-tier meter)
idx_request_featuremetaRequest a missing feature
idx_upgrademetaUpgrade to Pro or Pro+
idx_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per account)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with idx_upgrade (it returns a Stripe Checkout link). Cancel any time with idx_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running idx_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by IDX Broker.

来源:servers/idx-broker/README.md,提交 4046075

工具

27

idx_get_account_info

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

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

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.

输入参数fieldsintervaldate_typefilter_fieldfilter_valuestart_datetime

idx_list_offices

List offices

Offices on a multi-user IDX Broker account. Filter by one field or by a time window. GET /clients/offices.

输入参数fieldsintervaldate_typefilter_fieldfilter_valuestart_datetime

idx_list_leads

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.

输入参数fieldsoffsetsort_byintervaldate_typestart_datetime

idx_get_lead

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}.

输入参数fieldslead_id必填

idx_list_lead_notes

List lead notes

Notes on a lead, or one note when note_id is given. GET /leads/note/{leadID}[/{noteID}].

输入参数fieldslead_id必填note_idintervaldate_typestart_datetime

idx_list_lead_searches

List lead saved 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}].

输入参数fieldslead_id必填intervaldate_typesearch_idstart_datetime

idx_list_lead_saved_properties

List lead saved properties

Properties a lead saved (or one when property_id is given). GET /leads/property/{leadID}[/{propertyID}].

输入参数fieldslead_id必填intervaldate_typeproperty_idstart_datetime

idx_get_lead_traffic

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}.

输入参数limitfieldsoffsetlead_id必填intervalstart_datetime

idx_list_sold_pending_listings

List sold and pending listings

The account's sold and pending listings, that is those removed from the MLS feed. GET /clients/soldpending.

输入参数limitfieldsoffsetintervaldate_typedisclaimersstart_datetime

idx_list_off_market_listings

List off-market listings

The account's off-market listings. GET /clients/offmarket.

输入参数limitfieldsoffsetintervaldate_typedisclaimersstart_datetime

idx_list_supplemental_listings

List supplemental listings

The account's supplemental (non-MLS) listings with a basic set of fields. GET /clients/supplemental.

输入参数limitfieldsoffsetintervaldate_typedisclaimersstart_datetime

idx_list_widgets

List widgets

The JavaScript widgets on the account with id, name, URL and options. GET /clients/widgets.

输入参数limitfieldsoffset

idx_get_widget

Get widget

One JavaScript widget with its settings. GET /clients/widgets/{id}.

输入参数fieldswidget_id必填

idx_list_approved_mls

List approved MLSs

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.

输入参数fields

idx_get_mls_age

Get MLS data age

When an MLS feed was last downloaded and processed and when its images were last gathered (UTC). GET /mls/age/{idxID}.

输入参数fieldsidx_id必填

idx_list_mls_property_types

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}.

输入参数fieldsidx_id必填filter_fieldfilter_value

idx_list_mls_search_fields

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}.

输入参数fieldsidx_id必填filter_fieldfilter_value

idx_list_mls_locations

List MLS cities, counties or postal codes

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}.

输入参数kind必填fieldsidx_id必填filter_fieldfilter_value

idx_create_lead

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.

输入参数email必填fieldslast_name必填first_name必填

idx_add_lead_note

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}.

输入参数note必填lead_id必填

idx_update_lead

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}.

输入参数fields必填lead_id必填

版本历史

16
  1. v1.19.4Nov 7, 2026
  2. v1.18.3Nov 5, 2026
  3. v1.18.2Nov 5, 2026
  4. v1.18.1Nov 4, 2026
  5. v1.18.0Nov 3, 2026
  6. v1.17.1Nov 3, 2026
  7. v1.16.0Nov 1, 2026
  8. v1.14.0Oct 31, 2026
  9. v1.13.0Oct 31, 2026
  10. v1.12.2Oct 30, 2026
  11. v1.12.0Oct 30, 2026
  12. v1.7.0Oct 26, 2026
  13. v1.4.3Oct 25, 2026
  14. v1.4.0Oct 25, 2026
  15. v1.3.0Oct 24, 2026
  16. v1.0.0Oct 23, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Usefulapi 集成