MCP · Estimaciones de viajes en el Área de la Bahía

Una estimación clara de la tarifa, dondequiera que vaya.

Conecte un cliente remoto del Model Context Protocol para solicitar los precios vigentes del sitio web para un viaje en SUV privada por el Área de la Bahía de San Francisco, incluidos traslados a los aeropuertos SFO, OAK y SJC, viajes punto a punto y servicio por hora.

Punto de conexión MCP remoto
https://www.blackcarservice.co/api/mcp
Streamable HTTP · POST · sin autenticación
01 — Qué hace

Planifique su viaje y luego revíselo.

La herramienta de tarifas, quote_ride, estima el precio de una SUV con las tarifas vigentes del sitio web y devuelve el importe en centavos de USD, con la hora de recogida normalizada a UTC en la respuesta y una booking_url que completa previamente los datos de viaje compatibles en nuestra página de reservas.

Use check_ride_availability con los mismos datos para consultar la disponibilidad tentativa. Devuelve available, unavailable o unknown; un problema de conexión con el calendario devuelve unknown. Ninguna de las herramientas aparta un vehículo, crea una reserva ni procesa pagos. Los intentos de cotización incrementan los contadores agregados. Antes de reservar, revise en el sitio web su viaje, el precio final y la disponibilidad.

Continuar a la reserva
02 — Conecte un cliente

Conecte un cliente MCP compatible.

  1. 01

    Agregue un servidor remoto usando el punto de conexión anterior y el transporte Streamable HTTP. No se requiere una clave de API ni iniciar sesión.

  2. 02

    Inicialice la conexión MCP, consulte la lista de herramientas disponibles y luego llame a quote_ride con uno de los formatos de entrada que aparecen abajo.

  3. 03

    Solicite una estimación para una recogida futura. Use una dirección completa o un aeropuerto e incluya la ciudad y el estado.

Ver el manifiesto público del servidor MCP

Configuración de Hermes y Grok

Agente Hermes

Combine esta entrada con la sección existente mcp_servers del archivo ~/.hermes/config.yaml, y luego inicie un chat nuevo en Hermes.

Configuración de Hermes
mcp_servers:
  bcs_quotes:
    url: "https://www.blackcarservice.co/api/mcp"
    tools:
      include: ["quote_ride", "check_ride_availability"]
Instrucciones oficiales de Hermes

Conector personalizado de Grok

En la página Connectors de Grok, seleccione New Connector y luego Custom. Ingrese el punto de conexión anterior; BCS no requiere autenticación. Es posible que el administrador de las cuentas empresariales tenga que agregar primero el conector.

Los desarrolladores también pueden usar la API Responses de xAI con una herramienta MCP cuyo server_url sea nuestro punto de conexión y allowed_tools sea ["quote_ride", "check_ride_availability"]. xAI factura el uso de su API.

Instrucciones oficiales para el conector de Grok

El punto de conexión público superó una prueba de conexión del SDK de MCP y de estimación de tarifas. Estos pasos de configuración específicos siguen la documentación oficial de cada producto; BCS no ha probado sesiones de las aplicaciones Hermes ni Grok. Nuestro servidor figura en el registro oficial de MCP; cada cliente decide qué servidores ofrece o recomienda.

03 — Formatos de solicitud

Mantenga la solicitud sencilla.

Las fechas siguientes ilustran el formato; reemplácelas por la fecha futura de recogida del cliente. Cada solicitud requiere un tipo de viaje, direcciones de recogida y destino, una marca de tiempo de recogida ISO 8601 con su diferencia respecto a UTC y entre 1 y 6 pasajeros. Aclare la hora local de recogida prevista en California; el horario de verano cambia la diferencia respecto a UTC. Las fechas de recogida deben comenzar mañana en America/Los_Angeles.

Punto a punto · solo ida
{
  "trip_type": "one-way",
  "pickup_address": "1 Ferry Building, San Francisco, CA",
  "dropoff_address": "1 Market Street, San Francisco, CA",
  "pickup_at": "2026-10-14T09:00:00-07:00",
  "passengers": 2
}
Aeropuerto · SFO, OAK o SJC
{
  "trip_type": "airport",
  "pickup_address": "Oakland San Francisco Bay Airport (OAK), Oakland, CA",
  "dropoff_address": "1 Market Street, San Francisco, CA",
  "pickup_at": "2026-10-14T09:00:00-07:00",
  "passengers": 2
}
Por hora · se requieren horas
{
  "trip_type": "hourly",
  "pickup_address": "1 Market Street, San Francisco, CA",
  "dropoff_address": "1 Market Street, San Francisco, CA",
  "pickup_at": "2026-10-14T09:00:00-07:00",
  "passengers": 3,
  "hours": 4
}

Para el servicio por hora, repita la dirección de recogida como destino cuando el viaje regrese allí e indique hours entre 1 y 24. Omita hours en viajes de solo ida y al aeropuerto. No se admiten paradas, tramos de regreso, extras, códigos promocionales ni datos de clientes.

04 — Uso razonable

Límites compartidos de solicitudes.

Por dirección IP
30 solicitudes / 5 min
Todos los solicitantes en conjunto
300 solicitudes / 5 min

Cuando se alcanza un límite, el punto de conexión devuelve HTTP 429 con un encabezado Retry-After. Respete ese tiempo de espera antes de volver a intentarlo. Use un entorno de ejecución de cliente MCP del lado del servidor. No se admiten solicitudes directas desde otros sitios web.