robomart
Driverless delivery.
Should I use this
Quality & Safety
Findings (1)
- LOWTool 'get_proof' description lacks action verbin get_proof
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"robomart": {
"url": "https://mcp.robomart.ai/mcp"
}
}
}Remote endpoints
https://mcp.robomart.ai/mcpstreamable-httpWhat it can do
Tool inventory
Tools (11)
🟢list_stores(status, visibility, limit, starting_after, robomart_version)
Stores this organization owns, with status, visibility, radius and activation. Use the store id to check coverage and book. Filter by status or visibility; page with starting_after.
Input Schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"pending",
"live",
"paused"
]
},
"visibility": {
"type": "string",
"enum": [
"private",
"open"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"starting_after": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"robomart_version": {
"type": "string",
"enum": [
"2026-09-04",
"2026-09-06",
"2026-10-06"
]
}
},
"required": [],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡register_store(name, address, robot_spot, hours, radius_miles, ...)
Register a store: a real place whose owner promises to load the robot. Send the name, the address, at least one alert channel the store owns (relay, webhook, sms or voice), and optionally where the robot parks (robot_spot), hours inside 10:00 to 22:00, the coverage radius (default 2 miles, maximum 5), private or open visibility, loading notes and your own external_ref. The store starts pending; the activation check makes it live.
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"address": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"pattern": "\\S"
},
"robot_spot": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"lng": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"note": {
"type": "string",
"maxLength": 200
}
},
"required": [
"lat",
"lng"
],
"additionalProperties": false
},
"hours": {
"maxItems": 14,
"type": "array",
"items": {
"type": "object",
"properties": {
"day": {
"type": "string",
"enum": [
"mon",
"tue",
"wed",
"thu",
"fri",
"sat",
"sun"
]
},
"open": {
"type": "string",
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$"
},
"close": {
"type": "string",
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$"
}
},
"required": [
"day",
"open",
"close"
],
"additionalProperties": false
}
},
"radius_miles": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5
},
"visibility": {
"type": "string",
"enum": [
"private",
"open"
]
},
"alert_channels": {
"minItems": 1,
"maxItems": 8,
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"relay",
"webhook",
"sms",
"voice"
]
},
"target": {
"type": "string",
"minLength": 1,
"maxLength": 400
}
},
"required": [
"kind",
"target"
],
"additionalProperties": false
}
},
"loading_notes": {
"type": "string",
"maxLength": 2000
},
"perishables_after_hours": {
"type": "string",
"enum": [
"return_at_opening",
"dispose"
]
},
"external_ref": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"robomart_version": {
"type": "string",
"enum": [
"2026-09-04",
"2026-09-06",
"2026-10-06"
]
}
},
"required": [
"name",
"address",
"alert_channels"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡update_store(store_id, name, address, robot_spot, hours, ...)
Change a store you own: name, address, robot spot, hours, radius, visibility, alert channels, loading notes, perishables setting or external_ref; status pauses (paused) and resumes (live) a store. A pending store becomes live only through the activation check. Changing a live store's address or robot spot returns it to pending.
Input Schema
{
"type": "object",
"properties": {
"store_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"address": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"pattern": "\\S"
},
"robot_spot": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"lng": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"note": {
"type": "string",
"maxLength": 200
}
},
"required": [
"lat",
"lng"
],
"additionalProperties": false
},
"hours": {
"maxItems": 14,
"type": "array",
"items": {
"type": "object",
"properties": {
"day": {
"type": "string",
"enum": [
"mon",
"tue",
"wed",
"thu",
"fri",
"sat",
"sun"
]
},
"open": {
"type": "string",
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$"
},
"close": {
"type": "string",
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$"
}
},
"required": [
"day",
"open",
"close"
],
"additionalProperties": false
}
},
"radius_miles": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5
},
"visibility": {
"type": "string",
"enum": [
"private",
"open"
]
},
"alert_channels": {
"minItems": 1,
"maxItems": 8,
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"relay",
"webhook",
"sms",
"voice"
]
},
"target": {
"type": "string",
"minLength": 1,
"maxLength": 400
}
},
"required": [
"kind",
"target"
],
"additionalProperties": false
}
},
"loading_notes": {
"type": [
"string",
"null"
],
"maxLength": 2000
},
"perishables_after_hours": {
"type": "string",
"enum": [
"return_at_opening",
"dispose"
]
},
"external_ref": {
"type": [
"string",
"null"
],
"minLength": 1,
"maxLength": 200
},
"status": {
"type": "string",
"enum": [
"live",
"paused"
]
},
"robomart_version": {
"type": "string",
"enum": [
"2026-09-04",
"2026-09-06",
"2026-10-06"
]
}
},
"required": [
"store_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"minProperties": 2
}🟢find_stores(address, radius_miles, limit, robomart_version)
Live open stores near a drop-off address, nearest first, with whether each one's coverage radius reaches the address. Any account may book from an open store with an order_ref the store recognizes.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"minLength": 1,
"maxLength": 400
},
"radius_miles": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"robomart_version": {
"type": "string",
"enum": [
"2026-09-04",
"2026-09-06",
"2026-10-06"
]
}
},
"required": [
"address"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢check_coverage(store_id, pickup_address, dropoff_address, ready_at, parcel, ...)
Can this store deliver to this address at this ready time? Send store_id (a registered store) and dropoff_address; ready_at defaults to now. Checks the store's status, hours and coverage radius, the 5-mile network maximum and the zone, and returns the $2.99 fee and the arrival window. Capacity is answered at booking.
Input Schema
{
"type": "object",
"properties": {
"store_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"pickup_address": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"pattern": "\\S"
},
"dropoff_address": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"pattern": "\\S"
},
"ready_at": {
"type": "string",
"format": "date-time"
},
"parcel": {
"type": "object",
"properties": {
"weight_lb": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000
},
"length_in": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 200
},
"width_in": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 200
},
"height_in": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 200
}
},
"additionalProperties": false
},
"robomart_version": {
"type": "string",
"enum": [
"2026-09-04",
"2026-09-06",
"2026-10-06"
]
}
},
"required": [
"dropoff_address"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"required": [
"store_id"
]
},
{
"required": [
"pickup_address"
]
}
]
}🔴book_delivery(store_id, order_ref, ready_at, pickup_address, pickup_name, ...)
Book a $2.99 robot delivery from a registered store in one call. Send store_id, dropoff_address and dropoff_phone; order_ref is the store's own order number (required at an open store); ready_at starts the 2-hour promise and defaults to now. The answer is yes or no now: a decline carries retry_after_seconds and a capacity.available webhook follows when capacity frees. A live key holds the posted price from the organization's Wallet; a test key creates a simulated robot delivery.
Input Schema
{
"type": "object",
"properties": {
"store_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"order_ref": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"ready_at": {
"type": "string",
"format": "date-time"
},
"pickup_address": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"pattern": "\\S"
},
"pickup_name": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"merchant_order_reference": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"dropoff_address": {
"type": "string",
"minLength": 1,
"maxLength": 400,
"pattern": "\\S"
},
"pickup_phone": {
"type": "string",
"minLength": 7,
"maxLength": 25,
"pattern": "^(?=(?:\\D*\\d){7,15}\\D*$)\\+?[0-9()\\-.\\s]+$"
},
"dropoff_phone": {
"type": "string",
"minLength": 7,
"maxLength": 25,
"pattern": "^(?=(?:\\D*\\d){7,15}\\D*$)\\+?[0-9()\\-.\\s]+$"
},
"parcel": {
"type": "object",
"properties": {
"weight_lb": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000
},
"length_in": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 200
},
"width_in": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 200
},
"height_in": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 200
}
},
"additionalProperties": false
},
"declared_value_cents": {
"type": "integer",
"minimum": 0,
"maximum": 10000000
},
"metadata": {
"type": "object",
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 40
},
"additionalProperties": {
"type": "string",
"maxLength": 500
},
"maxProperties": 20
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 255
},
"robomart_version": {
"type": "string",
"enum": [
"2026-09-04",
"2026-09-06",
"2026-10-06"
]
}
},
"required": [
"dropoff_address",
"dropoff_phone",
"idempotency_key"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"required": [
"store_id"
]
},
{
"required": [
"pickup_address"
]
}
]
}🟢track_delivery(delivery_id, robomart_version)
The current Delivery, including store_id, store_name, order_ref, ready_at, promised_by and the pickup and return timestamps. Test deliveries are simulated.
Input Schema
{
"type": "object",
"properties": {
"delivery_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"robomart_version": {
"type": "string",
"enum": [
"2026-09-04",
"2026-09-06",
"2026-10-06"
]
}
},
"required": [
"delivery_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🔴cancel_delivery(delivery_id, robomart_version)
Cancel before pickup; a successful cancellation releases the full fee hold. The owner of an open store may use this on another account's booking inside the decline window: that records store.declined and cancels with cancel_reason store_declined. After pickup the call returns not_cancellable. Safe to retry.
Input Schema
{
"type": "object",
"properties": {
"delivery_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"robomart_version": {
"type": "string",
"enum": [
"2026-09-04",
"2026-09-06",
"2026-10-06"
]
}
},
"required": [
"delivery_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_proof(delivery_id, robomart_version)
Proof of a delivered Delivery, with its store_id and order_ref. Sandbox proof is explicitly marked simulated.
Input Schema
{
"type": "object",
"properties": {
"delivery_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"robomart_version": {
"type": "string",
"enum": [
"2026-09-04",
"2026-09-06",
"2026-10-06"
]
}
},
"required": [
"delivery_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢wallet_balance(robomart_version)
The Wallet balance for this organization and environment: available, held, this month's spend and the auto top-up setting. Reading only.
Input Schema
{
"type": "object",
"properties": {
"robomart_version": {
"type": "string",
"enum": [
"2026-09-04",
"2026-09-06",
"2026-10-06"
]
}
},
"required": [],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢request_topup(amount_credited, note, robomart_version)
Ask for a Wallet top-up of amount_credited cents (2000 to 1000000). The reply carries a signed confirmation link that a person completes in Console; no money moves until they do, and the link expires after 24 hours. Track it with GET /v1/topups/request/{id}.
Input Schema
{
"type": "object",
"properties": {
"amount_credited": {
"type": "integer",
"minimum": 2000,
"maximum": 1000000
},
"note": {
"type": "string",
"maxLength": 200
},
"robomart_version": {
"type": "string",
"enum": [
"2026-09-04",
"2026-09-06",
"2026-10-06"
]
}
},
"required": [
"amount_credited"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Community
Evidence