io.github.CloudCorpRecordsPublished by GitHub account CloudCorpRecordsv0.1.0Updated Nov 7, 2026
Commission physical-world tasks from a human service: list services, request quotes, track.
Connects an assistant to a human service desk for physical-world jobs: browse the service catalogue, request a fixed-price quote, and check its status.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Follow the launch instructions in the repository.
Some jobs need a person in the physical world: something made, measured, assembled, tested, or shipped. handwork is a small MCP server that connects an agent to a human service desk that takes on exactly that kind of work. It exposes three tools — a service catalogue, a quote request, and a status lookup — and forwards each call to the desk's public remote endpoint, returning the answer unchanged.
Asking for a quote is not placing an order. Nothing is charged and nothing is made until a quote comes back by e-mail and is accepted there; the tools themselves carry no ordering or payment capability.
list_services — what the service will and will not do, the
categories it refuses, example prices, how payment works, and
the key contract terms. Takes no arguments and needs no
authentication.request_quote — describe a physical-world task (what is to
be done, which services it needs, deliverables, deadline,
delivery address, input files, currency) along with the
client's invoice details, and a human screens it and replies
with a fixed-price quote by e-mail within 24 hours. The reply
carries a quote_id and an access_token; keep the token,
it is the only way to read the request back. No field at the
top level is required, but the nested task object requires a
description and the nested client object requires email
and name.get_status — the state of an earlier quote request. Both
id (the quote_id) and access_token are required. Records
are kept for 90 days, and the quote itself arrives by e-mail.handwork is a forwarding client, not a reimplementation. It
serves tools/list itself, from the tool definitions the remote
publishes, and for every tools/call it opens a streamable-HTTP
JSON-RPC session with the upstream — initialize, then
notifications/initialized, then the call, carrying the
Mcp-Session-Id header whenever the upstream issues one — and
passes the upstream result through verbatim. If the upstream
cannot be reached or answers with an error, the call fails with
a handwork error: message instead of a fabricated result.
The upstream endpoint defaults to https://handsforagents.com/mcp.
Setting the HANDS_MCP_URL environment variable points the
client at a different endpoint (a reconstruction affordance; the
published service itself names no override).
As an MCP server over stdio:
MCP client configuration:
In a container (the default command is mcp):
Any other subcommand prints usage and exits with code 2.
The tests drive the forwarding core against a fake JSON-RPC
upstream injected in place of fetch, covering the handshake
order, session handling, verbatim pass-through, event-stream
responses, error surfacing, and a check that the served
tools/list matches the captured upstream surface exactly.
MIT — see LICENSE.
Source: README.md at commit 10c2bb9
List services, prices and terms
What this company will and will not do in the physical world, the refused categories, example prices, the payment rules and the key contract terms. Identical to https://handsforagents.com/services.json. No authentication.
Takes no parameters.
Request a fixed-price quote from a human
Send a physical-world task to a human in the Czech Republic for screening and a fixed-price quote. Not an order and not binding: nothing is charged and nothing is made until you accept the quote. A human answers by e-mail within 24 hours, counted in real time, weekends and Czech public holidays included. Returns quote_id, access_token, response_due_at and nda_url. Store the access_token — it is the only way to read the quote back. No authentication. Legacy endpoint: a quote requested here is ordered by e-mail. To order and pay by card through tools (create_task, Stripe Checkout), send request_quote to https://mcp.handsforagents.com/mcp instead.
taskagentclientallow_anonymised_exampleRead a quote request back
Status of a quote request made with request_quote. Needs the quote_id and the access_token returned by that call; there is no other way in, and the record is kept for 90 days. The quote itself is sent by e-mail. Only for quotes requested at this legacy endpoint; tasks and payments are at https://mcp.handsforagents.com/mcp.
idrequiredaccess_tokenrequired90% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
npx -y @reneturcios/handwork mcp{ "mcpServers": { "handwork": { "command": "npx", "args": ["-y", "@reneturcios/handwork", "mcp"] } }}docker run -i ghcr.io/cloudcorprecords/handworkdocker run --rm ghcr.io/cloudcorprecords/handwork --versionhandwork mcp # serve the tools over stdiohandwork --version # print the versionnpm installnpm run build # tsc -> dist/npm test # node test runner via tsx; stubbed upstream, no networknpm run dev # run the CLI from source