HDPhotoHub MCP by usefulapi
Manage HDPhotoHub sites, clients, orders and media for real estate photography.
使うべきか
品質と安全性
検出事項(2)
- LOWhdphotohub_list_user_transactions 内
- LOWhdphotohub_set_site_media_order 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"hdphotohub": {
"url": "https://hdphotohub.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://hdphotohub.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール(20)
🟢hdphotohub_get_brand
Get the business (brand) the API key belongs to: id and name. API: GET /brand.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hdphotohub_list_users(email, name)
List clients and team members, optionally filtered by email or name. API: GET /users.
入力スキーマ
{
"type": "object",
"properties": {
"email": {
"description": "Filter by email address.",
"type": "string"
},
"name": {
"description": "Filter by name.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hdphotohub_get_user(uid, email)
Get one user by id or email. Pass uid or email. API: GET /user.
入力スキーマ
{
"type": "object",
"properties": {
"uid": {
"description": "User id (from hdphotohub_list_users).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"email": {
"description": "User email address.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hdphotohub_list_user_transactions(uid, datefrom, dateto)
List the transactions of a user, optionally within a date range. API: GET /user/transactions.
入力スキーマ
{
"type": "object",
"properties": {
"uid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "User id."
},
"datefrom": {
"description": "Include transactions on and after this date (yyyy-mm-dd).",
"type": "string"
},
"dateto": {
"description": "Include transactions on and before this date (yyyy-mm-dd).",
"type": "string"
}
},
"required": [
"uid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hdphotohub_list_sites(uid, email, address)
List property sites, filtered by user id, user email or an address search string. API: GET /sites.
入力スキーマ
{
"type": "object",
"properties": {
"uid": {
"description": "Only sites of this user id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"email": {
"description": "Only sites of the user with this email.",
"type": "string"
},
"address": {
"description": "Address search string.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hdphotohub_get_site(sid)
Get one property site with its status, purchase state, users and all media items (download URL, type, order). API: GET /site.
入力スキーマ
{
"type": "object",
"properties": {
"sid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Site id (from hdphotohub_list_sites)."
}
},
"required": [
"sid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hdphotohub_get_media(mid)
Get one media item (photo, video, floor plan) by id. API: GET /media.
入力スキーマ
{
"type": "object",
"properties": {
"mid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Media id (from hdphotohub_get_site)."
}
},
"required": [
"mid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hdphotohub_list_orders(sid, uid)
List orders, optionally for one site or one user. Orders carry totals, balance due, tasks and payments. API: GET /orders.
入力スキーマ
{
"type": "object",
"properties": {
"sid": {
"description": "Only orders of this site id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"uid": {
"description": "Only orders of this user id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hdphotohub_get_order(oid)
Get one order by id with tasks, taxes, payments and invoice URL. API: GET /order.
入力スキーマ
{
"type": "object",
"properties": {
"oid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Order id (from hdphotohub_list_orders)."
}
},
"required": [
"oid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hdphotohub_list_groups(name)
List groups (brokerages and teams), optionally filtered by name. API: GET /groups.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"description": "Filter by group name.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hdphotohub_get_group(gid)
Get one group by id. API: GET /group.
入力スキーマ
{
"type": "object",
"properties": {
"gid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Group id (from hdphotohub_list_groups)."
}
},
"required": [
"gid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hdphotohub_list_webhooks
List the configured webhooks. API: GET /webhooks.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hdphotohub_get_webhook(wid)
Get one webhook by id. API: GET /webhook.
入力スキーマ
{
"type": "object",
"properties": {
"wid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Webhook id (from hdphotohub_list_webhooks)."
}
},
"required": [
"wid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢hdphotohub_list_webhook_events
List the available webhook event types and payload options. API: GET /webhook/events.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴hdphotohub_create_site(uid, uid2, address, address2, city, ...)
WRITE: create a new property site for a user. Not idempotent: a repeat call creates a second site. API: POST /site.
入力スキーマ
{
"type": "object",
"properties": {
"uid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Owner user id."
},
"uid2": {
"description": "Co-user id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"address": {
"description": "Street address.",
"type": "string"
},
"address2": {
"description": "Address line 2 (unit, suite).",
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"zip": {
"type": "string"
},
"banner": {
"description": "Banner text shown on the property site (for example 'Just Listed').",
"type": "string"
},
"bannerexpiration": {
"description": "Banner expiration date.",
"type": "string"
},
"mls": {
"description": "MLS number.",
"type": "string"
},
"price": {
"description": "List price.",
"type": "string"
},
"beds": {
"type": "string"
},
"baths": {
"type": "string"
},
"garage": {
"type": "string"
},
"sqft": {
"description": "Living area in square feet.",
"type": "string"
},
"sqm": {
"description": "Living area in square meters.",
"type": "string"
},
"yearbuilt": {
"type": "string"
},
"lotsize": {
"type": "string"
},
"description": {
"description": "Property description.",
"type": "string"
}
},
"required": [
"uid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡hdphotohub_update_site(sid, uid, uid2, address, address2, ...)
WRITE: update fields of an existing property site. Only the fields you pass change. API: PUT /site.
入力スキーマ
{
"type": "object",
"properties": {
"sid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Site id."
},
"uid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"uid2": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"address": {
"description": "Street address.",
"type": "string"
},
"address2": {
"description": "Address line 2 (unit, suite).",
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"zip": {
"type": "string"
},
"banner": {
"description": "Banner text shown on the property site (for example 'Just Listed').",
"type": "string"
},
"bannerexpiration": {
"description": "Banner expiration date.",
"type": "string"
},
"mls": {
"description": "MLS number.",
"type": "string"
},
"price": {
"description": "List price.",
"type": "string"
},
"beds": {
"type": "string"
},
"baths": {
"type": "string"
},
"garage": {
"type": "string"
},
"sqft": {
"description": "Living area in square feet.",
"type": "string"
},
"sqm": {
"description": "Living area in square meters.",
"type": "string"
},
"yearbuilt": {
"type": "string"
},
"lotsize": {
"type": "string"
},
"description": {
"description": "Property description.",
"type": "string"
}
},
"required": [
"sid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡hdphotohub_set_site_status(sid, status)
WRITE: set a site to active, inactive or archived. This does not purchase the site. API: PUT /site/status.
入力スキーマ
{
"type": "object",
"properties": {
"sid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Site id."
},
"status": {
"type": "string",
"enum": [
"active",
"inactive",
"archived"
]
}
},
"required": [
"sid",
"status"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡hdphotohub_set_site_media_order(sid, mid)
WRITE: set the sort order of the media of a site. Pass media ids in the wanted order. API: PUT /site/mediaorder.
入力スキーマ
{
"type": "object",
"properties": {
"sid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Site id."
},
"mid": {
"minItems": 1,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"description": "Media ids in the wanted order."
}
},
"required": [
"sid",
"mid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡hdphotohub_update_media(mid, name, description, type, hidden, ...)
WRITE: update name, description, type, visibility, highlight or branding of one media item. API: PUT /media.
入力スキーマ
{
"type": "object",
"properties": {
"mid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Media id."
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"still",
"pan",
"pan360",
"sphere",
"video",
"embed",
"floorplan"
]
},
"hidden": {
"type": "boolean"
},
"highlight": {
"type": "boolean"
},
"branding": {
"type": "string",
"enum": [
"all",
"both",
"branded",
"download",
"none",
"unbranded"
]
}
},
"required": [
"mid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡hdphotohub_upsert_user(uid, email, name, firstname, lastname, ...)
WRITE: create a user (no uid) or update one (uid or email of an existing user). API: PUT /user.
入力スキーマ
{
"type": "object",
"properties": {
"uid": {
"description": "Existing user id to update.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"email": {
"type": "string"
},
"name": {
"type": "string"
},
"firstname": {
"type": "string"
},
"lastname": {
"type": "string"
},
"title": {
"type": "string"
},
"phone": {
"type": "string"
},
"website": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"active",
"inactive",
"deleted"
]
},
"type": {
"type": "string",
"enum": [
"team-member",
"group-admin",
"client",
"assistant"
]
},
"gid": {
"description": "Group id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}コミュニティ
エビデンス