MyFlohmarkt

Servidor MCP remoto de solo lectura para buscar eventos actuales de mercados de pulgas (Flohmarkt) alemanes por texto, ciudad, rango de fechas o radio. Herramientas: search_events, get_event, recently_updated_events. Endpoint: https://mcp.my-flohmarkt.de/mcp (HTTP transmisible, sin autenticación).

GitHubPrueba este MCPPatrocinado

Documentación

Servidor MCP myFlohmarkt

Servidor MCP público y de solo lectura para mercados de pulgas alemanes — Flohmarkt, Trödelmarkt, Hofflohmarkt, Kinderflohmarkt, Nachtflohmarkt, Antik- und Sammlermarkt — del catálogo detrás de my-flohmarkt.de.

https://mcp.my-flohmarkt.de/mcp
  • Transporte: HTTP Streamable (POST). El servidor no tiene estado — no hay id de sesión que transportar entre llamadas. GET devuelve 405: no hay flujo SSE, porque el servidor no envía notificaciones iniciadas por el servidor.
  • Autenticación: ninguna. Cada herramienta es de solo lectura y pública.
  • Protocolo: negocia hasta la revisión 2025-11-25, y retrocede a lo que el cliente solicite.
  • Registro: de.my-flohmarkt/flea-market-catalog en el registro oficial de MCP, con espacio de nombres verificado por DNS.

Este repositorio contiene documentación y ejemplos. No es el código fuente del servidor, y deliberadamente no conserva ninguna copia de server.json: el enlace al registro anterior sirve los metadatos actuales, por lo que no hay nada aquí que pueda quedar desactualizado.

Herramientas

Las tres declaran un outputSchema y responden con structuredContent junto al bloque de texto, de modo que el cliente obtiene un resultado tipado en lugar de una cadena JSON que analizar. Todas están anotadas readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false.

search_events

Búsqueda por texto libre, por ciudad o código postal (PLZ) mediante el mismo argumento city, por rango de fechas, o por radio alrededor de una coordenada.

argumentotiponotas
querystringtexto libre, ≤ 200 caracteres
citystringnombre de ciudad o PLZ, ≤ 100 caracteres
dateFrom, dateTostringYYYY-MM-DD
lat, lng, radiusKmnumberlos tres requeridos juntos, radio ≤ 100 km
limitinteger1–50, predeterminado 10

Devuelve { items, total, totalIsLowerBound, dataAsOf }. Cada elemento lleva id, title, date, timeFrom, timeTo, plz, city, lat, lng, marketType, imageUrl, updatedAt y url — la página pública del evento.

get_event

Detalle completo de un evento por su UUID, tal como se devuelve en el campo id de las otras dos herramientas: descripción, dirección postal, horarios de apertura, tipo de mercado y temas, tarifa de entrada y tarifa del puesto para vendedores, tamaños de puestos y alquiler de mesas, y si los vendedores aún pueden inscribirse. Los UUID desconocidos o no públicos devuelven { "error": "not_found" }.

recently_updated_events

Los eventos agregados o modificados más recientemente, del más nuevo al más antiguo. Úsalo para ver qué hay nuevo sin una consulta; usa search_events cuando conozcas la ciudad, el PLZ, las fechas o el área.

Conexión

Claude Code:

claude mcp add --transport http myflohmarkt https://mcp.my-flohmarkt.de/mcp

Cualquier cliente que lea mcp.json (VS Code, Cursor, …):

{
  "servers": {
    "myflohmarkt": {
      "type": "http",
      "url": "https://mcp.my-flohmarkt.de/mcp"
    }
  }
}

JSON-RPC puro, sin necesidad de cliente — consulta examples/.

Sin MCP

El mismo catálogo se sirve como REST simple para clientes que no hablan MCP:

GET https://mcp.my-flohmarkt.de/events/search?city=Hamburg&limit=10

El contexto legible por máquina para agentes está en llms.txt y llms-full.txt; el contrato REST está en openapi.json.

Límites y actualidad

  • 1200 solicitudes por minuto por IP, 32 concurrentes. Al superar el límite, el servidor responde 429 con un encabezado retry-after.
  • Bajo carga pesada, una herramienta puede responder { "error": "duckdb_query_overloaded", "retryAfterSeconds": n } en lugar de bloquear — reintenta después de esa cantidad de segundos.
  • Las respuestas provienen de una instantánea del catálogo actualizada cada hora. Cada resultado de lista lleva dataAsOf para que puedas ver qué tan actualizados están los datos. Cobertura y metodología: datenstand.

Privacidad

El servidor no requiere cuenta y no establece cookies. La telemetría de solicitudes almacena un hash HMAC con sal de la IP del cliente (truncada), nunca la dirección sin procesar, y solo una clasificación del agente de usuario — no el encabezado sin procesar. El texto de las consultas y los argumentos de las herramientas no se registran. Política completa: Datenschutz.

Estabilidad y versionado

Los nombres de las herramientas y sus argumentos son un contrato público y se tratan como de escritura única: nunca se renombran ni se les agrega un argumento obligatorio nuevo. Los cambios son aditivos — un nuevo argumento opcional, un nuevo campo en un resultado — de modo que un cliente escrito para las herramientas actuales sigue funcionando.

La versión que puedes observar es serverInfo.version de initialize, y coincide con la versión publicada en el registro, que es donde reside la metadatos legibles por máquina:

https://registry.modelcontextprotocol.io/v0.1/servers/de.my-flohmarkt%2Fflea-market-catalog/versions/latest

Romper cualquier parte de ese contrato significaría una nueva herramienta junto a la antigua, no un cambio silencioso en la existente.

Enlaces