> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dema.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Typeform

> Let the Dema Agent build and manage your typeforms, browse workspaces, and read form responses from Typeform when you ask.

## Overview

Once Typeform is connected, the Dema Agent can work with your Typeform account directly inside a conversation — browse workspaces and forms, read responses, and create or update forms.

The agent only acts when you ask it to, and Dema asks you to confirm sensitive changes before they are applied.

<Note>
  Typeform's MCP server is in **beta** and its capabilities are still expanding, so some actions may not be available yet.
</Note>

***

## Prerequisites

* A Typeform account with permission to create a personal access token.

***

## Connect Typeform

<Steps>
  <Step title="Create a personal access token in Typeform">
    1. In Typeform, open the menu next to your username in the top-left corner and click **Account**.
    2. In the left menu, click **Personal tokens**.
    3. Click **Generate a new token**.
    4. Give the token a name you will recognize, such as `Dema Agent`.
    5. Select the **scopes** the agent needs (see below).
    6. Click **Generate token** and copy it now — Typeform shows it only once.
  </Step>

  <Step title="Connect in Dema">
    In Dema, go to **Agents → Settings → Integrations**, find **Typeform**, and click **Connect**. Enter:

    * **Personal access token** — the token you copied.
    * **MCP URL** — your region's Typeform MCP URL: US `https://api.typeform.com/mcp` or EU `https://api.eu.typeform.com/mcp`.

    Click **Add**. Dema marks the integration as Active.

    <Note>
      Your data region is fixed by the MCP URL: US accounts use `https://api.typeform.com/mcp`, EU-resident accounts use `https://api.eu.typeform.com/mcp`. Use the URL that matches your Typeform account, or the agent will not reach your data.
    </Note>
  </Step>
</Steps>

***

## Scopes to grant

Select these when you create the token so the agent can read and manage your forms:

| Scope             | What it unlocks          |
| ----------------- | ------------------------ |
| `accounts:read`   | Read basic account info  |
| `workspaces:read` | List and read workspaces |
| `forms:read`      | List and read forms      |
| `forms:write`     | Create and update forms  |
| `responses:read`  | Read form responses      |

Add `workspaces:write` or `responses:write` only if you want the agent to manage workspaces or delete responses.

***

## Rotating the key

Personal access tokens do not have a documented expiry. To rotate, regenerate the token on the **Personal tokens** page in Typeform (or generate a new one), click **Reconnect** on the Typeform integration card in Dema, and enter the new token. Leave the **MCP URL** as the one you used initially — US `https://api.typeform.com/mcp` or EU `https://api.eu.typeform.com/mcp` — since your data region does not change when you rotate the token.

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Dema cannot authenticate">
    Check that you copied the full token and that it has the scopes listed above. If you are unsure, generate a new token with the right scopes and reconnect.
  </Accordion>

  <Accordion title="The agent cannot see a form or workspace">
    The token only covers what its scopes allow. Make sure `workspaces:read`, `forms:read`, and `responses:read` are granted, then reconnect.
  </Accordion>

  <Accordion title="Dema says the MCP URL is invalid, or the agent finds no data">
    Check you entered the URL for your region — US `https://api.typeform.com/mcp` or EU `https://api.eu.typeform.com/mcp` — and that it matches where your Typeform account is hosted. An EU account connected to the US URL (or vice versa) will not return data.
  </Accordion>

  <Accordion title="I lost the token">
    Typeform shows the token only once. Generate a new one on the **Personal tokens** page and reconnect.
  </Accordion>
</AccordionGroup>

If you are still stuck, contact [support](mailto:info@dema.ai) with the error message you see.

***

## Additional resources

* [Create a personal access token](https://www.typeform.com/developers/get-started/personal-access-token/)
* [Typeform OAuth 2.0 scopes](https://www.typeform.com/developers/get-started/scopes/)
* [Typeform MCP server](https://www.typeform.com/developers/get-started/mcp/)