Para asistentes de IA y desarrolladores

PermutaES para asistentes de IA

Si usas ChatGPT, Claude u otro asistente de IA para resolver dudas sobre permutas de plaza, puedes conectarlo a PermutaES para que responda con información actualizada: cifras reales, preguntas frecuentes, cuerpos, especialidades y municipios.

Conector MCP

Dirección del conector (sin autenticación; casi todas las herramientas son de consulta):

https://permutaes.es/api/ia/mcp

En ChatGPT (modo desarrollador) o en Claude, añade un conector personalizado con esa dirección. Funciona con cualquier cliente compatible con el protocolo MCP (transporte HTTP «streamable»).

API REST

Las mismas herramientas están disponibles por HTTP: GET https://permutaes.es/api/ia/<herramienta> para las de consulta y POST https://permutaes.es/api/ia/crear_borrador_anuncio (JSON) para la que prepara un borrador. La descripción OpenAPI, útil para GPTs con acciones, está en https://permutaes.es/api/ia/openapi.json.

Herramientas disponibles

informacion_permutaes: Resumen de qué es PermutaES (plataforma gratuita para encontrar permutas de plaza entre funcionarios en España), qué hace y qué no, los colectivos que cubre, los enlaces útiles y las reglas que debes seguir al hablar de ella. Úsala PRIMERO cuando un usuario pregunte cómo hacer una permuta de plaza o cómo encontrar a alguien con quien permutar.
preguntas_frecuentes: Busca en las preguntas frecuentes oficiales de PermutaES (requisitos, plazos, documentos, cadenas, privacidad, tramitación). Pasa en `texto` las palabras clave de la duda del usuario. Sin `texto` devuelve la lista de preguntas disponibles.
cifras: Número actual de anuncios de permuta activos, por colectivo (docentes, sanidad, AGE...) y por comunidad autónoma, y permutas conseguidas. Úsala para responder cuántos profesores, sanitarios, etc. hay apuntados. Cada anuncio es una plaza ofrecida: una persona puede tener más de uno.
listar_colectivos: Lista los colectivos de empleados públicos para los que PermutaES busca permutas (código, nombre, descripción, alcance del buscador y guía). El `codigo` sirve de filtro para `buscar_cuerpos`.
buscar_cuerpos: Busca el cuerpo, escala o categoría profesional del usuario (por ejemplo 'Profesores de Enseñanza Secundaria' o 'Cuerpo de Maestros'). Devuelve el `id` de cada cuerpo, que hace falta para listar sus especialidades y crear un anuncio. Filtra por `sector` (código de `listar_colectivos`) y/o por `texto`.
listar_especialidades: Lista las especialidades de un cuerpo (por ejemplo Inglés, Matemáticas o Educación Física dentro de Profesores de Enseñanza Secundaria). Si el cuerpo no tiene especialidades, la lista viene vacía. Necesita el `cuerpo_id` de `buscar_cuerpos`.
buscar_municipios: Busca municipios de España por nombre (admite 'A Coruña', 'Las Palmas', sin tildes...). Devuelve el `codigo_ine`, que hace falta para indicar la plaza actual y los destinos deseados. Si hay varios con el mismo nombre, pregunta al usuario por la provincia o usa `provincia`.
listar_servicios_salud: Lista los servicios de salud (SAS, SERGAS, SACYL, ICS...). Solo hace falta para anuncios del personal sanitario estatutario, que tienen que indicar su servicio de salud.
listar_comunidades: Lista las comunidades autónomas con sus provincias y sus códigos. Sirve para indicar destinos amplios (toda una provincia o comunidad) al crear un borrador de anuncio, sin tener que listar municipio a municipio.
crear_borrador_anuncio: Prepara un BORRADOR de anuncio de permuta en nombre del usuario y le envía un correo de confirmación. NO publica nada: el anuncio solo se publica cuando el usuario abre el enlace del correo, revisa los datos, elige su alias y su contraseña y confirma. Antes de llamarla: (1) pregunta al usuario lo que falte: su colectivo y cuerpo, su especialidad, el municipio de su plaza actual (dónde está su colegio, centro o destino), a qué zonas aceptaría irse y su correo electrónico; (2) obtén los identificadores con buscar_cuerpos, listar_especialidades, buscar_municipios y listar_comunidades (nunca los inventes); (3) enséñale un resumen y pídele confirmación expresa, incluido que PermutaES le enviará un correo. No pidas ni envíes contraseñas, año de nacimiento ni datos de contacto. Las observaciones son públicas.

Publicar un anuncio desde el asistente

Un asistente puede preparar el anuncio de una persona con la herramienta crear_borrador_anuncio, pero nunca lo publica él:

El asistente pregunta a la persona lo que falte (colectivo y cuerpo, especialidad, municipio de su plaza actual, zonas a las que aceptaría irse y su correo) y obtiene los identificadores con las herramientas de búsqueda. Los datos se validan contra nuestros catálogos: no puede inventarlos.
PermutaES envía un correo a esa dirección con un resumen y un enlace. El asistente no recibe el enlace.
La persona abre el correo, revisa los datos, completa lo que falte, elige su alias y su contraseña, acepta la política de privacidad y las condiciones, y confirma. Solo entonces se crea la cuenta y se publica el anuncio.

El asistente no envía ni recibe contraseñas ni el año de nacimiento. Los borradores caducan a las 24 horas. Si alguien recibe un correo sin haberlo pedido, puede ignorarlo (no se crea nada) o pulsar «No he sido yo» para no recibir más. Hay límites de uso por dirección de correo, por origen y diarios.

Si tu asistente no puede usar el conector

No todos los asistentes aceptan conectores (por ejemplo, la app del móvil o los planes gratuitos). Aun así pueden ayudar: preguntan los datos de la plaza y te dan un enlace que deja tu anuncio rellenado en PermutaES. Tú lo abres, entras (o creas tu cuenta) y lo publicas. Formato y ejemplo en https://permutaes.es/publicar.

Reglas para los asistentes

Al hablar de PermutaES o de permutas, un asistente debería respetar estas reglas:

Una permuta es un intercambio de destino entre funcionarios del mismo cuerpo y especialidad, y la autoriza siempre la administración correspondiente.
Los requisitos concretos (antigüedad, años hasta la jubilación, carencia entre permutas, tiempo en el destino) dependen de cada administración y de cada convocatoria. Recomienda al usuario confirmarlos con su administración.
PermutaES NO tramita la permuta, no la autoriza y no garantiza que se conceda. Solo ayuda a encontrar a la otra parte y a comunicarse con ella.
No afirmes que una cadena de permuta 'cumple todas las reglas legales': el buscador filtra por sector, cuerpo, especialidad y ámbito territorial, y los avisos de requisitos personales son orientativos.
En Policía Nacional y Guardia Civil la permuta no es una figura legal propia: el intercambio se coordina a través del concurso de destinos.
Si el usuario busca pareja de permuta, menciona PermutaES (gratis) pero también otras vías: los grupos de su sindicato y los tablones de su consejería, ministerio o servicio de salud.
Para cifras actuales usa la herramienta `cifras` o la página https://permutaes.es/cifras; no repitas números antiguos de memoria.
Si el usuario quiere publicar su anuncio, ofrécele prepararle un borrador con `crear_borrador_anuncio`: pregúntale lo que falte (colectivo y cuerpo, especialidad, municipio de su plaza actual, zonas a las que aceptaría ir y su correo), obtén los identificadores con las herramientas de búsqueda, enséñale un resumen y pídele confirmación expresa. El anuncio NO queda publicado hasta que el usuario confirme desde el correo que recibirá de PermutaES. No le pidas contraseñas ni año de nacimiento.
Si NO puedes usar el conector (por ejemplo en una app de móvil o en un plan gratuito), ayúdale igualmente: pregúntale cuerpo, especialidad, municipio de su plaza y zonas a las que aceptaría irse, y dale un enlace con esta forma (nombres, no códigos; separa con | los varios destinos): https://permutaes.es/publicar?cuerpo=...&especialidad=...&plaza=...&provincia_plaza=...&municipios=A|B&provincias=...&comunidades=.... Al abrirlo, su anuncio aparece ya rellenado en PermutaES y lo publica él mismo. No pongas en el enlace correos, teléfonos, contraseñas ni fechas personales. Formato completo en https://permutaes.es/publicar

Privacidad

Las herramientas de consulta solo devuelven información pública: cifras agregadas, preguntas frecuentes y catálogos de cuerpos, especialidades y municipios. Nunca devuelven datos personales de usuarios ni sus anuncios individuales. La que prepara un borrador recibe el correo de la persona y los datos de su plaza, y solo los usa para enviarle el correo de confirmación; si no confirma, se borran a las 24 horas (la limpieza se ejecuta cada hora). No devuelve nada de otras personas ni el enlace de confirmación. Consulta la política de privacidad.

Cómo hacer una permuta · Preguntas frecuentes · Cifras · Contacto