# MCP-Tools und Schemas

FlashData MCP Tool-Argumente, Standardwerte, Kontolesungen, Jobzustände und Ergebnisabruf.

Kanonische Referenz: https://flashdata.dev/de/docs/mcp

[Wählen Sie Ihren MCP-Client und verbinden Sie](https://flashdata.dev/de/docs/integrations/mcp-clients/reference.md)

[OAuth, Codex, OpenClaw und API-Schlüsselzugang](https://flashdata.dev/de/docs/guides/agent-access/reference.md)

<a id="connect"></a>

## Transport und Authentifizierung

Der gehostete MCP-Endpunkt verwendet Streamable HTTP. API-Schlüsselverbindungen senden X-API-Key; der Werkzeugzugriff folgt den Quellberechtigungen des Schlüssels und den verfügbaren Credits.

### Streamable HTTP

```text
URL: https://data.flashdata.dev/mcp
X-API-Key: <your API key>
```

Speichern Sie Ihren aktuellen FlashData API-Schlüssel in der Anmeldedatenkonfiguration des Kunden. Setzen Sie es nicht in ein Gespräch oder Tool-Argumente. In diesem Abschnitt werden API-Schlüsselverbindungen behandelt; der Agent Access Guide deckt die OAuth-Login und die getesteten Codex- und OpenClaw-Konfigurationen ab. youtube_download unterstützt asynchrone Mediendownloads mit der entsprechenden API-Schlüsselberechtigung.

<a id="tools"></a>

## Abfrage-Tools

Ihr Kunde entdeckt die Werkzeuge, die durch den Schlüssel gewährt werden. Alle sechs Google- und acht YouTube-Datentools sind standardmäßig in Echtzeit und akzeptieren auch mode: async. submit_batch unterstützt beide Gruppen. youtube_download verwendet den formalen Download API, erfordert Kundenspeicherung und unterstützt async-Jobs oder submit_batch. Das Modell kann Werkzeuge für die Aufgabe auswählen und kombinieren.

google_search · google_images · google_news · google_shopping · google_videos · google_places

youtube_search · youtube_search_extended · youtube_metadata · youtube_transcript · youtube_captions · youtube_trainability · youtube_channel · youtube_suggestions · youtube_download

<a id="parameters"></a>

## Tool-Argument

Setzen Sie Abfragefelder wie Abfrage, num, Sprache und Modus direkt in das Argumentobjekt des Tools, ohne den Params Wrapper des REST API. Der Name eines Abfragetools wählt seine Quelle aus; nur Einträge in submit_batch benötigen eine Quelle. API-Schlüssel und callback_url sind keine Tool-Argumente. Die folgenden JSON-Beispiele sind Argumentobjekte für client.callTool({ name, arguments }).

Verwenden Sie JSON Booleans und ganzzahlige Zahlen, nicht Strings. Unbekannte Felder werden abgelehnt. Die 14 Datenabfrage-Tools akzeptieren mode: realtime oder async, standardmäßig in Echtzeit. Batch-Einträge akzeptieren den Modus nicht.

| Werkzeug | Erforderlich | Optionale Argumente & Defaults |
| --- | --- | --- |
| youtube_download | video_id, storage | mode unterstützt nur async (Standard). download_type: audio_video (Standard)/video/audio. video_quality: <=720 standardmäßig; best/worst oder <=, ==,>= mit 144/360/480/720/1080/1440/2160/4320. fps: die gleichen Vergleiche mit 1–240. output_format: mp4 (Standard)/webm/mkv für Video, m4a (Standard)/mp3/opus für Audio. audio_language: default/original; audio_quality: best/320/256/192/128Nur Audio. yt_dlp_format: bis 1024 Charaktere, überschreibt Qualität, fps und Sprachauswahl. video_quality/fps für Audio und audio_language für Video-only. Storage ist erforderlich und entspricht Download API params.storage. start_at/end_at: HH:MM:SS, bis zu 12 Stunden; end_at muss start_at folgen. upload_metadata: boolean, standard false. Jeder Batch-Download benötigt Speicherplatz. Keine browser_delivery oder callback_url. |
| storage | storage_type, storage_url | storage_url ist Ihr Bucketname (Azure: Container), kein lokales Verzeichnis. storage_type: s3/s3_compatible/oss/gcs/azure/cos/bos/tos; optional object_prefix. S3, S3-kompatibel, OSS, COS, BOS und TOS verwenden access_key/secret_key mit dem entsprechenden region/endpoint_url. GCS verwendet service_account (project_id, client_email, private_key); Azure verwendet account_name und einen Container sas_token mit Schreibberechtigung. Der Endpunkt muss vom Worker aus erreichbar sein. Lesen Sie Anmeldeinformationen aus Ihrer Speicherkonfiguration; Fügen Sie sie nicht in den Chat ein oder wiederholen Sie sie. |
| google_* | query | Abfrage: 1–2,000 Zeichen. gl: Land mit zwei Buchstaben; hl: 1–35 Zeichensprachencode; location/tbs: 1–200 Zeichen; num/page: ganze Zahlen 1–100; Autokorrektur: boolean. Ausgelassene optionen verwenden das verhalten des suchanbieters, ohne dass eine feste land-, sprach- oder ergebniszahl garantiert ist. |
| youtube_search | query | Abfrage: 1–2,000 Zeichen. max_results: 1–20, Standard 20; Filter: Filterobjekt, ausgelassen oder null für keine Filter. |
| youtube_search_extended | query | Abfrage: 1–2,000-Zeichen. max_results: 1–700, Standard 20; Filter: die gleiche wie die Standardsuche. |
| youtube_metadata | video_id | include_formats und include_chapters: booleans, beide standardmäßig true. |
| youtube_transcript | video_id | Lassen Sie die Sprache weg, um en-orig zu bevorzugen, und geben Sie dann einen Track zurück. Mit auto=true bevorzugt jeder Code seine -orig-Spur, dann den einfachen Code; explizit -orig und auto=false bleiben genau. Arrays versuchen alle 1–10 angeforderten Sprachen und geben Spuren und Fehler in der Reihenfolge zurück. auto defaults zu true für automatische Beschriftungen. |
| youtube_captions | video_id | Lassen Sie die Sprache weg, um en-orig zu bevorzugen, und geben Sie dann einen Track zurück. Mit auto=true bevorzugt jeder Code seine -orig-Spur, dann den einfachen Code; explizit -orig und auto=false bleiben genau. Arrays versuchen alle 1–10 angeforderten Sprachen und geben Spuren und Fehler in der Reihenfolge zurück. automatische Standardeinstellungen zu false für von Uploadern bereitgestellte Bildunterschriften. |
| youtube_trainability | video_id | Keine optionalen Argumente außer Modus. Berichtet Creative Commons Lizenzklassifizierung; es gewährt keine Schulungserlaubnis. |
| youtube_channel | handle | Handle: 1–100-Zeichen; video_limit: 1–100, standardmäßig 20. |
| youtube_suggestions | query | Abfrage: 1–2,000-Zeichen; Sprache: standardmäßig en; Region: zweistelliger Ländercode, standardmäßig US. |

video_id ist ein 11-Charakter YouTube ID mit Buchstaben, Zahlen, Unterstrichen oder Bindestrichen; liefern Sie das ID anstelle des Videos URL. Jeder Sprachcode besteht aus 1–35-Zeichen, die Buchstaben, Zahlen oder Bindestriche verwenden. Bei Untertiteln wählt auto=true automatische Untertitel und false wählt von Uploadern bereitgestellte Untertitel aus, ohne dass es zu einem automatischen Rückgriff zwischen ihnen kommt. Überprüfen Sie bei Spracharrays Fehler, auch wenn der Job erfolgreich ist.

### YouTube Suchfilter

filters.type: video/channel/playlist/movie; upload_date: today/last_hour/this_week/this_month/this_year; Dauer: <4, 4-20 oder >20; sort_by: rating/relevance/view_count/upload_date. Feature-Flags sind boolean; true erfordert diese Funktion: 360, 3d, 4k, creative_commons, hd, hdr, live, location, purchased, subtitles, vr180.

<a id="account"></a>

## Account Insights (kostenlos)

get_balance liest Ihren geteilten Kontostand; get_pricing schätzt die Abfragekosten; get_limits liest Planlimits und aktuelle ausstehende Jobs; get_usage fasst die letzten 7-Tage standardmäßig mit einem maximalen 31-Tagesfenster zusammen. Die Nutzung umfasst alle Kontoschlüssel für Quellen, die durch den aufrufenden Schlüssel autorisiert sind, und kann sich verzögern.

get_balance und get_limits nehmen {}. get_pricing akzeptiert eine optionale Quelle; lassen Sie sie für alle MCP-Abfragequellen aus, die von Ihrem Schlüssel autorisiert sind. request_count ist eine ganze Zahl von 1 bis 100000, Standard 1; jede Seite oder jedes Batch-Element zählt als separate Anforderung. get_usage akzeptiert eine optionale Quelle; lassen Sie sie für alle autorisierten Quellen aus. Es beinhaltet die Nutzung von youtube_download. Download-Preise geben creditsPerTb zurück (1 TB = 10^12 Bytes); Downloads Reserve Credits und begleichen durch tatsächlich hochgeladene Bytes. request_count gilt nicht für Downloads und estimatedCredits ist null.

get_usage from/to muss UTC ISO-Zeitstempel wie 2026-09-21T00:00:00Z sein, optional mit 1–3 gebrochenen zweiten Ziffern. von ist inklusive, bis exklusiv, auf Minuten abgerundet. Das Standardfenster ist 7 Tage und das Maximum ist 31 Tage. Mit nur von, bis ist sieben Tage später; mit nur bis, von ist sieben Tage früher. Lesen Sie die Antwort from/to für das effektive Fenster.

<a id="jobs"></a>

## Jobs und große Ergebnisse

Eine async-Anfrage gibt eine Job-ID zurück; übergeben Sie sie als job_id an get_job, um job.status zu lesen. Abgeschlossene Jobs enthalten die ursprüngliche Abfrageantwort in der Ausgabe. Für Downloads ist die Ausgabe das Upload-Manifest: output.results[0].file_url zeigt auf den Kundenspeicher mit file_size, downloaded_bytes und md5. Private Dateien erfordern Ihre Speicherauthentifizierung. JSON-Ergebnisse werden für 24-Stunden gespeichert; Medienaufbewahrung und -zugriff folgen Ihren Speicherrichtlinien. submit_batch akzeptiert mindestens eine Google- oder YouTube-Abfrage (einschließlich Downloads) mit Quellen- und flachen Argumenten auf jedem Eintrag. Jeder Eintrag wird separat in Rechnung gestellt, und die Charge und die ausstehenden Limits Ihres Plans gelten. Das Lesen von Jobs wird nicht wieder berechnet. Dateibasiertes Bulk ist kein MCP-Tool.

Ersetzen Sie das Beispiel job_id, result_id und verrechnen Sie es mit Werten aus Ihrer Antwort. Lesen Sie den nächsten Teil, ohne die Abfrage erneut einzureichen.

Große Antworten umfassen einen JSON Text-Chunk, result_id und next_offset. Rufen Sie get_result mit dem gleichen Schlüssel und dem zurückgegebenen result_id auf. Offset ist eine nicht negative Ganzzahl, Standard 0; Verwenden Sie die vorherige next_offset, um fortzufahren. Limit ist eine Ganzzahl von 1 zu 16000, Standard 16000, gemessen in UTF-16-Codeeinheiten anstelle von Bytes oder Ergebniszeilen. Konkatenate Brocken in der Reihenfolge vor dem Parsen JSON; next_offset=null markiert das Ende. Die Ergebnisse werden für 10-Minuten zwischengespeichert, mit höchstens vier großen Ergebnissen pro Schlüssel, und können früher vertrieben werden. Das lesen von chunks wiederholt die abfrage nicht oder berechnet credits nicht.

[Verarbeitung einer ID-Datei? Verwenden Sie Bulk HTTP API](https://flashdata.dev/de/docs/reference/bulk-processing/reference.md)

<a id="billing"></a>

## Billing und Fehler

Abfragen verwenden die Credits-Preise Ihres bestehenden Plans ohne zusätzliche MCP-Gebühr. Tool Errors setzen isError und behalten den Upstream HTTP Status bei und fordern ID an. Wiederherstellen von Credits für unzureichendes Guthaben und Überprüfen Sie die Schlüsselberechtigungen auf Zugriffsfehler.

Ein Timeout oder eine verlorene Verbindung bedeutet nicht, dass die Abfrage nicht ausgeführt wurde. Für query_outcome_unknown aktivieren Sie die Anforderung von History in der Konsole, bevor Sie sich entscheiden, erneut zu senden. Versuchen sie nicht automatisch bezahlte einreichungen; lesungen von bestehenden jobs oder stücken können erneut getestet werden. Upstream-Antworten sind auf 4 MiB beschränkt, begrenzen Sie also die Suchgröße; übergroße Antworten wurden möglicherweise bereits geladen.

[HTTP-Statuscodes](https://flashdata.dev/de/docs/errors/reference.md#status-codes) · [Rücklaufregeln](https://flashdata.dev/de/docs/errors/reference.md#retries)

### youtube_download · arguments JSON

```json
{
  "video_id": "FUfGcZ092b0",
  "download_type": "audio_video",
  "video_quality": "<=360",
  "output_format": "mp4",
  "storage": {
    "storage_type": "s3",
    "storage_url": "your-video-bucket",
    "object_prefix": "mcp-downloads",
    "access_key": "YOUR_STORAGE_ACCESS_KEY",
    "secret_key": "YOUR_STORAGE_SECRET_KEY",
    "region": "us-east-1"
  }
}
```

### google_search · arguments JSON

```json
{
  "query": "MCP protocol",
  "num": 3,
  "gl": "us",
  "hl": "en",
  "mode": "async"
}
```

### youtube_search · arguments JSON

```json
{
  "query": "renewable energy",
  "max_results": 5,
  "filters": {
    "type": "video",
    "duration": "<4",
    "subtitles": true
  }
}
```

### youtube_transcript · arguments JSON

```json
{
  "video_id": "FUfGcZ092b0",
  "language": "en",
  "auto": true,
  "mode": "async"
}
```

### submit_batch · arguments JSON

```json
{
  "queries": [
    {
      "source": "google_search",
      "query": "renewable energy",
      "num": 3
    },
    {
      "source": "youtube_metadata",
      "video_id": "FUfGcZ092b0",
      "include_formats": false
    }
  ]
}
```

### get_job · arguments JSON

```json
{
  "job_id": "job_REPLACE_WITH_RETURNED_ID"
}
```

### get_result · arguments JSON

```json
{
  "result_id": "result_1800000000000_00000000-0000-0000-0000-000000000000",
  "offset": 16000,
  "limit": 16000
}
```

### get_pricing · arguments JSON

```json
{
  "source": "google_search",
  "request_count": 3
}
```

### get_usage · arguments JSON

```json
{
  "source": "youtube_metadata",
  "from": "2026-09-21T00:00:00Z",
  "to": "2026-09-22T00:00:00Z"
}
```

<a id="client-example"></a>

## Verifizieren mit einem JavaScript Client

Dieser Client verwendet das verifizierte offizielle SDK 1.30.0, um sich über Streamable HTTP und Listentools zu verbinden, ohne eine kostenpflichtige Abfrage auszuführen. Speichern Sie es als mcp-check.mjs, legen Sie FLASHDATA_API_KEY in Ihrer Umgebung fest und führen Sie dann den Knoten mcp-check.mjs aus.

### npm

```bash
npm install @modelcontextprotocol/sdk@1.30.0
```

### mcp-check.mjs

```javascript
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const key = process.env.FLASHDATA_API_KEY;
if (!key) throw new Error('Set FLASHDATA_API_KEY first.');
const client = new Client({ name: 'my-app', version: '1.0.0' });
try {
  await client.connect(new StreamableHTTPClientTransport(
    new URL('https://data.flashdata.dev/mcp'),
    { requestInit: { headers: { 'X-API-Key': key } } }
  ));
  console.log((await client.listTools()).tools.map(tool => tool.name));
} finally {
  await client.close();
}
```
