---
type: reference
title: MCP-Tools-Referenz
summary: Jedes Caputchin-MCP-Tool, was es tut und die Berechtigung, die sein Token halten muss, gruppiert nach Bereich.
---

Das sind die Tools, die der [MCP-Server](/docs/automation/mcp) bereitstellt, in seiner lokalen wie seiner gehosteten Form. Jedes reicht eine einzelne [Management-API](/docs/automation/management-api)-Operation weiter, also ist die Berechtigung, die ein Tool braucht, die Berechtigung, die diese Operation braucht; der [Token](/docs/automation/management-api#mint-an-access-token) des Agenten muss sie halten. Der Katalog und die Beschreibungen kommen vom Server selbst; für das genaue Anfrage- und Antwort-Schema der Operation hinter einem Tool sieh dir die [interaktive API-Referenz](/docs/api-reference) an.

## Wie Berechtigungen hier funktionieren

Ein Tool läuft nur, wenn der Token dahinter die zugrunde liegende Operation ausführen darf. Die Spalte **Berechtigung** nutzt diese Werte, die auf das Modell aus [Berechtigungen und Geltungsbereich](/docs/troops/permissions) der Teams abbilden:

| Wert | Bedeutet |
|---|---|
| **Account** | Jeder gültige Token auf dem Konto. Token- und Sitz-prägende Tools brauchen zusätzlich eine Konto-Master-Anmeldedatei (eine Dashboard-Session oder das [Personal Access Token](/docs/account-management/personal-access-token)); ein Team-Token kann keine Tokens oder Sitze prägen. |
| **read** | Die `read`-Berechtigung. Site-eingeschränkte Tools verlangen zusätzlich, dass der Site-Key im Geltungsbereich des Tokens ist. |
| **create** | Die `create`-Berechtigung auf dem Team (einen Site-Key darin erstellen). |
| **edit** | Die `edit`-Berechtigung, eingeschränkt auf den Site-Key, den das Tool anvisiert. |
| **manage** | Die `manage`-Berechtigung: Team-Administration (Mitglieder, Tokens, teamweite Einstellungen). |

Ein paar Tools brauchen auch eine Tarifstufe, in der Beschreibung vermerkt: White-Labeling ist **Apex**, Spiel-Sprach- und Skin-Anpassung ist **Alpha und höher**, und Audit-Logs sind **Apex**.

## Konto und Gesundheit

| Tool | Tut | Berechtigung |
|---|---|---|
| `caputchin_ping` | Gesundheitscheck; gibt die aufgelöste Konto-id zurück, wenn der Token gültig ist. | Account |
| `caputchin_get_account` | Das authentifizierte Konto (id, E-Mail, Tarif). | Account |
| `caputchin_me_billing` | Abrechnungs-Zusammenfassung (Tarif, Status, Periode). | Account |
| `caputchin_get_seats` | Sitznutzung fürs Konto (belegt, gesamt, Aufschlüsselung). | Account |

## Tokens und Sitze

| Tool | Tut | Berechtigung |
|---|---|---|
| `caputchin_list_tokens` | Die Tokens des Kontos auflisten; gibt nie Secrets zurück. | Account |
| `caputchin_create_token` | Einen Token prägen (`type` troop oder account); Wert einmal zurückgegeben. | Account (master) |
| `caputchin_rotate_token` | Das Secret eines Tokens rotieren; neuer Wert einmal zurückgegeben. | Account (master) |
| `caputchin_revoke_token` | Einen Token widerrufen; sofort wirksam. | Account (master) |
| `caputchin_invite_seat_user` | Einen Nutzer in ein Team einladen (sitz-bewusst); verbraucht einen Sitz, wenn neu. | Account (master) |
| `caputchin_remove_seat_user` | Einen Nutzer aus jedem Team im Konto entfernen. | Account (master) |
| `caputchin_mint_seat_pat` | Einen Team-Token in einem Aufruf prägen und anhängen; Wert einmal zurückgegeben. | Account (master) |
| `caputchin_attach_seat_pat` | Einen bestehenden Team-Token an ein anderes Team anhängen. | Account (master) |
| `caputchin_revoke_seat_pat` | Einen Team-Token kontoweit widerrufen. | Account (master) |

## Teams

| Tool | Tut | Berechtigung |
|---|---|---|
| `caputchin_list_troops` | Die Teams des Kontos auflisten. | Account |
| `caputchin_get_troop` | Ein Team per id. | read |
| `caputchin_create_troop` | Ein geteiltes Team erstellen. | Account |
| `caputchin_rename_troop` | Ein Team umbenennen. | manage |
| `caputchin_delete_troop` | Ein Team löschen; verweigert, wenn es noch Site-Keys besitzt. | manage |
| `caputchin_list_troop_members` | Die Mitglieder eines Teams mit ihren Berechtigungen und Geltungsbereich. | read |
| `caputchin_add_troop_member` | Einen Nutzer per E-Mail mit Berechtigungen und Geltungsbereich hinzufügen; kann einen Sitz verbrauchen. | manage |
| `caputchin_update_troop_member` | Die Berechtigungen oder den Geltungsbereich eines Mitglieds ändern. | manage |
| `caputchin_remove_troop_member` | Ein Mitglied entfernen; gibt seinen Sitz frei, wenn es sein letzter war. | manage |
| `caputchin_list_troop_pats` | Die an ein Team angehängten Team-Tokens. | read |
| `caputchin_attach_troop_pat` | Einen Team-Token mit Berechtigungen und Geltungsbereich anhängen; verbraucht einen Sitz. | manage |
| `caputchin_update_troop_pat` | Die Berechtigungen oder den Geltungsbereich eines angehängten Tokens ändern. | manage |
| `caputchin_detach_troop_pat` | Einen Team-Token ablösen; gibt seinen Sitz frei. | manage |
| `caputchin_get_troop_security` | Die Sicherheitseinstellungen eines Teams (die Spiel-erzwingen-Obergrenze plus die Vorschaumodus- und Verifizierungs-Wiederverwendungs-Standards). | read |
| `caputchin_update_troop_security` | Die Spiel-erzwingen-Obergrenze und die teamweiten Vorschaumodus- und Verifizierungs-Wiederverwendungs-Standards setzen. | manage |

## Site-Keys

| Tool | Tut | Berechtigung |
|---|---|---|
| `caputchin_list_sites` | Alle Site-Keys über die Teams des Kontos. | read |
| `caputchin_get_site` | Ein Site-Key per id. | read |
| `caputchin_create_site` | Einen Site-Key erstellen (in einem Team oder Personal); gibt das Einmal-Secret zurück. | create |
| `caputchin_update_site` | Den Namen oder das Deaktiviert-Flag eines Keys aktualisieren. | edit |
| `caputchin_delete_site` | Einen Key löschen; kaskadiert Sessions und Config. Unumkehrbar. | edit |
| `caputchin_rotate_site_secret` | Das Secret rotieren; das alte stoppt sofort; neues einmal zurückgegeben. | edit |
| `caputchin_get_site_cap_config` | Die Proof-of-Work-Config eines Keys. | read |
| `caputchin_update_site_cap_config` | Die Proof-of-Work-Config aktualisieren. | edit |
| `caputchin_get_site_security` | Die Sicherheitseinstellungen eines Keys (das Spiel-verlangen-Gate, der Vorschaumodus und die Verifizierungs-Wiederverwendung). | read |
| `caputchin_update_site_security` | Das Spiel-verlangen-Gate, den Vorschaumodus und die Verifizierungs-Wiederverwendung pro Key umschalten. | edit |
| `caputchin_list_site_sessions` | Jüngste Verifizierungs-Sessions für einen Key. | read |

## Gehostete Verifizierung

| Tool | Tut | Berechtigung |
|---|---|---|
| `caputchin_get_hosted_verification` | Die Config der gehosteten Verifizierung eines Keys. | read |
| `caputchin_set_hosted_verification` | Das Aktivieren-Flag und die Ziele setzen. | edit |
| `caputchin_test_hosted_verification` | Eine synthetische Zustellung an die konfigurierten Ziele feuern. | edit |

## Statistik, Zustellung und Audit-Logs

| Tool | Tut | Berechtigung |
|---|---|---|
| `caputchin_site_stats` | Site-Verifizierungsstatistik über einen Zeitraum. | read |
| `caputchin_site_stats_dashboard` | Site-Statistik-Dashboard-Hochrechnung. | read |
| `caputchin_site_stats_activity` | Site-Statistik-Aktivitätsreihe. | read |
| `caputchin_site_stats_durations` | Site-Statistik-Timing-Perzentile. | read |
| `caputchin_site_stats_rejections` | Site-Ablehnungszähler. | read |
| `caputchin_troop_stats` | Team-Statistik-Lebenszeit-Summen. | read |
| `caputchin_troop_stats_dashboard` | Team-Statistik-Dashboard-Hochrechnung. | read |
| `caputchin_troop_stats_activity` | Team-Statistik-Aktivitätsreihe. | read |
| `caputchin_troop_stats_durations` | Team-Statistik-Timing-Perzentile. | read |
| `caputchin_troop_stats_rejections` | Team-Ablehnungszähler. | read |
| `caputchin_quick_stats_sites` | Kompakter Statistik-Snapshot pro Site über das Konto. | read |
| `caputchin_quick_stats_troops` | Kompakter Statistik-Snapshot pro Team über das Konto. | read |
| `caputchin_site_delivery_dashboard` | Zustellungsstatistik der gehosteten Verifizierung für eine Site. Apex. | read |
| `caputchin_troop_delivery_dashboard` | Zustellungsstatistik der gehosteten Verifizierung für ein Team. Apex. | read |
| `caputchin_account_audit_logs` | Audit-Log auf Kontoebene. Apex. | Account |
| `caputchin_troop_audit_logs` | Team-Audit-Log. Apex. | read |
| `caputchin_site_audit_logs` | Site-Key-Audit-Log. Apex. | read |

## Marketplace-Spiele

| Tool | Tut | Berechtigung |
|---|---|---|
| `caputchin_list_games` | Marketplace-Spiele auflisten. | Account |
| `caputchin_search_games` | Marketplace-Spiele per Text durchsuchen. | Account |
| `caputchin_get_game` | Ein Marketplace-Spiel per id. | Account |

## Spiel-Anpassung

Diese zielen auf einen Geltungsbereich (einen Site-Key oder ein Team), also braucht eine Site-eingeschränkte Änderung `edit` auf diesem Key und eine teamweite Änderung `manage`. Sprach- und Skin-Anpassung ist **Alpha und höher**.

| Tool | Tut | Berechtigung |
|---|---|---|
| `caputchin_list_customized_games` | Die registrierten (installierten) Spiele eines Geltungsbereichs. | read |
| `caputchin_register_customized_game` | Ein Spiel auf einem Geltungsbereich registrieren (installieren); pinnt einen Snapshot. | edit (site) or manage (troop) |
| `caputchin_repin_customized_game` | Ein registriertes Spiel auf die neueste Version neu pinnen. | edit (site) or manage (troop) |
| `caputchin_update_customized_game` | Die Einstellungen eines registrierten Spiels aktualisieren (Auto-Update). | edit (site) or manage (troop) |
| `caputchin_delete_customized_game` | Ein registriertes Spiel aus einem Geltungsbereich deinstallieren. | edit (site) or manage (troop) |
| `caputchin_list_game_presets` | Anpassungs-Presets für einen Geltungsbereich und ein Spiel. | read |
| `caputchin_set_game_preset` | Ein Spiel-Preset erstellen oder aktualisieren. Alpha+. | edit (site) or manage (troop) |
| `caputchin_delete_game_preset` | Ein Spiel-Preset löschen. Alpha+. | edit (site) or manage (troop) |
| `caputchin_set_game_default` | Das Standard-Spiel-Preset für eine Achse setzen. Alpha+. | edit (site) or manage (troop) |
| `caputchin_get_custom_game_schema` | Das Feld-Schema eines Custom-Spiels für einen Geltungsbereich. | read |
| `caputchin_set_custom_game_schema` | Das Feld-Schema eines Custom-Spiels setzen. Alpha+. | edit (site) or manage (troop) |
| `caputchin_delete_custom_game_schema` | Das Feld-Schema eines Custom-Spiels löschen. Alpha+. | edit (site) or manage (troop) |
| `caputchin_upload_custom_game_run` | Das Headless-Run-Artefakt eines Custom-Spiels hochladen. | edit (site) or manage (troop) |
| `caputchin_get_custom_game_run` | Die Referenz auf das gespeicherte Run-Artefakt eines Custom-Spiels holen. | read |
| `caputchin_delete_custom_game_run` | Das Run-Artefakt eines Custom-Spiels löschen. | edit (site) or manage (troop) |

## White-Label

Das Widget-Hülle per White-Label anzupassen ist eine **Apex**-Funktion. Wie bei der Spiel-Anpassung braucht eine Site-eingeschränkte Änderung `edit` und eine teamweite `manage`.

| Tool | Tut | Berechtigung |
|---|---|---|
| `caputchin_list_white_label_presets` | White-Label-Presets für einen Geltungsbereich. | read |
| `caputchin_set_white_label_preset` | Ein White-Label-Preset erstellen oder aktualisieren. Apex. | edit (site) or manage (troop) |
| `caputchin_delete_white_label_preset` | Ein White-Label-Preset löschen. Apex. | edit (site) or manage (troop) |
| `caputchin_set_white_label_default` | Das Standard-White-Label-Preset für eine Achse setzen. Apex. | edit (site) or manage (troop) |

## Siehe auch

- [Den MCP-Server nutzen](/docs/automation/mcp): einen Agenten über beide Transporte verbinden.
- [Berechtigungen und Geltungsbereich](/docs/troops/permissions): das read / create / edit / manage-Modell, das die Tabelle oben nutzt.
- [Interaktive API-Referenz](/docs/api-reference): das genaue Schema der Operation hinter jedem Tool.