Serveur MCP

Hands for Agents

com.handsforagents/hands
Entreprise et opérations Commerce et retail Public et accessible MCP 2025-11-25

Ce que fait ce MCP

Coordinates quotes, payments, task status, delivery evidence, and disputes for human-performed physical-world services.

confirm_delivery
Confirm or dispute delivery
Accepts or disputes the delivery of a task. accepted=true closes the task and, for a card hold, captures it. accepted=false with a reason opens a dispute, answered by a human within 2 business days; it is possible at the evidence stage, before the balance is paid, as well as after delivery. Without either, the task counts as accepted 7 days after delivery. Returns the task status.
Destructif Accès externe
Schéma d’entrée
{'type': 'object', 'required': ['task_id', 'accepted', 'access_token'], 'properties': {'reason': {'type': 'string', 'description': 'Required when accepted is false: what differs from the quote.'}, 'task_id': {'type': 'string', 'description': 'Id of the task, of the form t_...'}, 'accepted': {'type': 'boolean', 'description': 'true accepts the delivery, false disputes it.'}, 'access_token': {'type': 'string', 'description': 'Access token of the quote and its task, issued with the quote.'}}}
create_task
Accept quote, get payment link
Accepts a quote and the terms of service (quote_id, access_token, terms_accepted=true, terms_version as stated in the quote) and creates the task. Returns task_id and checkout_url, the payment link for the first payment (the full price or a card hold up to 150 EUR, the deposit above); the payment is made by card on a Stripe Checkout page and the link is valid for 4 days. The contract is concluded when the payment is received or the hold authorised. A test order (test_mode true) has no checkout_url and no payment link: its payment is simulated by the operator after the order, so the response shows nothing paid or simulated. A repeated call for the same quote returns the same task.
Accès externe Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['quote_id', 'terms_accepted', 'terms_version', 'access_token'], 'properties': {'quote_id': {'type': 'string', 'description': 'Id of the quote, of the form q_...'}, 'access_token': {'type': 'string', 'description': 'Access token of the quote and its task, issued with the quote.'}, 'terms_version': {'type': 'string', 'description': 'Version of the terms being accepted, currently 2026-09-29.'}, 'terms_accepted': {'type': 'boolean', 'const': True, 'description': 'Acceptance of https://handsforagents.com/terms.html by the operator.'}, 'allow_anonymised_example': {'type': 'boolean', 'default': False, 'description': 'Optional. Consent to publish this task as an anonymised example (terms, section 10); true only when the client explicitly agreed. Default false.'}}}
get_status
Get status or answer operator
Returns the current status of a quote (id = quote_id) or a task (id = task_id): status, next_action (a short text on the next step), payments, updates, and messages with the operator (newest first, from operator or you). The answer is short: older_updates and older_messages count what is left out; full=true returns everything. With the optional message the call also stores a plain-text reply to the operator and e-mails it to the operator; message_sent is then true. While the operator has a message that has not been returned yet, the reply is not stored (message_sent: false) and the answer contains that message. The same text again within 10 minutes is ignored (duplicate_ignored: true). A status can change at any time; every call returns the state at that moment. test_mode true marks a test order: nothing is paid or invoiced.
Accès externe
Schéma d’entrée
{'type': 'object', 'required': ['id', 'access_token'], 'properties': {'id': {'type': 'string', 'description': 'quote_id or task_id.'}, 'full': {'type': 'boolean', 'default': False, 'description': 'true returns the complete answer.'}, 'message': {'type': 'string', 'description': 'Optional reply to the operator: plain text, 1-2000 characters. Without it the call is a plain status check.'}, 'access_token': {'type': 'string', 'description': 'Access token of the quote and its task, issued with the quote.'}}}
list_services
List services
Returns what the service does and does not do, the refused categories, prices and how to pay, as a short summary. No authentication. With full=true it returns the complete document (worked price examples, the full legal text, the marketplace comparison), which is many times larger.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {'full': {'type': 'boolean', 'default': False, 'description': 'true returns the complete document (the same as /services.json); false (default) returns a short summary.'}}}
request_quote
Request a quote
Creates a request for a fixed-price quote from a human. The request is not binding and nothing is charged. Required: description, email and name (the person or company on the invoice, normally the recipient or company in delivery_address). delivery_address is needed when a physical item is shipped, handed over or collected: one plain string with recipient, street, postcode and city, country; a phone number is optional. country is the ISO 3166-1 alpha-2 code of the address, vat_id only what the client provided. The fields are sent flat, as in the examples. Returns quote_id (of the form q_..., issued only in this response), access_token (shown once; the only key to the quote and its task), nda_url and upload_url (the address input files are POSTed to). A human answers within 24 hours, every day, with a quote or a refusal. No authentication. Shortest possible request: {"description":"Make 20 rubber gaskets, 60 mm outer diameter, black EPDM.","email":"ops@example.com","name":"Example Inc."}. With a delivery address and an input file: {"description":"Make 20 rubber gaskets, 60 mm outer diameter, black EPDM.","email":"ops@example.com","name":"Example Inc.","delivery_address":"Example GmbH, Musterstr. 1, 10115 Berlin, DE, +49 30 000000","input_files":["https://example.com/gasket-drawing.pdf"]}
Accès externe
Schéma d’entrée
{'type': 'object', 'required': ['description', 'email', 'name'], 'properties': {'name': {'type': 'string', 'pattern': '^[^\\r\\n]+$', 'maxLength': 200, 'minLength': 1, 'description': 'Required. The person or company on the invoice, normally the recipient or company in delivery_address.'}, 'email': {'type': 'string', 'format': 'email', 'pattern': '^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$', 'maxLength': 254, 'description': 'Contact e-mail of the operator; the quote is sent here.'}, 'vat_id': {'type': 'string', 'maxLength': 32, 'description': 'VAT or tax id for the invoice, as given by the client. Optional.'}, 'country': {'type': 'string', 'pattern': '^[A-Z]{2}$', 'description': "Operator's country, ISO 3166-1 alpha-2, upper case, normally that of the delivery address. Optional."}, 'currency': {'enum': ['EUR', 'USD'], 'type': 'string', 'description': 'EUR or USD. Default EUR.'}, 'deadline': {'type': 'string', 'format': 'date', 'maxLength': 32, 'description': 'Latest acceptable delivery date, ISO 8601. Optional.'}, 'services': {'type': 'array', 'items': {'enum': ['design', 'make', 'assemble', 'measure', 'test', 'verify', 'ship'], 'type': 'string'}, 'description': 'Service ids. Optional.'}, 'agent_name': {'type': 'string', 'maxLength': 200, 'description': 'Name of the agent or platform. Optional.'}, 'description': {'type': 'string', 'maxLength': 20000, 'description': 'What is to be done, plainly: quantity, material, colour, size, tolerances, what counts as done.'}, 'input_files': {'type': 'array', 'items': {'type': 'string', 'pattern': '^https://', 'maxLength': 2000}, 'maxItems': 20, 'description': 'HTTPS URLs of input files (photos, sketch, STEP/STL model, PDF drawing). At most 20.'}, 'deliverables': {'type': 'string', 'maxLength': 5000, 'description': 'What the client expects to receive. Optional; otherwise part of description.'}, 'delivery_address': {'type': 'string', 'maxLength': 1000, 'description': 'Required for a physical shipment. One plain string: recipient, street, postcode and city, country, as given by the client; a phone number last is optional.'}, 'allow_anonymised_example': {'type': 'boolean', 'default': False, 'description': 'Consent to publish this task as an anonymised example; true only when the client explicitly agreed. Default false.'}}}
Modifié
confirm_delivery
4 October 2026 02:42
Modifié
get_status
4 October 2026 02:42
Modifié
create_task
4 October 2026 02:42
Modifié
request_quote
4 October 2026 02:42
Modifié
list_services
4 October 2026 02:42
Modifié
confirm_delivery
2 October 2026 02:41
Modifié
get_status
2 October 2026 02:41
Modifié
create_task
2 October 2026 02:41
Modifié
request_quote
2 October 2026 02:41
Modifié
list_services
2 October 2026 02:41
Modifié
confirm_delivery
30 September 2026 02:41
Modifié
get_status
30 September 2026 02:41
Modifié
create_task
30 September 2026 02:41
Modifié
request_quote
30 September 2026 02:41
Modifié
list_services
30 September 2026 02:41
Modifié
create_task
28 September 2026 02:41
Modifié
request_quote
28 September 2026 02:41
Modifié
list_services
28 September 2026 02:41
Modifié
create_task
26 September 2026 02:41
Modifié
request_quote
26 September 2026 02:41
Ajouté
confirm_delivery
24 September 2026 02:40
Modifié
get_status
24 September 2026 02:40
Ajouté
create_task
24 September 2026 02:40
Modifié
request_quote
24 September 2026 02:40
Modifié
list_services
24 September 2026 02:40
Ajouté
get_status
20 September 2026 02:40
Ajouté
request_quote
20 September 2026 02:40
Ajouté
list_services
20 September 2026 02:40