Resi MCP by usefulapi

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

Read properties, units, leads and sync logs; update unit rent and availability in Resi.

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

已验证Streamable HTTP可网页运行效率与工作流商业与电商

概览

AI 生成的概览

面向 Resi 物业管理的远程 MCP 服务器:让助手读取房源、单元、线索和同步日志,并更新单元租金与可租状态。

可以做什么
  • 识别当前登录用户及令牌绑定的 Resi 账户
  • 列出并读取物业、楼栋、户型与单元,含配套设施、费用明细和同步字段
  • 更新单元的可用状态、可租日期、租金、押金、优惠或描述
  • 列出配套设施、费用、评价与媒体(照片、户型图、PDF、视频和虚拟看房)
  • 列出线索与线索来源,并读取单条线索的联系方式和看房预约
  • 列出 PMS 与 CRM 连接及其同步日志,并列出账户用户
适用场景
适合租赁和物业管理人员的日常使用:用自然语言查询可租房源、租金、线索或失败的 PMS 同步,或在不打开 Resi 的情况下小幅调整单元价格和可租状态。
运行要求
远程 streamable HTTP 端点,无需本地安装。只需填写 URL,通过 OAuth 使用 Resi 账号登录;首次连接时需提供 Resi 账户设置中的 API 令牌,服务器按用户保存。免费方案每月 50 次工具调用;付费方案按用户计费。
安装前请注意
更新工具会写入线上 Resi 站点,客户可见,且 synced_fields 中列出的字段可能被下一次 PMS 同步覆盖。线索数据含个人数据,仅应用于客户自身的租赁业务。付费方案会产生费用并通过支付链接结算;升级会立即收取差价,取消后当期不退款。不要在客户端配置中填写 API 密钥或 Authorization 头。

安装

在 SourceWeft 中

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

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

交给智能体安装

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

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

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

其他 MCP 客户端

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

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

README

Resi MCP by usefulapi

Use your Resi account from Claude, Cursor, or any MCP client. Read properties, units, leads and sync logs, and update unit rent and availability. Hosted, no local install: connect with your own credentials.

Live endpoint: https://resi.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://resi.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http resi https://resi.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": {    "resi": {      "url": "https://resi.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 Resi credentials.

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

On first connect you provide a Resi API token (Resi → Account Settings → API Tokens). The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
resi_get_current_userreadGet current user and accounts
resi_get_token_accountreadGet the account this token is pinned to
resi_list_propertiesreadList properties
resi_get_propertyreadGet property
resi_list_buildingsreadList buildings
resi_list_floor_plansreadList floor plans
resi_list_unitsreadList units
resi_get_unitreadGet unit
resi_update_unitwriteUpdate unit availability or price
resi_list_amenitiesreadList amenities
resi_list_feesreadList fees
resi_list_reviewsreadList reviews
resi_list_leadsreadList leads
resi_get_leadreadGet lead
resi_list_lead_sourcesreadList lead sources
resi_list_mediareadList media
resi_list_connectionsreadList connections
resi_list_connection_logsreadList connection logs
resi_list_usersreadList users
resi_usage_statusmetaUsage status (free-tier meter)
resi_request_featuremetaRequest a missing feature
resi_upgrademetaUpgrade to Pro or Pro+
resi_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 user)$9/mo or $90/yr (2 months free)10,000 tool calls / month
Pro+ (per user)$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run resi_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with resi_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with resi_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

来源:servers/resi/README.md,提交 4f71a0d

工具

19

resi_get_current_user

Get current user and accounts

Return the Resi user who owns this token and every account that user belongs to. The token itself is pinned to one account: use resi_get_token_account to see which one. Resi API: GET /api/v2/me.

无需输入参数。

resi_get_token_account

Get the account this token is pinned to

Return the id of the Resi account this token runs against (the X-Resi-Account-Id response header) and the property count there. Use it to confirm which client a token serves. Resi API: GET /api/v2/properties?per_page=1.

无需输入参数。

resi_list_properties

List properties

List the properties (communities) in the token's account, with address, contact details and status. Start here to find a property id. Resi API: GET /api/v2/properties. Properties cannot be sorted.

输入参数pagegroupper_page

resi_get_property

Get property

Return one property with its address, settings and contact details. Resi API: GET /api/v2/properties/{property}.

输入参数property_id必填

resi_list_buildings

List buildings

List the buildings of a property (filter by property_id). Resi API: GET /api/v2/buildings.

输入参数namepagegroupper_pageproperty_id

resi_list_floor_plans

List floor plans

List floor plans with bedroom range, size and rent range. Filter by property_id, name or bedroom count. Resi API: GET /api/v2/floor-plans.

输入参数namepagegroupper_pageis_enabledproperty_idmax_bedroomsmin_bedrooms

resi_list_units

List units

List apartment units with rent, availability and bedrooms. Use is_available=true and a rent range to answer 'what can I rent'. Filters run on Resi, which saves quota. Resi API: GET /api/v2/units.

输入参数pagesortgroupnumbermax_rentmin_rentper_pageis_hiddenbuilding_idproperty_idavailable_byis_available另有 4 个

resi_get_unit

Get unit

Return one unit with its property, building, floor plan, amenities, fee breakdown and synced_fields (fields a PMS connection overwrites). Resi API: GET /api/v2/units/{unit}.

输入参数unit_id必填

resi_update_unit

Update unit availability or price

WRITE: change one unit's availability, availability date, rent, deposit, specials or description. Changes go live on the client's Resi sites. A field listed in the unit's synced_fields is overwritten by the next PMS sync. Pass only the fields to change. min_rent and max_rent are total monthly leasing prices (base rent plus mandatory fees). Resi API: PATCH /api/v2/units/{unit}. Needs a full-access token.

输入参数depositunit_id必填max_rentmin_rentspecialsis_hiddendescriptionavailable_atis_available

resi_list_amenities

List amenities

List amenities (pool, gym, pet policy items and so on) with their codes and marketing flags. Resi API: GET /api/v2/amenities.

输入参数namepageper_pageproperty_id

resi_list_fees

List fees

List fees (application, admin, pet, utility and so on) with their class, currency and status. Resi API: GET /api/v2/fees.

输入参数namepageper_pageproperty_id

resi_list_reviews

List reviews

List resident and public reviews of a property, with rating, source and publish state. Resi API: GET /api/v2/reviews.

输入参数pageper_pageproperty_idis_published

resi_list_leads

List leads

List leads (prospect contact forms and tour bookings), newest first. Poll for new leads with created_after set to the newest created_at you hold. Contains personal data: use only for the client's own leasing work. Resi API: GET /api/v2/leads.

输入参数pageemailform_idper_pageproperty_idconnection_idcreated_aftercreated_beforelead_source_id

resi_get_lead

Get lead

Return one lead with its contact fields, tour booking, lead source and full submission. Resi API: GET /api/v2/leads/{lead}.

输入参数lead_id必填

resi_list_lead_sources

List lead sources

List lead sources (where a lead came from, e.g. Zillow or the website) for attribution. Resi API: GET /api/v2/lead-sources.

输入参数namepageper_pageproperty_id

resi_list_media

List media

List photos, floor plans, PDFs (kind=file) or videos and virtual tours (kind=embed). One kind per call. Filter by the parent record. Resi API: GET /api/v2/media.

输入参数tagkind必填pageper_pageattachable_idattachable_type

resi_list_connections

List connections

List PMS and CRM connections (the syncs that feed inventory and leads), with type, category and enabled state. Resi API: GET /api/v2/connections.

输入参数namepageenabledper_pageproperty_id

resi_list_connection_logs

List connection logs

List the sync and import runs of one connection, newest first, with status and error message. Use it to find why a sync failed. Logs are kept 14 days. Resi API: GET /api/v2/connections/{connection}/logs.

输入参数pagestatusper_pageevent_typeproperty_idconnection_id必填created_after

resi_list_users

List users

List the users of the account (staff and service users) with their role. Resi API: GET /api/v2/users.

输入参数namepageroleemailper_page

版本历史

1
  1. v1.0.0最新Nov 19, 2026

评分

已满足适用检查项的 100%

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

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

其他 Usefulapi 集成