# Makeform for AI agents

AI agents can create and manage Makeform resources through two operational interfaces: the hosted Streamable HTTP MCP server and the REST API. Makeform Skills and built-in workflow guidance describe the supported lifecycle; coding-agent CLIs connect to the hosted MCP endpoint, and the browser Embed SDK handles web embedding.

## Hosted MCP

Endpoint: `https://mcp.makeform.ai`

MCP clients should send a Makeform API key or OAuth access token as a Bearer token. A generic remote configuration looks like this:

```json
{
  "mcpServers": {
    "makeform": {
      "type": "http",
      "url": "https://mcp.makeform.ai",
      "headers": {
        "Authorization": "Bearer ${MAKEFORM_API_KEY}"
      }
    }
  }
}
```

Codex CLI can register the hosted server directly:

```sh
codex mcp add makeform --url https://mcp.makeform.ai --bearer-token-env-var MAKEFORM_API_KEY
```

Start an MCP session with `get_workflow_guide`. It explains the checked workflow for reading, proposing changes, applying approved drafts, and publishing with confirmation.

## REST API

Base URL: `https://api.makeform.ai`

Create a form with the documented `/forms` endpoint:

```sh
curl --request POST 'https://api.makeform.ai/forms' \
  --header 'Authorization: Bearer YOUR_MAKEFORM_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"name":"Customer Feedback"}'
```

Use the REST API from Python, Node.js, or any runtime with an HTTP client. Makeform does not require a language-specific package. Use the browser Embed SDK only for public embedding; keep API credentials on the server.

## Supported agent work

- Inspect workspace and form state.
- Create draft forms from prompts and retrieve form configurations.
- Propose and apply checked draft edits.
- Publish through a confirmation-bound workflow.
- Generate hosted and embedded experiences.
- Collect submissions through published forms, then retrieve, filter, summarize, chart, export, analyze, or delete data through the documented interface where supported.
- Work with supported analytics, assets, and workspace operations.

Permissions, plan, role, resource state, and client support determine which operations are available. Destructive operations remain restricted or dashboard-only when the agent interface cannot provide an adequate confirmation contract.

See the [API introduction](https://www.makeform.ai/docs/api-reference/introduction.md), [AI information](https://www.makeform.ai/ai-info.md), [MCP runtime manifest](https://mcp.makeform.ai), and [experimental Server Card](https://mcp.makeform.ai/server-card).

Last updated: September 9, 2026.
