Servidor MCP

El servidor MCP de Matchai permite que un asistente de IA busque los anuncios que los profesionales inmobiliarios han publicado en Matchai, abra un anuncio y consulte a un corredor. MCP, el Model Context Protocol, es el estándar abierto que usan los asistentes para llamar a herramientas externas.

El servidor es público y de solo lectura. No necesita cuenta, clave de API ni inicio de sesión, y solo devuelve datos publicados.

EndpointsCopiar el enlace de esta sección

TransporteCopiar el enlace de esta sección

El servidor habla MCP sobre Streamable HTTP, en su forma sin estado, con mensajes JSON-RPC 2.0.

• POST: envía un único mensaje JSON-RPC al endpoint. Una solicitud recibe 200 con un cuerpo application/json. Una notificación recibe 202 sin cuerpo.
• Sin sesiones. El servidor no emite ningún Mcp-Session-Id y no recuerda nada entre solicitudes, así que cada solicitud puede responderse por sí sola. Sigue de todos modos el handshake estándar, para que tu cliente también funcione con otros servidores.
• Sin flujo de eventos. GET y DELETE responden 405, que es la respuesta correcta para un servidor que no tiene nada que enviar por iniciativa propia. OPTIONS responde 204 para CORS.
• Sin lotes. Envía un mensaje por solicitud. Un array se rechaza con -32600.
• Versiones del protocolo: 2025-11-25, 2025-06-18 y 2025-03-26. initialize devuelve tu versión cuando el servidor la habla, y la más reciente en caso contrario. Si envías un encabezado MCP-Protocol-Version después de initialize, debe ser una de estas, o la solicitud falla con 400.
• Tamaño. El cuerpo de una solicitud puede tener hasta 256 KB.

El servidor responde a estos métodos:

Cualquier otro método responde -32601 (método no encontrado). El servidor no ofrece las funciones de prompts, registro ni autocompletado.

serverInfo.name es matchai-listings y serverInfo.version es una versión semántica. Cambia cuando se agrega una herramienta o un campo, o cuando cambia su estructura.

Acceso, datos y límitesCopiar el enlace de esta sección

• Autenticación. Ninguna. /.well-known/mcp.json declara authentication.required: false, y el servidor no pide ninguna clave, token ni inicio de sesión.
• Datos. Los anuncios publicados, y el perfil público de los corredores que han publicado un sitio, una Página Matchai o una tarjeta de presentación. El número de teléfono y la dirección de correo electrónico de un corredor aparecen solo cuando están publicados en esa tarjeta de presentación.
• Orden de los resultados. Por relevancia para la solicitud y por la fecha de la última actualización del anuncio. Ningún corredor puede pagar para cambiar el orden ni para aparecer.
• Límite de solicitudes. Cada dirección de origen puede hacer 600 solicitudes tools/call por minuto. Por encima de eso, la llamada devuelve un resultado de herramienta con isError: true y un mensaje que pide volver a intentarlo en un minuto. El límite se aplica solo a tools/call. Es una protección contra abusos, fijada lo bastante alta como para que un host de asistentes con mucho tráfico no la alcance.
• CORS. Abierto a todos los orígenes, así que funcionan las herramientas basadas en navegador como el MCP Inspector. El servidor no lee ninguna cookie ni credencial. Las respuestas preflight pueden almacenarse en caché durante 24 horas.
• Caché. Las respuestas se envían con Cache-Control: no-store.

Documentos de descubrimientoCopiar el enlace de esta sección

Matchai publica descripciones del servidor legibles por máquina. Todas son JSON, envían un ETag, respetan If-None-Match y permiten lecturas de origen cruzado.

Los sitios de los corredores y las Páginas Matchai sirven sus propias copias de estos documentos. Apuntan al mismo servidor MCP en matchai.co.

Conectar un asistenteCopiar el enlace de esta sección

ClaudeCopiar el enlace de esta sección

Para agregar el servidor a Claude Code desde una terminal:

claude mcp add --transport http matchai https://matchai.co/mcp

ChatGPTCopiar el enlace de esta sección

Otros clientesCopiar el enlace de esta sección

La mayoría de los clientes compatibles con servidores MCP remotos aceptan una URL en un archivo de configuración:

{
  "mcpServers": {
    "matchai": {
      "url": "https://matchai.co/mcp"
    }
  }
}

Los clientes que piden un tipo de transporte deben usar Streamable HTTP, sin autenticación.

Llamar al servidor desde tu propio códigoCopiar el enlace de esta sección

Los ejemplos usan curl. Cada solicitud es un único mensaje JSON-RPC.

curl -s https://matchai.co/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-11-25",
      "capabilities": {},
      "clientInfo": { "name": "my-client", "version": "0.1.0" }
    }
  }'

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2025-11-25",
    "capabilities": { "tools": {}, "resources": {} },
    "serverInfo": {
      "name": "matchai-listings",
      "title": "Matchai",
      "version": "1.0.0",
      "websiteUrl": "https://matchai.co"
    },
    "instructions": "Matchai is a real estate platform where licensed brokers in Québec and across Canada publish their listings. …"
  }
}

curl -s -i https://matchai.co/mcp \
  -H "Content-Type: application/json" \
  -d '{ "jsonrpc": "2.0", "method": "notifications/initialized" }'

curl -s https://matchai.co/mcp \
  -H "Content-Type: application/json" \
  -d '{ "jsonrpc": "2.0", "id": 2, "method": "tools/list" }'

curl -s https://matchai.co/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "search_listings",
      "arguments": { "query": "3 bedroom condo in Laval under 600k", "limit": 3 }
    }
  }'

ErroresCopiar el enlace de esta sección

Los problemas con el mensaje en sí son errores JSON-RPC. Los problemas que un modelo puede corregir, como un argumento incorrecto o una URL que no coincide con ningún anuncio, vuelven como un resultado de herramienta con isError: true y un mensaje que el modelo puede leer.