MCP MeasureMCP Measure

Index beobachtet

Famly MCP by usefulapi

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

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
98%
Vollständigkeit des Schemas
82%
Qualität der Benennung
80%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Befunde (1)

  • LOWTool 'famly_list_sites' description lacks action verbin famly_list_sites

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~3,222Tokens (Tool-Definitionen)
~1.5 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (2.52% von 128k Kontext)

Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.

Installieren

Installation mit einem Klick

Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:

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

Remote-Endpunkte

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

Was es kann

Tool-Inventar

Tools (12)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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"
}

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet12 Tools