{"version":"1.0","protocolVersion":"2025-11-25","serverInfo":{"name":"scavenge-hunt-creator","version":"2.0.0"},"description":"Create a free, unlisted, guest-playable scavenger hunt on Scavenge.rs with 2–20 clues. No login or API key. Return playUrl to players and the private claimUrl only to the requester. Use verified location facts or observation-based clues; never invent coordinates.","documentationUrl":"https://scavenge.rs/ai","transport":{"type":"streamable-http","endpoint":"https://scavenge.rs/mcp"},"capabilities":{"tools":{}},"authentication":{"required":false,"schemes":[]},"instructions":"Gather missing setting, audience, theme, and length; default to six clues in a free guided hunt. Use create_scavenger_hunt only when asked to create a hunt. After success share playUrl and joinCode with players, who can play without an account. Label claimUrl as a private ownership link for the requester only, with claimExpiresAt. Optional sign-in on Scavenge lets the requester claim and edit the hunt. Do not include ownership links in player invitations. Do not automatically retry an uncertain creation because it is not idempotent.","tools":[{"name":"create_scavenger_hunt","title":"Create a scavenger hunt","description":"Create a free, unlisted, guest-playable scavenger hunt on Scavenge.rs with 2–20 clues. No login or API key. Return playUrl to players and the private claimUrl only to the requester. Use verified location facts or observation-based clues; never invent coordinates.","inputSchema":{"type":"object","additionalProperties":false,"required":["title","description","location","clues"],"properties":{"title":{"type":"string","minLength":3,"maxLength":100,"description":"A clear, inviting name for the hunt."},"description":{"type":"string","minLength":10,"maxLength":5000,"description":"Player-facing introduction with audience, approximate duration, and relevant safety or accessibility guidance."},"location":{"type":"string","minLength":2,"maxLength":200,"description":"General hunt area. Use Play Anywhere for hunts that do not depend on a real place."},"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"startDate":{"type":"string","format":"date-time","description":"Optional ISO 8601 start time."},"endDate":{"type":"string","format":"date-time","description":"Optional ISO 8601 end time later than startDate."},"maxParticipants":{"type":"integer","minimum":1,"maximum":10000},"huntType":{"type":"string","enum":["guided","point_based"],"default":"guided"},"autoApproveSubmissions":{"type":"boolean","const":true,"default":true},"isPublic":{"type":"boolean","const":false,"default":false},"showInUserProfile":{"type":"boolean","const":false,"default":false},"requirePayment":{"type":"boolean","const":false,"default":false},"bookingEnabled":{"type":"boolean","const":false,"default":false},"pricePerPerson":{"type":"number","const":0,"default":0},"attribution":{"type":"string","minLength":1,"maxLength":100,"description":"Optional short AI service name, such as ChatGPT or Claude. Do not put the end user name here."},"clues":{"type":"array","minItems":2,"maxItems":20,"items":{"type":"object","additionalProperties":false,"required":["order","text","challenge_type"],"properties":{"order":{"type":"integer","minimum":1,"maximum":20,"description":"One-based display order. Use every integer exactly once."},"text":{"type":"string","minLength":3,"maxLength":2000,"description":"Player-facing question, task, direction, or information."},"hint":{"type":"string","minLength":1,"maxLength":1000,"description":"Optional help that does not reveal the answer outright."},"location":{"type":"string","minLength":1,"maxLength":200,"description":"Specific public landmark or area for this clue."},"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"answer":{"type":"string","minLength":1,"maxLength":1000,"description":"Stable expected answer for text and both challenges."},"challenge_type":{"type":"string","enum":["text","photo","both","opinion_text","opinion_text_photo","multiple_choice_text","multiple_choice_text_photo","informational","poll","poll_photo"]},"auto_approve_answer":{"type":"boolean","description":"Defaults to true for answer-based AI-created clues."},"auto_approve_photo":{"type":"boolean","description":"Defaults to true for photo-based AI-created clues."},"multiple_choice_options":{"type":"array","minItems":2,"maxItems":10,"uniqueItems":true,"items":{"type":"object","additionalProperties":false,"required":["id","text"],"properties":{"id":{"type":"string","minLength":1,"maxLength":50},"text":{"type":"string","minLength":1,"maxLength":300}}}},"correct_answers":{"type":"array","minItems":1,"maxItems":10,"uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":50},"description":"Option IDs, not option text."},"allow_multiple_selections":{"type":"boolean","default":false},"points":{"type":"integer","minimum":1,"maximum":10000,"description":"Required on every clue when huntType is point_based."}},"dependentRequired":{"latitude":["longitude"],"longitude":["latitude"]},"allOf":[{"if":{"properties":{"challenge_type":{"enum":["text","both"]}}},"then":{"required":["answer"]}},{"if":{"properties":{"challenge_type":{"enum":["multiple_choice_text","multiple_choice_text_photo"]}}},"then":{"required":["multiple_choice_options","correct_answers"]}},{"if":{"properties":{"challenge_type":{"enum":["poll","poll_photo"]}}},"then":{"required":["multiple_choice_options"]}}]}}},"dependentRequired":{"latitude":["longitude"],"longitude":["latitude"]},"allOf":[{"if":{"required":["huntType"],"properties":{"huntType":{"const":"point_based"}}},"then":{"properties":{"clues":{"items":{"allOf":[{"type":"object","additionalProperties":false,"required":["order","text","challenge_type"],"properties":{"order":{"type":"integer","minimum":1,"maximum":20,"description":"One-based display order. Use every integer exactly once."},"text":{"type":"string","minLength":3,"maxLength":2000,"description":"Player-facing question, task, direction, or information."},"hint":{"type":"string","minLength":1,"maxLength":1000,"description":"Optional help that does not reveal the answer outright."},"location":{"type":"string","minLength":1,"maxLength":200,"description":"Specific public landmark or area for this clue."},"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"answer":{"type":"string","minLength":1,"maxLength":1000,"description":"Stable expected answer for text and both challenges."},"challenge_type":{"type":"string","enum":["text","photo","both","opinion_text","opinion_text_photo","multiple_choice_text","multiple_choice_text_photo","informational","poll","poll_photo"]},"auto_approve_answer":{"type":"boolean","description":"Defaults to true for answer-based AI-created clues."},"auto_approve_photo":{"type":"boolean","description":"Defaults to true for photo-based AI-created clues."},"multiple_choice_options":{"type":"array","minItems":2,"maxItems":10,"uniqueItems":true,"items":{"type":"object","additionalProperties":false,"required":["id","text"],"properties":{"id":{"type":"string","minLength":1,"maxLength":50},"text":{"type":"string","minLength":1,"maxLength":300}}}},"correct_answers":{"type":"array","minItems":1,"maxItems":10,"uniqueItems":true,"items":{"type":"string","minLength":1,"maxLength":50},"description":"Option IDs, not option text."},"allow_multiple_selections":{"type":"boolean","default":false},"points":{"type":"integer","minimum":1,"maximum":10000,"description":"Required on every clue when huntType is point_based."}},"dependentRequired":{"latitude":["longitude"],"longitude":["latitude"]},"allOf":[{"if":{"properties":{"challenge_type":{"enum":["text","both"]}}},"then":{"required":["answer"]}},{"if":{"properties":{"challenge_type":{"enum":["multiple_choice_text","multiple_choice_text_photo"]}}},"then":{"required":["multiple_choice_options","correct_answers"]}},{"if":{"properties":{"challenge_type":{"enum":["poll","poll_photo"]}}},"then":{"required":["multiple_choice_options"]}}]},{"required":["points"]}]}}}}}]},"outputSchema":{"type":"object","additionalProperties":false,"required":["success","message","hunt"],"properties":{"success":{"type":"boolean","const":true},"message":{"type":"string"},"hunt":{"type":"object","additionalProperties":false,"required":["id","title","joinCode","playUrl","detailsUrl","joinUrl","claimUrl","claimExpiresAt"],"properties":{"id":{"type":"integer"},"title":{"type":"string"},"joinCode":{"type":"string"},"playUrl":{"type":"string","format":"uri"},"detailsUrl":{"type":"string","format":"uri"},"joinUrl":{"type":"string","format":"uri"},"claimUrl":{"type":"string","format":"uri","description":"One-time link for the requester to become the hunt creator. The secret is in the URL fragment. Do not share this with players."},"claimExpiresAt":{"type":"string","format":"date-time","description":"ISO 8601 expiry for claimUrl. Typically seven days."}}}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"noauth"}]}}]}