HDPhotoHub MCP by usefulapi

Manage HDPhotoHub sites, clients, orders and media for real estate photography.

使うべきか

品質と安全性

A
説明の品質
100%
スキーマの完全性
83%
命名の品質
78%
ポイズニングのリスク
100%
権限の一致
100%
プロトコルへの準拠
100%

検出事項(2)

  • LOWTool 'hdphotohub_list_user_transactions' name length outside 3-30 rangehdphotohub_list_user_transactions 内
  • LOWTool 'hdphotohub_set_site_media_order' name length outside 3-30 rangehdphotohub_set_site_media_order 内

ツール定義とプロトコルへの準拠に関する自動分析に基づいています。

コンテキストコスト

~2,887トークン数(ツール定義)
~1.1 KB一般的なレスポンスサイズ
注意への影響は大きい(128k コンテキストの 2.26%)

これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。

インストール

ワンクリックインストール

これを `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"
}

コミュニティ

このサーバーを評価する

エビデンス

最近の観測

検証済みバージョンは記録されていませんツール 20 件