# For Google Forms

> Generate ready-to-use Google Forms from a plain-text description. Write the
> form as simple text, the service validates it (LLM-assisted), parses it and
> creates the form via the Google Forms API under the user's Google account.

For AI agents: use the machine API or the MCP server instead of scraping the UI.

## API

- [OpenAPI](https://for-google-forms.surveysai.com/api/v1/forgoogleforms/openapi.json): versioned REST API `/api/v1/forgoogleforms/`
- [Capabilities](https://for-google-forms.surveysai.com/api/v1/forgoogleforms/capabilities): machine-readable feature list
- [Pricing](https://for-google-forms.surveysai.com/api/v1/forgoogleforms/pricing): per-action credit pricing (1 credit = $0.01; HTTP 402 with x402-style body when balance is insufficient)
- Auth: `Authorization: Bearer fgf_...` API key, created in the web dashboard after Google OAuth login. Scopes separate read-only from writing actions.

## MCP

- Server name: `forgoogleforms-mcp`; tools are prefixed `forgoogleforms_` (e.g. `forgoogleforms_create_form`, `forgoogleforms_validate_form`).
- Discovery: [https://for-google-forms.surveysai.com/.well-known/forgoogleforms.json](https://for-google-forms.surveysai.com/.well-known/forgoogleforms.json)

## Input format (summary)

First line = form title. One question per line: `Question text? [type]` with
options after `|` for choice types. Supported types include: text, paragraph,
multiple_choice, checkbox, dropdown, linear_scale, rating, date, time,
multiple_choice_grid, checkbox_grid, plus layout items (section, text_block,
image, video) and quiz mode. Full reference: QUESTION_TYPES.md in the repo or
`GET /api/v1/forgoogleforms/capabilities`.

## Pages

- [Home](https://for-google-forms.surveysai.com/): interactive form generator
- [Pricing](https://for-google-forms.surveysai.com/pricing): plans
- [Library](https://for-google-forms.surveysai.com/library): public form templates