Locate2u MCP by usefulapi
Read stops, orders, trips and ratings; add notes to stops and shipments in Locate2u.
我该使用它吗
质量与安全性
发现(3)
- LOW在 locate2u_list_unassigned_shipments 中
- LOW在 locate2u_get_team_trips_summary 中
- LOW在 locate2u_team_travel_statistics 中
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高,可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中:
{
"mcpServers": {
"locate2u": {
"url": "https://locate2u.usefulapi.io/mcp"
}
}
}远程端点
https://locate2u.usefulapi.io/mcpstreamable-http它能做什么
工具清单
工具(34)
🟢locate2u_get_me
Get the user that owns the connected app: name, email, role, time zone. Locate2u API: GET /users/me.
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"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}.
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢locate2u_list_customers
List the team's customers. Locate2u API: GET /customers.
输入模式
{
"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.
输入模式
{
"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}.
输入模式
{
"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.
输入模式
{
"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}.
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"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}.
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"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}.
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"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}.
输入模式
{
"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}.
输入模式
{
"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}.
输入模式
{
"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}.
输入模式
{
"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}.
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"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}.
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"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"
}社区
证据