Locate2u MCP by usefulapi
Read stops, orders, trips and ratings; add notes to stops and shipments in Locate2u.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (3)
- LOWen locate2u_list_unassigned_shipments
- LOWen locate2u_get_team_trips_summary
- LOWen locate2u_team_travel_statistics
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"locate2u": {
"url": "https://locate2u.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://locate2u.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (34)
🟢locate2u_get_me
Get the user that owns the connected app: name, email, role, time zone. Locate2u API: GET /users/me.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_get_team
Get the connected team with its settings and branding. Locate2u API: GET /team.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_list_team_members(include_current_location, team_region_id)
List the drivers and staff in the team, optionally with their current location. Locate2u API: GET /team-members.
Esquema de entrada
{
"type": "object",
"properties": {
"include_current_location": {
"description": "Include each member's last known location.",
"type": "boolean"
},
"team_region_id": {
"description": "Only members of this region (from locate2u_list_team_regions).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_get_team_member(public_user_id)
Get one team member by public user id. Locate2u API: GET /team-members/{publicUserId}.
Esquema de entrada
{
"type": "object",
"properties": {
"public_user_id": {
"type": "string",
"description": "The member's publicUserId (from locate2u_list_team_members)."
}
},
"required": [
"public_user_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_list_team_regions
List the regions of the team. Locate2u API: GET /team-regions.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_list_warehouses(team_region_id)
List the team's warehouses. Locate2u API: GET /warehouses.
Esquema de entrada
{
"type": "object",
"properties": {
"team_region_id": {
"description": "Only warehouses of this region.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_list_services
List all services the team offers. Locate2u API: GET /services.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_list_customers
List the team's customers. Locate2u API: GET /customers.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_search_customers(search_text, page, per_page)
Search customers by text (name, company, email, phone). Locate2u API: GET /customers/search.
Esquema de entrada
{
"type": "object",
"properties": {
"search_text": {
"type": "string",
"description": "Text to search for."
},
"page": {
"description": "Page number (starts at 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 200
}
},
"required": [
"search_text"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_get_customer(customer_id)
Get one customer by id. Locate2u API: GET /customers/{id}.
Esquema de entrada
{
"type": "object",
"properties": {
"customer_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The customerId (from locate2u_list_customers)."
}
},
"required": [
"customer_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_search_orders(order_number, purchase_order_number, status, payment_status, customer_id, ...)
Search orders by order number, purchase order number, status, payment status, customer or date. Locate2u API: GET /orders/search.
Esquema de entrada
{
"type": "object",
"properties": {
"order_number": {
"type": "string"
},
"purchase_order_number": {
"type": "string"
},
"status": {
"description": "Order status.",
"type": "string"
},
"payment_status": {
"description": "Payment status.",
"type": "string"
},
"customer_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"order_date": {
"description": "Order date yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"page": {
"description": "Page number (starts at 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_get_order(order_id)
Get one order by id. Locate2u API: GET /orders/{id}.
Esquema de entrada
{
"type": "object",
"properties": {
"order_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The order id."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_find_order(order_number, source, source_reference)
Find a single order by its order number, or by a source and source reference pair. Locate2u API: GET /orders.
Esquema de entrada
{
"type": "object",
"properties": {
"order_number": {
"type": "string"
},
"source": {
"type": "string"
},
"source_reference": {
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_list_orders_created(from_date, to_date, include_stops, include_order_items, include_stop_items, ...)
List orders created between two dates, optionally with stops and items. Locate2u API: GET /orders/created.
Esquema de entrada
{
"type": "object",
"properties": {
"from_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start date yyyy-mm-dd."
},
"to_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End date yyyy-mm-dd."
},
"include_stops": {
"type": "boolean"
},
"include_order_items": {
"type": "boolean"
},
"include_stop_items": {
"type": "boolean"
},
"include_order_lines": {
"type": "boolean"
}
},
"required": [
"from_date",
"to_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_get_stop(stop_id, include_items, include_lines, include_tracking_link)
Get one stop (a delivery or pickup) with status, contact, address and time window. Locate2u API: GET /stops/{id}.
Esquema de entrada
{
"type": "object",
"properties": {
"stop_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The stopId."
},
"include_items": {
"type": "boolean"
},
"include_lines": {
"type": "boolean"
},
"include_tracking_link": {
"type": "boolean"
}
},
"required": [
"stop_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_search_stops(source_reference, include_items, include_lines, include_tracking_link)
Find stops by the source reference that the integration stored on them. Locate2u API: GET /stops/search.
Esquema de entrada
{
"type": "object",
"properties": {
"source_reference": {
"type": "string"
},
"include_items": {
"type": "boolean"
},
"include_lines": {
"type": "boolean"
},
"include_tracking_link": {
"type": "boolean"
}
},
"required": [
"source_reference"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_list_scheduled_stops(trip_date, team_region_id, include_shipments, skip, take)
List stops scheduled for a day (default: today in the team's zone), with paging. Locate2u API: GET /stops/scheduled.
Esquema de entrada
{
"type": "object",
"properties": {
"trip_date": {
"description": "Day yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"team_region_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"include_shipments": {
"type": "boolean"
},
"skip": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"take": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_list_unassigned_stops(trip_date, include_shipments, team_region_id)
List stops that no driver has yet. Locate2u API: GET /stops/unassigned.
Esquema de entrada
{
"type": "object",
"properties": {
"trip_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"include_shipments": {
"type": "boolean"
},
"team_region_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_list_stop_notes(stop_id)
List all notes on a stop, with attachments. Locate2u API: GET /stops/{id}/notes.
Esquema de entrada
{
"type": "object",
"properties": {
"stop_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"stop_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_get_stop_pod_answers(stop_id)
Get the answers a driver gave to the proof-of-delivery questions on a stop. Locate2u API: GET /stops/{id}/podquestionanswers.
Esquema de entrada
{
"type": "object",
"properties": {
"stop_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"stop_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_get_shipment(shipment_id, include_cost_and_charge_lines, include_tracking_link)
Get a shipment with its pickup and drop stops and items. Locate2u API: GET /shipments/{id}.
Esquema de entrada
{
"type": "object",
"properties": {
"shipment_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"include_cost_and_charge_lines": {
"type": "boolean"
},
"include_tracking_link": {
"type": "boolean"
}
},
"required": [
"shipment_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_list_unassigned_shipments(trip_date, pickup_within_km_distance, team_region_id)
List shipments that no team member has yet. Locate2u API: GET /shipments/unassigned.
Esquema de entrada
{
"type": "object",
"properties": {
"trip_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"pickup_within_km_distance": {
"type": "number",
"exclusiveMinimum": 0
},
"team_region_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_list_shipment_notes(shipment_id)
List all notes on a shipment. Locate2u API: GET /shipments/{id}/notes.
Esquema de entrada
{
"type": "object",
"properties": {
"shipment_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"shipment_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_get_team_trips_summary(trip_date)
Summary of every trip in the team on a day: driver, distance, time, stop counts, status. Locate2u API: GET /team/trips/{tripDate}.
Esquema de entrada
{
"type": "object",
"properties": {
"trip_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"trip_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_list_team_trips(trip_date)
All trips (assigned and unassigned) for a day, each with its driver and stops. Locate2u API: GET /trips/team/{tripDate}.
Esquema de entrada
{
"type": "object",
"properties": {
"trip_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"trip_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_get_driver_trip(public_user_id, trip_date, status, include_lines)
Get the trip of one team member on a day, optionally filtered by status. Locate2u API: GET /trips/user/{publicUserId}/{tripDate}.
Esquema de entrada
{
"type": "object",
"properties": {
"public_user_id": {
"type": "string"
},
"trip_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"status": {
"type": "string"
},
"include_lines": {
"type": "boolean"
}
},
"required": [
"public_user_id",
"trip_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_get_trip(trip_id, include_lines)
Get one trip by id with its stops. Locate2u API: GET /trips/id/{id}.
Esquema de entrada
{
"type": "object",
"properties": {
"trip_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"include_lines": {
"type": "boolean"
}
},
"required": [
"trip_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_list_runs(trip_date, team_member, customer_id, run_number)
List the runs scheduled for a day, optionally for one team member, customer or run number. Locate2u API: GET /runs/{tripDate}.
Esquema de entrada
{
"type": "object",
"properties": {
"trip_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"team_member": {
"type": "string"
},
"customer_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"run_number": {
"type": "string"
}
},
"required": [
"trip_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_team_travel_statistics(from_date, to_date, team_region_id)
Distance and time driven by the team's members and asset groups over a date range. Locate2u API: GET /team/reports/travel-statistics.
Esquema de entrada
{
"type": "object",
"properties": {
"from_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"to_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"team_region_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_list_customer_ratings(team_id, start_date, end_date, higher_ratings, lower_ratings)
Delivery ratings that customers left for the team's stops over a date range. Locate2u API: GET /team/{teamId}/customer-ratings.
Esquema de entrada
{
"type": "object",
"properties": {
"team_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The team id (from locate2u_get_team)."
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"higher_ratings": {
"type": "boolean"
},
"lower_ratings": {
"type": "boolean"
}
},
"required": [
"team_id",
"start_date",
"end_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_search_items(keyword, warehouse_id, item_status, location_status, page, ...)
Search inventory items by keyword, warehouse or status. Locate2u API: GET /items/search.
Esquema de entrada
{
"type": "object",
"properties": {
"keyword": {
"type": "string"
},
"warehouse_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"item_status": {
"type": "string"
},
"location_status": {
"type": "string"
},
"page": {
"description": "Page number (starts at 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_get_item(item_id)
Get one inventory item by id. Locate2u API: GET /items/{id}.
Esquema de entrada
{
"type": "object",
"properties": {
"item_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"item_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴locate2u_add_stop_note(stop_id, note)
WRITE: add a text note to a stop. It is visible to the team and the driver. Each call adds a new note (do not retry blindly). Locate2u API: POST /stops/{id}/notes.
Esquema de entrada
{
"type": "object",
"properties": {
"stop_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"note": {
"type": "string",
"minLength": 1,
"maxLength": 4000,
"description": "The note text."
}
},
"required": [
"stop_id",
"note"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴locate2u_add_shipment_note(shipment_id, note, stop_id)
WRITE: add a text note to a shipment, optionally tied to one of its stops. Each call adds a new note (do not retry blindly). Locate2u API: POST /shipments/{id}/notes.
Esquema de entrada
{
"type": "object",
"properties": {
"shipment_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"note": {
"type": "string",
"minLength": 1,
"maxLength": 4000,
"description": "The note text."
},
"stop_id": {
"description": "A stop of the shipment the note belongs to.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"shipment_id",
"note"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Comunidad
Evidencia