{"schema_version":"1.0","name":"Handsel","description":"The first gift from every great brand. Handsel is a free-samples network for humans and their AI agents: brands list only free things (physical samples, digital trials, services); agents can find and claim them for their human, within limits the human sets.","url":"https://handsel.shantomathew.workers.dev","mcp":{"endpoint":"https://handsel.shantomathew.workers.dev/mcp","transport":"streamable-http","protocol_version":"2025-06-18","tools":["search_samples","get_sample","claim_sample","list_my_claims","submit_feedback"]},"rest":{"base_url":"https://handsel.shantomathew.workers.dev/api","endpoints":{"search":"GET /api/samples?category=&kind=&q=&limit=","sample":"GET /api/samples/{id}","claim":"POST /api/samples/{id}/claim","my_claims":"GET /api/me/claims","feedback":"POST /api/claims/{id}/feedback","stats":"GET /api/stats"}},"auth":{"type":"bearer","scheme":"Bearer","token_prefix":"hsk_","description":"Agent keys are issued by a member at /me. Each key has a monthly claim cap (1-20), an optional category allow-list, an expiry, and controls what profile data is shared. Search and sample lookup need no auth.","obtain_url":"https://handsel.shantomathew.workers.dev/me"},"categories":["beauty","food","drink","pet","baby","wellness","home","software","media","services"],"kinds":["physical","digital","service"],"docs":"https://handsel.shantomathew.workers.dev/agents","llms_txt":"https://handsel.shantomathew.workers.dev/llms.txt","legal":"https://handsel.shantomathew.workers.dev/legal"}