# Byteforms — how to use (mcp.ai)

Connect your Byteforms account and use 5 tools for forms and surveys straight from your AI agent. Connect with your own API key. All-in-one solution for form creation, submission management, and data integration.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/byteforms/create/form` — Creates a new form in ByteForms. Use this to build data collection forms with customizable fields (text, email, phone), styling options (theme, width), and submission rules (limits, deadlines, passwor
  - body: { body: object[], name: string, options?: object }
- `POST https://api.mcp.ai/api/byteforms/delete/form` — Tool to delete a form by its ID. Use when you need to remove an existing form permanently.
  - body: { form_id: string }
- `POST https://api.mcp.ai/api/byteforms/get/all/forms2` — Tool to fetch all forms created by the authenticated user. Use after authentication to list existing forms.
- `POST https://api.mcp.ai/api/byteforms/get/form/by/id` — Retrieves detailed information about a specific form by its numeric ID. Returns the form's name, fields, configuration options, and metadata. Use the numeric 'id' field (not the 'public_id' string) fr
  - body: { form_id: string }
- `POST https://api.mcp.ai/api/byteforms/get/form/responses` — Tool to retrieve responses for a specific form with optional pagination and filtering. Use when the form has collected submissions and you need to navigate large result sets.
  - body: { after?: string, limit?: integer, order?: string, query?: string, before?: string, formId: string }

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

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