{"service":"suncake","status":"ok","description":"Suncake is a free online form builder. AI agents can create forms instantly with a single API call.","tools":[{"name":"create_ai_form","description":"Create an online form, survey, quiz, or poll from a natural language description. Returns a shareable URL. No authentication required.","method":"POST","url":"https://suncake.com/api/v1/create_ai_form","input":{"prompt":{"type":"string","required":true,"description":"Natural language description of the form to create"},"language":{"type":"string","required":false,"description":"ISO language code (e.g. en, fr, es). Auto-detected if omitted."},"title":{"type":"string","required":false,"description":"Form title. Auto-generated if omitted."},"email":{"type":"string","required":false,"description":"Email for response notifications."},"mode":{"type":"string","required":false,"description":"Set to 'preview' to see what would be created without actually creating it."}},"output":{"success":"boolean","survey_url":"string — shareable link to fill out the form","admin_url":"string — link to manage the form (auto-login)","edit_url":"string — link to edit the form (auto-login)","title":"string — generated form title","questions_count":"integer","language":"string"},"errors":{"400 invalid_prompt":"Missing or empty prompt","400 prompt_too_long":"Prompt exceeds 10,000 characters","422 generation_failed":"AI failed to generate the form","429 too_many_requests":"Rate limited (max 30/hour/IP)","503 service_unavailable":"Daily limit reached"},"examples":[{"prompt":"A 3-question customer feedback form"},{"prompt":"Employee satisfaction survey with questions about work environment, management, and career growth","language":"en"},{"prompt":"Quiz de culture générale avec 10 questions à choix multiples","language":"fr"},{"prompt":"1. Rate our service (1-5 stars)\n2. How long did you wait? (Under 5min, 5-15min, 15-30min, 30min+)\n3. Would you recommend us? (Yes/No)\n4. Any comments? (free text)"}]}],"magic_link":{"description":"PREFERRED METHOD for LLMs: generate a clickable URL that creates the form when the user clicks it. No HTTP call needed from the LLM.","format":"https://suncake.com/create?prompt=\u003cURL-encoded+form+description\u003e","max_prompt_length":"1500 characters in URL. For longer prompts, use store_prompt first.","example":"https://suncake.com/create?prompt=Customer+feedback+form+with+5+questions+about+service+quality"},"store_prompt":{"description":"Store a long prompt and get a short token. Use this when the prompt is too long for a URL.","method":"POST","url":"https://suncake.com/api/v1/store_prompt","input":{"prompt":"string (required)","language":"string (optional)","title":"string (optional)"},"output":{"token":"string","create_url":"string — give this URL to the user"},"example_flow":"POST /api/v1/store_prompt with long prompt → get create_url → give create_url to user"},"simple_get_endpoint":"https://suncake.com/api/v1/create_ai_form?prompt=your+form+description","openapi_spec":"https://suncake.com/api/v1/openapi","documentation":"https://suncake.com/developers"}