# El servidor MCP de TestAutoescuela

Conecta un asistente de IA compatible con las fichas públicas de TestAutoescuela: herramientas search y fetch, versiones del protocolo, cabeceras y ejemplo completo.

Página: https://testautoescuela.es/datos/mcp/

Corpus: 34 fichas públicas, con sus enlaces, sus fuentes y sus fechas cuando están documentadas.

## Uso

Acceso público, de solo lectura, sin clave. Ningún dato de cuenta, de progreso de alumno ni información privada. Citar el enlace de la ficha y conservar sus fuentes y el alcance de su verificación. Las normas oficiales (con su fuente) se distinguen de las lecciones, del método y de las ofertas de TestAutoescuela.

## MCP

URL: https://testautoescuela.es/mcp

Transporte Streamable HTTP, respuestas JSON, protocolos 2026-07-28 y 2025-11-25 (así como 2025-06-18 y 2025-03-26), sin autenticación ni sesión. No hace falta ningún flujo SSE.

Herramientas:
- search: {query: "límite de velocidad"}, devuelve {results: [{id, title, url}]} en content y structuredContent (20 resultados como máximo).
- fetch: {id: "identificador devuelto por search"}, devuelve {id, title, text, url, metadata}. Los metadatos indican la naturaleza de la ficha, sus fuentes, sus fechas (verified_at para una verificación, modified_at para una modificación de la publicación) y, para una lección, su capítulo, su imagen y su vídeo.

En 2026-07-28: server/discover, luego tools/list y tools/call. En 2025: initialize, luego notifications/initialized, luego tools/list y tools/call.

## Cabeceras

Enviar Content-Type: application/json y Accept: application/json, text/event-stream. Después de initialize, transmitir MCP-Protocol-Version con la versión negociada. En 2026-07-28, cada solicitud lleva su versión en _meta y en las cabeceras MCP-Protocol-Version, Mcp-Method y, para una herramienta, Mcp-Name. Un navegador externo debe pasar por la API REST: la ruta MCP controla los orígenes. Comprobar los errores JSON-RPC e isError incluso en una respuesta HTTP 200.

## Ejemplos

### Buscar y leer una ficha con el SDK de MCP

Con Node.js 20 o posterior, instala npm install @modelcontextprotocol/sdk@1.30.0 y guarda este código en un archivo .mjs. El SDK gestiona la inicialización y las cabeceras del protocolo. La lectura usa el identificador que devuelve realmente la búsqueda. Conserva el campo url como cita visible en tu interfaz.

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

const client = new Client({ name: 'exemple-site', version: '1.0.0' }, { capabilities: {} });
const transport = new StreamableHTTPClientTransport(new URL('https://testautoescuela.es/mcp'));

function readTool(result) {
  if (result.isError) throw new Error('La herramienta MCP no ha podido procesar la solicitud.');
  if (result.structuredContent) return result.structuredContent;
  const content = result.content?.find(item => item.type === 'text');
  if (!content) throw new Error('Respuesta MCP sin contenido.');
  return JSON.parse(content.text);
}

try {
  await client.connect(transport);
  const available = await client.listTools();
  if (!['search', 'fetch'].every(name => available.tools.some(tool => tool.name === name))) {
    throw new Error('Las herramientas esperadas no están disponibles.');
  }
  const search = readTool(await client.callTool({
    name: 'search', arguments: { query: 'examen' }
  }));
  if (!search.results.length) {
    console.log('No se ha encontrado ninguna ficha.');
  } else {
    const record = readTool(await client.callTool({
      name: 'fetch', arguments: { id: search.results[0].id }
    }));
    console.log(JSON.stringify(record, null, 2));
  }
} finally {
  await client.close();
}
```

## Encontrar la versión actual de una información

La API y el servidor MCP dan acceso a las publicaciones públicas de TestAutoescuela. Las fichas siguen las actualizaciones del sitio, con un enlace a la página de origen y las referencias asociadas.

Antes de responder o de actualizar tu herramienta, vuelve a leer las fichas que te sirvan: encontrarás su versión en línea, sus fuentes y sus fechas. Una norma oficial puede cambiar: su fecha de verificación indica cuándo se contrastó con el texto.

## Reutilizar citando la fuente

Los contenidos públicos de TestAutoescuela pueden consultarse, citarse y resumirse para documentar una respuesta o construir una herramienta, también comercial, con una atribución visible y un enlace a la página utilizada: «Fuente: TestAutoescuela».

Conserva las referencias y las reservas que acompañan a la información. Indica las adaptaciones que hagas y distingue las normas oficiales de las explicaciones, del método y de las ofertas de TestAutoescuela.

Los documentos y recursos visuales de terceros siguen sujetos a sus propias condiciones. Para republicar íntegramente el temario o un artículo, pide autorización a {email}. El acceso a los datos no implica ninguna asociación ni aval de tu servicio por parte de TestAutoescuela ni de Permis Online SRL.

## Archivos y páginas de referencia

- [llms.txt](https://testautoescuela.es/llms.txt) : el índice del sitio para los asistentes de IA
- [llms-full.txt](https://testautoescuela.es/llms-full.txt) : el texto íntegro de los contenidos públicos
- [Información de referencia](https://testautoescuela.es/brand-facts/) : quién edita el sitio, qué ofrece, las normas oficiales con su fuente y su fecha
- [brand-facts.md](https://testautoescuela.es/brand-facts.md) : la información de referencia en Markdown
- [brand-facts.json](https://testautoescuela.es/.well-known/brand-facts.json) : la información de referencia en JSON
- [schema.json](https://testautoescuela.es/.well-known/schema.json) : todos los datos estructurados del sitio en un solo grafo
- [ai.json](https://testautoescuela.es/.well-known/ai.json) : el editor, el dominio oficial y los recursos para las IA
- [offers.json](https://testautoescuela.es/.well-known/offers.json) : las ofertas que realmente se ofrecen en España
- [Fuentes y referencias](https://testautoescuela.es/sources/) : los textos oficiales y todas las fuentes citadas
- [sources.txt](https://testautoescuela.es/sources.txt) : el registro de fuentes en texto
- [Mapa del sitio](https://testautoescuela.es/sitemap.xml) : todas las páginas públicas, sus imágenes y la arquitectura del sitio (XML para los robots, página legible en un navegador)
- [Gemelos Markdown](https://testautoescuela.es/index.md) : cada página pública en texto: su dirección seguida de .md (la página de inicio: /index.md)