# Formcrafts — how to use (mcp.ai)

Connect your Formcrafts account and use 6 tools for forms and surveys straight from your AI agent. Connect with your own API key. Formcrafts is an online form builder for collecting responses, managing forms, and accessing uploaded files across an organization.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_formcrafts?ms=1787295900000`
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. `formcrafts_download_file`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/formcrafts`
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/formcrafts/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/formcrafts/download/file` — Download an uploaded Formcrafts file by file ID and return an offloaded file reference.
  - body: { file_id: string }
- `POST https://api.mcp.ai/api/formcrafts/get/form` — Get a Formcrafts form's metadata, response count, fields, and pages by form ID.
  - body: { form_id: string }
- `POST https://api.mcp.ai/api/formcrafts/list/files` — Return one page of files uploaded to the connected Formcrafts organization. Use before and after for exclusive created_at windows; inspect has_more because Formcrafts provides no continuation token.
  - body: { after?: string, limit?: integer, before?: string }
- `POST https://api.mcp.ai/api/formcrafts/list/form/responses` — Return one page of live responses for a Formcrafts form, including visitor metadata, workflow results, and typed field values. Use before and after for exclusive created_at windows; inspect has_more b
  - body: { after?: string, limit?: integer, before?: string, form_id: string }
- `POST https://api.mcp.ai/api/formcrafts/list/forms` — Return one page of forms from the connected Formcrafts organization. Use before and after for exclusive created_at windows; inspect has_more because Formcrafts provides no continuation token.
  - body: { after?: string, limit?: integer, before?: string }
- `POST https://api.mcp.ai/api/formcrafts/list/workspaces` — Return one page of workspaces from the connected Formcrafts organization. Use before and after for exclusive created_at windows; inspect has_more because Formcrafts provides no continuation token.
  - body: { after?: string, limit?: integer, before?: string }

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

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