Agentes de software

Publicado: 6 de noviembre de 2026

Las notas y las páginas de sección tienen versión en Markdown, el índice llms.txt las lista y un servidor MCP de solo lectura responde sobre la agenda, los lugares, las travesías y los datos verificados.

Este sitio se escribe para personas que andan en bicicleta. Algunos lectores ya llegan a través de un asistente que buscó y leyó por ellos, y a ese asistente le conviene encontrar el texto limpio, con sus fechas y sus fuentes, en lugar de reconstruirlo desde el HTML. Lo que sigue describe qué les ofrecemos a esos programas, qué pueden preguntar y qué queda registrado cuando lo hacen.

Qué se puede preguntar

Lo más directo es el servidor MCP (Model Context Protocol) que atiende en https://pedaleando.uy/mcp: transporte Streamable HTTP, sin autenticación, solo lectura. En https://pedaleando-uruguay.bike/mcp el mismo servidor responde con los textos en inglés cuando existe esa versión. Para conectarse alcanza con la URL; en Claude Code, por ejemplo:

claude mcp add --transport http pedaleando https://pedaleando.uy/mcp

Las herramientas:

• search_events y get_event consultan la agenda de /ciudad/agenda, con fecha, lugar y la fuente de cada evento.
• search_places y get_place devuelven los lugares sobre los que escribe el sitio, con coordenadas, un resumen y sus otros nombres.
• list_routes y get_route enumeran las travesías, con la URL de la nota y la de su versión en Markdown.
• search_articles y get_article buscan cualquier nota publicada y la devuelven en Markdown.
• lookup_fact busca entre los datos verificados que sostienen las notas y devuelve, para cada uno, su identificador, su valor y las fuentes consultadas, con la fecha de la última lectura, cuando la registramos. Un dato sin fuente no se sirve.

Cada cliente tiene un cupo de solicitudes. Si lo agota, el servidor rechaza las siguientes durante un rato y después vuelve a atender.

Qué hay para leer

Las notas y las páginas de sección tienen una versión en texto plano con el mismo contenido que la página: título, fechas de publicación y actualización, cuerpo, epígrafes y las fuentes del pie con sus créditos. Para obtenerla se agrega .md a la URL. La nota publicada en /ciudad/ciclovia-rambla-sur está también en /ciudad/ciclovia-rambla-sur.md. La página HTML sigue siendo la canónica y la versión en Markdown no se indexa; cada página HTML declara en su <head> si tiene versión en Markdown.

El índice /llms.txt enumera las páginas publicadas en este sitio, con una línea de resumen por página y el enlace a su versión en Markdown cuando existe. La edición en inglés mantiene el suyo en pedaleando-uruguay.bike/llms.txt.

Rastreadores

En /robots.txt las reglas van por clase: una para los buscadores, otra para los programas que leen una página a pedido de una persona, otra para los rastreadores que juntan material para entrenar modelos de lenguaje, y una general para el resto. Hoy ninguna prohíbe nada.

Qué queda registrado, y a quién avisar

Cuando el servidor MCP responde una consulta, anotamos qué herramienta se usó y con qué argumentos, cuántos resultados hubo, en qué idioma y desde qué dominio, y la cadena con la que el cliente se presenta (el user agent). Cuando quien pide una página se presenta con un user agent que reconocemos como programa (un rastreador, un buscador, un asistente), anotamos la hora, la URL, el código de respuesta, la página de origen si la hay y esa cadena. Las visitas de navegadores comunes no se guardan. No hay direcciones IP en esos registros. Los usamos para saber qué se busca y qué no supimos responder; eso decide, en parte, qué escribimos después.

Una advertencia sobre las fuentes: las del pie de una nota llevan la fecha en que las leímos por última vez, y las que devuelve lookup_fact la llevan solo si la registramos; un dato puede haber cambiado después. Si tu programa encontró un error, o hizo una pregunta que el servidor no supo responder, escribinos a hola@pedaleando.uy.