Locate2u MCP by usefulapi
Read stops, orders, trips and ratings; add notes to stops and shipments in Locate2u.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (3)
- LOWTool 'locate2u_list_unassigned_shipments' name length outside 3-30 rangein locate2u_list_unassigned_shipments
- LOWTool 'locate2u_get_team_trips_summary' name length outside 3-30 rangein locate2u_get_team_trips_summary
- LOWTool 'locate2u_team_travel_statistics' name length outside 3-30 rangein locate2u_team_travel_statistics
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"locate2u": {
"url": "https://locate2u.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://locate2u.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (34)
🟢locate2u_get_me
Get the user that owns the connected app: name, email, role, time zone. Locate2u API: GET /users/me.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_list_customers
List the team's customers. Locate2u API: GET /customers.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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"
}Community
Nachweis