MCP MeasureMCP Measure

索引已观测

Famly MCP by usefulapi

Review Famly sites, staff, invoices and payments through its public API.

我该使用它吗

质量与安全性

A
描述质量
98%
模式完整度
82%
命名质量
80%
投毒风险
100%
权限匹配度
100%
协议合规性
100%

发现（1）

  • LOWTool 'famly_list_sites' description lacks action verb在 famly_list_sites 中

基于对工具定义和协议合规性的自动分析。

上下文开销

~3,222token 数（工具定义）
~1.5 KB典型响应大小
对注意力有显著影响（占 128k 上下文窗口的 2.52%）

这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。

安装

一键安装

将以下内容添加到你的 `claude_desktop_config.json` 文件中：

{
  "mcpServers": {
    "famly": {
      "url": "https://famly.usefulapi.io/mcp"
    }
  }
}

远程端点

https://famly.usefulapi.io/mcpstreamable-http

它能做什么

工具清单

工具（12）

🟢 只读🟡 写入🔴 删除⚪ 未知
🟢famly_list_sites(siteIds, organizationId)

Site IDs and titles accessible to this API token. Sites are currently not paginated by Famly. Uses the Famly Public API; results depend on token permissions.

输入模式

{
  "type": "object",
  "properties": {
    "siteIds": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
      }
    },
    "organizationId": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢famly_list_groups(siteSetIds)

Room/group IDs, titles, institution IDs and staffing ratios for the requested site sets. Uses the Famly Public API; results depend on token permissions.

输入模式

{
  "type": "object",
  "properties": {
    "siteSetIds": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
      }
    }
  },
  "required": [
    "siteSetIds"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢famly_list_employees(siteIds, employeeIds, includeFuture, includePast, pageSize, ...)

Staff directory and employment dates. No home address, birth date, gender, telephone or photographs. Continue using next, including after an empty page. Uses the Famly Public API; results depend on token permissions.

输入模式

{
  "type": "object",
  "properties": {
    "siteIds": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
      }
    },
    "employeeIds": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
      }
    },
    "includeFuture": {
      "default": false,
      "type": "boolean"
    },
    "includePast": {
      "default": false,
      "type": "boolean"
    },
    "pageSize": {
      "default": 100,
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "next": {
      "description": "Opaque next cursor from the previous page. Omit for the first page.",
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "pattern": "^[^\\x00-\\x1f\\x7f]+$"
    }
  },
  "required": [
    "siteIds"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢famly_list_invoices(siteIds, nextToken, createdDateRange, invoiceDateRange)

Invoice IDs, numbers, totals and dates, excluding line descriptions, child records and PDF links. One page per call. Uses the Famly Public API; results depend on token permissions.

输入模式

{
  "type": "object",
  "properties": {
    "siteIds": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
      }
    },
    "nextToken": {
      "description": "Opaque next cursor from the previous page. Omit for the first page.",
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "pattern": "^[^\\x00-\\x1f\\x7f]+$"
    },
    "createdDateRange": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string"
        },
        "to": {
          "type": "string"
        }
      },
      "required": [
        "from"
      ]
    },
    "invoiceDateRange": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string"
        },
        "to": {
          "type": "string"
        }
      },
      "required": [
        "from"
      ]
    }
  },
  "required": [
    "siteIds"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢famly_get_invoices(invoiceIds)

Invoice summaries for known invoice IDs: numbers, totals, dates and bill payer IDs. Uses the Famly Public API; results depend on token permissions.

输入模式

{
  "type": "object",
  "properties": {
    "invoiceIds": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
      }
    }
  },
  "required": [
    "invoiceIds"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢famly_list_payments(siteIds, nextToken, paymentDateRange, createdDateRange, pageSize, ...)

Payment amounts, dates, method, currency and transaction status. Excludes notes, bank details, child records and payment metadata. One page per call. Uses the Famly Public API; results depend on token permissions.

输入模式

{
  "type": "object",
  "properties": {
    "siteIds": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
      }
    },
    "nextToken": {
      "description": "Opaque next cursor from the previous page. Omit for the first page.",
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "pattern": "^[^\\x00-\\x1f\\x7f]+$"
    },
    "paymentDateRange": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string"
        },
        "to": {
          "type": "string"
        }
      },
      "required": [
        "from"
      ]
    },
    "createdDateRange": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string"
        },
        "to": {
          "type": "string"
        }
      },
      "required": [
        "from"
      ]
    },
    "pageSize": {
      "default": 100,
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "includeDeleted": {
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "siteIds"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢famly_list_purchases(siteIds, nextToken, purchaseDateRange, pageSize)

Ad-hoc purchase IDs, status, totals and invoice IDs, excluding child records and booking details. With a date range request one site at a time. One page per call. Uses the Famly Public API; results depend on token permissions.

输入模式

{
  "type": "object",
  "properties": {
    "siteIds": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
      }
    },
    "nextToken": {
      "description": "Opaque next cursor from the previous page. Omit for the first page.",
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "pattern": "^[^\\x00-\\x1f\\x7f]+$"
    },
    "purchaseDateRange": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string"
        },
        "to": {
          "type": "string"
        }
      },
      "required": [
        "from"
      ]
    },
    "pageSize": {
      "default": 50,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "siteIds"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢famly_list_account_codes(siteIds, includeDeleted)

Accounting code IDs, titles and references for the requested sites. Uses the Famly Public API; results depend on token permissions.

输入模式

{
  "type": "object",
  "properties": {
    "siteIds": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
      }
    },
    "includeDeleted": {
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "siteIds"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢famly_list_bill_payers(siteIds, nextToken, includeDeleted)

Billing identities, names, balances and billing references. Excludes bank accounts, social security numbers, contact details, notes and child records. One page per call. Uses the Famly Public API; results depend on token permissions.

输入模式

{
  "type": "object",
  "properties": {
    "siteIds": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
      }
    },
    "nextToken": {
      "description": "Opaque next cursor from the previous page. Omit for the first page.",
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "pattern": "^[^\\x00-\\x1f\\x7f]+$"
    },
    "includeDeleted": {
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "siteIds"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢famly_list_work_tags(siteSetId)

Staff work-tag IDs, names, colour and payroll codes for a site set. Uses the Famly Public API; results depend on token permissions.

输入模式

{
  "type": "object",
  "properties": {
    "siteSetId": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
    }
  },
  "required": [
    "siteSetId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢famly_get_staff_hours_totals(siteSetId, dateRange, employeeIds, groupIds, pageSize, ...)

Staff contracted, attended, scheduled and break minutes plus differences. Excludes leave categories, health information and notes. Date range maximum 365 days; one page per call. Uses the Famly Public API; results depend on token permissions.

输入模式

{
  "type": "object",
  "properties": {
    "siteSetId": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
    },
    "dateRange": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string"
        },
        "to": {
          "type": "string"
        }
      },
      "required": [
        "from",
        "to"
      ]
    },
    "employeeIds": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
      }
    },
    "groupIds": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
      }
    },
    "pageSize": {
      "default": 50,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "next": {
      "description": "Opaque next cursor from the previous page. Omit for the first page.",
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "pattern": "^[^\\x00-\\x1f\\x7f]+$"
    }
  },
  "required": [
    "siteSetId",
    "dateRange"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢famly_list_employee_checkins(SiteSetId, range, nextToken)

Staff check-in/out timestamps and work-tag IDs. Excludes manager notes and all child check-ins. Famly may return the full date range when nextToken is omitted: narrow the range. If next is returned, pass it as nextToken. Uses the Famly Public API; results depend on token permissions.

输入模式

{
  "type": "object",
  "properties": {
    "SiteSetId": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
    },
    "range": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string"
        },
        "to": {
          "type": "string"
        }
      },
      "required": [
        "from",
        "to"
      ]
    },
    "nextToken": {
      "description": "Opaque next cursor from the previous page. Omit for the first page.",
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "pattern": "^[^\\x00-\\x1f\\x7f]+$"
    }
  },
  "required": [
    "SiteSetId",
    "range"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

社区

评价此服务器

证据

最近观测

已验证未记录版本12 个工具