Famly MCP by usefulapi
Review Famly sites, staff, invoices and payments through its public API.
사용해야 할까요
품질 및 안전성
발견 사항 (1)
- LOWTool 'famly_list_sites' description lacks action verbfamly_list_sites에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`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"
}커뮤니티
증거