# Formsite — how to use (mcp.ai)

Connect your Formsite account and use 5 tools for forms and surveys straight from your AI agent. Connect with your own API key. Formsite helps users create online forms and surveys with drag-and-drop tools, secure data capture, and integrations to simplify workflows.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_formsite?ms=1787293440000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `formsite_get_form`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/formsite`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/formsite/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/formsite/get/form` — This tool retrieves detailed information about a specific form in Formsite. It provides comprehensive details including the form's internal description, directory identifier, name, publishing informat
  - body: { form_dir: string, user_dir?: string }
- `POST https://api.mcp.ai/api/formsite/get/form/items` — Retrieves all items (questions) for a specific form using the Formsite API. This action returns detailed information about each form item including: - Item ID (unique identifier for the form question)
  - body: { form_dir: string, user_dir?: string, results_labels?: string }
- `POST https://api.mcp.ai/api/formsite/get/form/results` — This tool retrieves form results from a specified FormSite form. It uses the GET https://{server}.formsite.com/api/v2/{user_dir}/forms/{form_id}/results endpoint to fetch results, handling required pa
  - body: { page?: integer, limit?: integer, form_id: string, user_dir?: string, sort_direction?: string }
- `POST https://api.mcp.ai/api/formsite/get/webhooks` — Retrieves all webhooks configured for a specific form in FormSite. This action returns webhook configurations including URL, event type (e.g., 'result_completed'), and optional handshake_key for secur
  - body: { form_id: string, user_dir?: string }
- `POST https://api.mcp.ai/api/formsite/list/all/forms` — Retrieves a list of all forms in the user's Formsite account. This action returns detailed information about each form including: - Form directory (identifier for accessing the form via API) - Form na
  - body: { user_dir?: string }

## Example prompts
- "What can I do in Formsite?"
- "Show me a summary of my Formsite account"

## More
- Page: https://mcp.ai/formsite
- Agent spec (llms.txt): https://mcp.ai/formsite/llms.txt
- Postman collection: https://mcp.ai/formsite/postman.json