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

# Connect over MCP

> Formcarry's MCP does everything you would do in the dashboard for your forms and submissions, from the chat of the tool you already use.

Once connected, Claude, Codex, Cursor or v0 can create a form, set its recipients, spam blocker and webhooks, list and search submissions, mark spam, and read where each submission was delivered. You approve the connection once on a formcarry page and can remove it at any time.

## What it can do

The server exposes the same operations as the dashboard, as tools the AI picks from:

* **Forms:** list, create, read, update, and read the field names a form collects.
* **Recipients:** add or remove who gets the notification email.
* **Submissions:** list, search across forms, count, read one, mark as spam, restore, delete.
* **Webhooks:** list, add, change, delete, read the delivery log, send a submission again.
* **Deliveries:** read what happened to a submission after it arrived, on every channel.

<Note>
  The MCP cannot change your account, billing or team members, and it cannot read forms of a team you did not approve.
</Note>

## Prerequisites

Before you start, you need:

* A formcarry account. [Sign up](https://app.formcarry.com/register) is free.
* The server address. It is the same for every tool:

```text theme={null}
https://mcp.formcarry.com/mcp
```

## 1. Add the server to your tool

<Tabs>
  <Tab title="Claude">
    In Claude Code, add the server, then type `/mcp` in a session and pick formcarry:

    ```bash theme={null}
    claude mcp add --transport http formcarry https://mcp.formcarry.com/mcp
    ```

    In the Claude app and claude.ai, open **Settings**, **Connectors**, **Add custom connector**, and paste the address.
  </Tab>

  <Tab title="Codex">
    In the CLI, add the server, then sign in, which opens the approval page:

    ```bash theme={null}
    codex mcp add formcarry --url https://mcp.formcarry.com/mcp
    codex mcp login formcarry
    ```

    In the Codex app, open **Settings**, **MCP Settings**, **Add server**, choose **Streamable HTTP**, name it formcarry, paste the address and leave the headers empty. Click **Save**, **Refresh**, then **Authenticate**.

    <Note>
      The app, the CLI and the IDE extension share one configuration, so adding it once covers all three.
    </Note>
  </Tab>

  <Tab title="Cursor">
    Click **Add to Cursor** on the [Connect page](https://app.formcarry.com/connect). Cursor opens, adds the server and asks you to sign in.

    To add it by hand, open **Cursor Settings**, **Tools and MCP**, **New MCP server**, and paste:

    ```json theme={null}
    { "mcpServers": { "formcarry": { "url": "https://mcp.formcarry.com/mcp" } } }
    ```
  </Tab>

  <Tab title="v0">
    Open the **+** menu in the prompt box, choose **MCPs**, and add a custom server: name it formcarry, paste the address, and pick **OAuth** as the authentication.

    With the v0 SDK, register the server once and pass its id in `mcpServerIds` when you start a chat:

    ```js theme={null}
    const server = await v0.mcpServers.create({ name: "formcarry", url: "https://mcp.formcarry.com/mcp" })
    ```
  </Tab>
</Tabs>

## 2. Approve the connection

On first use, the tool sends you to a formcarry page. Pick the teams the tool may act on. It gets the access your role has on each of them, never more.

<Note>
  A connection lasts a year. After that, the tool asks you to approve it again.
</Note>

## 3. Try it

Ask the tool to list your forms, or to show the latest submissions of one. The answer comes from your account, so a form you created a moment ago is already there.

## Removing a connection

To see what is connected, or to remove a connection, open the [Connect page](https://app.formcarry.com/connect) in the dashboard and scroll to **Connected apps**. Removing a connection stops the tool at once; nothing else changes.

## What's next

* [Build with AI](/docs/ai/overview): one prompt writes the form into your project.
* [API](/docs/api/overview): the same operations with an API key, from your own code.

Stuck? Write to [help@formcarry.com](mailto:help@formcarry.com). Include the form id.


## Related topics

- [v0](/docs/ai/v0.md)
- [Replit](/docs/ai/replit.md)
- [Lovable](/docs/ai/lovable.md)
- [ChatGPT](/docs/ai/chatgpt.md)
- [Build with AI](/docs/ai/overview.md)