# Formcarry — how to use (mcp.ai)

Connect your Formcarry account and use 4 tools for forms and surveys straight from your AI agent. Connect with your own API key. Formcarry is a form API that allows you to collect submissions from your own designed HTML forms without coding any backend, providing features like email notifications, file uploads, spam protection, and integrations with other apps.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/formcarry/create/form` — Create a new form with customizable settings including email notifications, webhooks, and thank you pages. This action creates a Formcarry form with extensive configuration options for email notificat
  - body: { name: string, email?: string, failUrl?: string, webhook?: string, retention?: boolean, returnUrl?: string, autoResponse?: boolean, returnParams?: boolean, selfEmail_code?: string, selfEmail_from?: string, googleRecaptcha?: string, selfEmail_theme?: string, autoResponse_code?: string, autoResponse_from?: string, selfEmail_subject?: string, thankYouPage_mode?: string, autoResponse_theme?: string, thankYouPage_theme?: string, autoResponse_message?: string, autoResponse_subject?: string, selfEmail_sendOnSpam?: boolean, thankYouPage_message?: string, thankYouPage_headline?: string, thankYouPage_returnUrl?: string, thankYouPage_returnText?: string }
- `POST https://api.mcp.ai/api/formcarry/delete/form` — Delete an existing form by its Form ID. Use when you need to permanently remove a form from your Formcarry account.
  - body: { formId: string }
- `POST https://api.mcp.ai/api/formcarry/retrieve/submissions` — Retrieves all submissions for a specific Formcarry form. Returns a paginated list of form submissions with their field data, timestamps, and submission IDs. Use pagination parameters to navigate throu
  - body: { page?: integer, limit?: integer, formId: string }
- `POST https://api.mcp.ai/api/formcarry/verify/auth` — Tool to verify API key authentication with Formcarry. Use this endpoint to check if your API key is valid before making other API requests. Returns success status and a confirmation message if the API

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

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