# Herramientas y esquemas MCP

Busque argumentos de herramienta FlashData MCP, defectos, lecturas de cuenta, estados de trabajo y recuperación de resultados.

Referencia canónica: https://flashdata.dev/es/docs/mcp

[Elija su cliente MCP y conéctese](https://flashdata.dev/es/docs/integrations/mcp-clients/reference.md)

[OAuth, Codex, OpenClaw y API-key access](https://flashdata.dev/es/docs/guides/agent-access/reference.md)

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

## Transporte y autenticación

El punto final MCP hospedado utiliza Streamable HTTP. Las conexiones API-key envían X-API-Key; el acceso a la herramienta sigue los permisos de la fuente de la clave y los créditos disponibles.

### Streamable HTTP

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

Almacene su real FlashData API clave en la configuración credencial del cliente. No lo ponga en una conversación o argumentos de herramientas. API- conexiones clave; la guía de acceso de agente cubre OAuth inicio de sesión y la prueba Codex y OpenClaw configuraciones. youtube_download soporta descargas de medios asincrónicas con el apropiado API- permiso de llaves.

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

## Herramientas de consulta

Su cliente descubre las herramientas otorgadas por la clave. Todas las seis herramientas de datos Google y ocho YouTube predeterminadas a tiempo real y también aceptan mode: async. submit_batch admite ambos grupos. youtube_download utiliza la descarga formal API, requiere almacenamiento de clientes, y admite trabajos asinc o submit_batch.

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>

## Discusiones de herramientas

Poner campos de consulta tales como consulta, num, lenguaje y modo directamente en el objeto de argumentos de la herramienta, sin el REST API’s params wrapper. El nombre de una herramienta de consulta selecciona su fuente; sólo entradas en submit_batch necesita fuente. API llaves y callback_url no son argumentos de herramientas. JSON ejemplos a continuación son objetos de argumento client.callTool({ nombre, argumentos }).

Utilizar booleanos JSON y números enteros, no cadenas. Los campos desconocidos son rechazados. Las herramientas de consulta de datos 14 aceptan mode: realtime o async, predeterminando en tiempo real. Las entradas Batch no aceptan el modo.

| Herencia | Obligatorio | Discusiones opcionales &quot; predeterminados |
| --- | --- | --- |
| youtube_download | video_id, storage | mode solo admite async (predeterminado). download_type: audio_video (predeterminado)/video/audio. video_quality: <=720 de forma predeterminada; best/worst o <=, ==, >= con 144/360/480/720/1080/1440/2160/4320. fps: las mismas comparaciones con 1–240. output_format: mp4 (predeterminado)/webm/mkv para vídeo, m4a (predeterminado)/mp3/opus para audio. audio_language: default/original; audio_quality: best/320/256/192/128, solo para audio. yt_dlp_format: hasta 1024 caracteres; sustituye la selección de calidad, fps e idioma. Omita video_quality/fps para audio y audio_language para vídeo sin audio. storage es obligatorio y coincide con params.storage de Download API. start_at/end_at: HH:MM:SS, hasta 12 horas; end_at debe ser posterior a start_at. upload_metadata: booleano, false de forma predeterminada. Cada descarga por lotes necesita storage. No se admiten browser_delivery ni callback_url. |
| storage | storage_type, storage_url | storage_url es tu nombre de cubo (Azure: container), no un directorio local. storage_type: s3/s3_compatible/oss/gcs/azure/cos/bos/tos; opcional object_prefix. S3, S3-compatible, OSS, COS, BOS y TOS access_key/secret_key con la región aplicable/endpoint_url. GCS utiliza service_account (project_id, client_email, private_key); Azure utiliza account_name y un contenedor sas_token con permiso de escritura. El punto final debe ser accesible desde el Trabajador. Lea las credenciales de su configuración de almacenamiento; no las pegue en chat o haga clic en ellas. |
| google_* | query | query: 1–2,000 caracteres. gl: país de dos letras; hl: 1–35 código de lenguaje de carácter; ubicación/tbs: 1–200 caracteres; num/page: enteros 1–100; autocorrecto: booleano. Las opciones omitidas utilizan el comportamiento del proveedor de búsqueda, sin ningún país fijo, idioma o resultado cuentan garantizado. |
| youtube_search | query | query: 1–2,000 personajes. max_results: 1–20, por defecto 20; filtros: objeto filtrante, omitido o nulo sin filtros. |
| youtube_search_extended | query | query: 1–2,000 personajes. max_results: 1–700, por defecto 20; filtros: igual que la búsqueda estándar. |
| youtube_metadata | video_id | include_formats y include_chapters: booleanos, ambos por defecto verdadero. |
| youtube_transcript | video_id | Omitir lenguaje para preferir en-orig, luego en, devolver una pista. Con auto=true, cada código prefiere su pista de -orig, luego el código llano; explícita -orig y auto=false mantener exacto. Arrays probar todos 1–10 idiomas solicitados y devoluciones de pistas y errores en orden. auto predeterminado a verdadero para capciones automáticas. |
| youtube_captions | video_id | Omitir lenguaje para preferir en-orig, luego en, devolver una pista. Con auto=true, cada código prefiere su pista de -orig, luego el código llano; explícita -orig y auto=false mantener exacto. Arrays probar todos 1–10 idiomas solicitados y devuelve pistas y errores en orden. auto predetermina a falso para subidas proporcionadas por subidor. |
| youtube_trainability | video_id | No hay argumentos opcionales excepto el modo. Informes Clasificación de licencias Creative Commons; no otorga permiso de entrenamiento. |
| youtube_channel | handle | handle: 1–100 caracteres; video_limit: 1–100, predeterminado 20. |
| youtube_suggestions | query | query: 1–2,000 caracteres; idioma: default en; region: two-letter country code, default US. |

video_id es un 11-Caracter YouTube ID usando letras, números, subrayados o hifénes; suministrar el ID más que el video URL. Cada código de idioma es 1–35 caracteres que utilizan letras, números o hyphens. Para subtítulos, auto=true selecciona las subtítulos automáticos y falsos selecciona las subtítulos proporcionados por subgerentes, sin retroceso automático entre ellos. Para los arrays de idiomas, comprueba errores incluso cuando el trabajo tenga éxito.

### Filtros de búsqueda YouTube

filters.type: video/channel/playlist/movie; upload_date: today/last_hour/this_week/this_month/this_year; duration: <4, 4-20 o >20; sort_by: rating/relevance/view_count/upload_date. Los indicadores de características son booleanos; true exige esa característica: 360, 3d, 4k, creative_commons, hd, hdr, live, location, purchased, subtitles, vr180.

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

## Información de la cuenta (gratuita)

get_balance lee el saldo de su cuenta compartida; get_pricing calcula los costos de consulta; get_limits lee los límites del plan y los trabajos pendientes actuales; get_usage resume los últimos días 7 por defecto, con una ventana máxima 31-day. El uso incluye todas las claves de cuenta para las fuentes autorizadas por la tecla de llamada y puede ser retrasada.

get_balance y get_limits Toma. get_pricing acepta una fuente opcional; omitirla para todos MCP fuentes de consulta autorizadas por tu llave. request_count es un entero de 1 a 100000, por defecto 1; cada página o artículo de lotes cuenta como una solicitud separada. get_usage acepta una fuente opcional; omitirla para todas las fuentes autorizadas. Incluye el uso de youtube_download. Devuelve los precios de descarga creditsPerTb (1 TB = 10^12 bytes); descargas reserva Créditos y liquida bytes cargados. request_count no se aplica a las descargas y estimatedCredits es null.

get_usage desde/to debe ser UTC ISO timetamps tales como 2026-09- 21T00:00:00Z, opcionalmente con 1–3 segundo dígitos fraccionados. desde es inclusivo, hasta exclusivo, redondeado hasta minutos. La ventana predeterminada es 7 días y el máximo 31 días. Con sólo de, a es siete días después; con sólo a, de es siete días antes. Lea la respuesta de/to para la ventana efectiva.

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

## Trabajos y resultados grandes

Una solicitud de asinc devuelve un trabajo id; pasarlo como job_id a get_job para leer job.status. Los trabajos completados incluyen la respuesta original de la consulta en la salida. Para las descargas, la salida es el manifiesto de carga: output.results[0].file_url apunta al almacenamiento del cliente, con file_size, downloaded_bytes y md5. Los archivos privados requieren su autenticación de almacenamiento. Los resultados de JSON se mantienen para las horas de 24; retención de medios y acceso siguen sus políticas de almacenamiento. submit_batch acepta por lo menos una consulta Google o YouTube (incluyendo descargas), con argumentos de origen y planos en cada entrada. Cada entrada es facturada por separado, y se aplican los límites de su plan por lotes y pendientes. Los trabajos de lectura no cobran de nuevo. Bulk basado en archivos no es una herramienta MCP.

Reemplazar el ejemplo job_id, result_id y compensar con los valores de tu respuesta. Lea el siguiente trozo sin volver a enviar la consulta.

Las grandes respuestas incluyen un fragmento de texto JSON, result_id y next_offset. Call get_result con la misma llave y el devuelto result_id. offset is a nonnegative integer, default 0; utilizar el anterior next_offset para continuar. El límite es un entero 1 a 16000, por defecto 16000, medido en UTF-16 unidades de código en lugar de bytes o filas de resultado. Los trozos de concatenado en orden antes de cortar JSON; next_offset=null marca el final. Los resultados están grabados para minutos 10, con al menos cuatro grandes resultados por clave, y puede ser desalojado antes. Leyendo trozos no repite la consulta o cobra Créditos.

[¿Procesando un archivo ID? Utilice el Bulk HTTP API](https://flashdata.dev/es/docs/reference/bulk-processing/reference.md)

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

## Facturación y errores

Las consultas utilizan los precios de créditos de su plan existente sin cargo adicional MCP. Los errores de la herramienta establecen isError y conservan el estado de HTTP y solicitan ID. Restaurar Créditos para un saldo insuficiente y comprobar permisos clave para errores de acceso.

Una conexión temporal o perdida no significa que la consulta no fue ejecutada. Para query_outcome_unknown, verifique Solicitar historia en la consola antes de decidir someterse de nuevo. No vuelva a enviar automáticamente las presentaciones pagadas; se pueden recortar lecturas de trabajos o trozos existentes. Las respuestas preliminares se limitan a 4 MiB, así que limitar el tamaño de búsqueda; las respuestas sobredimensionadas ya se han cobrado.

[Underlying HTTP códigos de estado](https://flashdata.dev/es/docs/errors/reference.md#status-codes) · [Reglas de entrada](https://flashdata.dev/es/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>

## Verificar con un cliente JavaScript

Este cliente utiliza las herramientas oficiales verificadas SDK 1.30.0 para conectarse sobre Streamable HTTP y listar sin ejecutar una consulta pagada. Ahorre como mcp-check.mjs, establezca FLASHDATA_API_KEY en su entorno, y luego ejecute el nodo mcp-check.mjs.

### 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();
}
```
