# Formaly

> Formaly is an AI-powered conversational survey platform. Users create surveys via natural language prompts, respondents answer through a chat interface or traditional form view, and AI generates themes, sentiment, and action items from responses. Talk to build. Talk to answer.

## Product

- [Home](/)
- [Sign up](/sign-up)
- [Sign in](/sign-in)
- [Dashboard](/dashboard)

## Features

- **AI-powered creation:** Describe what you want to learn; AI generates a conversational form in seconds
- **Chat-first experience:** Respondents complete forms through natural conversation, not static multi-field forms
- **Dual mode:** Chat interface or traditional form view
- **Instant insights:** AI extracts themes, sentiment, and key quotes from responses
- **Formaly SDK:** Lightweight JavaScript library for in-product surveys; show targeted surveys inside your app

## Blog

- [Blog index](/blog)
- [Best Google Forms Alternative](/blog/best-google-forms-alternative)
- [Best Typeform Alternatives](/blog/best-typeform-alternatives)
- [10 Form Building Tools](/blog/10-form-building-tools)
- [Best AI-Powered Form Builders](/blog/best-ai-powered-form-builders)
- [Introducing Formaly SDK](/blog/introducing-formaly-sdk)
- [Form Customization](/blog/form-customization-formaly)
- [Advanced Analytics](/blog/advanced-analytics-formaly)
- [AI-Powered Forms vs Traditional Forms](/blog/ai-powered-forms-vs-traditional-forms)

## API

Public REST API with API key auth. Scopes: `forms:read`, `forms:write`, `analytics:read`.

- `GET /api/v1/forms` - List forms
- `POST /api/v1/forms` - Create form
- `GET /api/v1/forms/:id` - Get form
- `PATCH /api/v1/forms/:id` - Update form
- `DELETE /api/v1/forms/:id` - Delete form
- `GET /api/v1/forms/:id/schema` - Machine-readable form schema (fields, types, options, validation)
- `GET /api/v1/forms/:id/analytics` - Get analytics
- `GET /api/v1/forms/:id/responses` - List responses
- `GET /api/v1/credits` - Check credit balance

`POST /api/v1/forms` accepts an `Idempotency-Key` header so retries never create duplicates. `PATCH` supports optimistic concurrency via `expected_version`. Errors are JSON: `{ "error": { "code", "message", "status", "details" } }`.

API keys are created in the dashboard. Use `Authorization: Bearer fml_{prefix}_{hash}`.

## MCP Server

Formaly is agent-native. Any MCP-capable agent (Claude, Cursor, custom) connects to the Model Context Protocol server with a Formaly API key:

- Endpoint: `/api/mcp` (Streamable HTTP)
- Auth: `Authorization: Bearer fml_{prefix}_{hash}` (same keys as the REST API)

Read tools: `list_forms`, `get_form`, `get_form_schema`, `get_form_responses`, `get_form_analytics`, `get_credits`. Write tools (`forms:write`): `create_form`, `update_form`, `set_form_status`, `delete_form`. Full agent guide at `/AGENTS.md`.

## Embed

Surveys can be embedded via iframe. Use `/embed/[id]` for embeddable URLs. External embed script: `/embed.js`.

## Contact

- [Contact](https://dub.sh/arindam-x)