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

# list_forms

> MCP tool - list all forms on your account so an agent can discover ids or confirm a form it just created.

<Info>**Free** - like the rest of the MCP server, `list_forms` is not plan-gated.</Info>

Lists every form on your account with its id, name, access key, and inbox/spam counts.
An agent uses this to discover a `formId` to pass to other tools, or to confirm a form
it just created with [`create_form`](/docs/agents/create-form) actually exists. Takes no
arguments - it is always scoped to the account behind the token.

## Input schema

`list_forms` takes no arguments.

```json theme={null}
{
  "name": "list_forms",
  "arguments": {}
}
```

## Returned shape

```json theme={null}
{
  "forms": [
    {
      "id": "frm_...",
      "name": "Contact form",
      "access_key": "fp_...",
      "counts": { "inbox": 42, "spam": 3 }
    }
  ]
}
```

| Field                | Type             | Meaning                                                                                                            |
| -------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------ |
| `forms[].id`         | `string`         | Form id (`frm_…`) - pass this to [`get_form`](/docs/agents/get-form) or [`list_submissions`](/docs/agents/list-submissions). |
| `forms[].name`       | `string \| null` | The form's name, or null if unnamed.                                                                               |
| `forms[].access_key` | `string`         | The form's `access_key` (`fp_…`), the value that goes in a form's hidden `access_key` field.                       |
| `forms[].counts`     | `object`         | Inbox and spam submission totals for the form.                                                                     |

## Errors

An invalid or revoked token returns the same auth error as every MCP tool - see
[MCP server](/docs/agents/mcp-server#auth).

<CardGroup cols={2}>
  <Card title="get_form" icon="magnifying-glass" href="/docs/agents/get-form">
    Read one form's full config to verify it is wired correctly.
  </Card>

  <Card title="create_form" icon="wand-magic-sparkles" href="/docs/agents/create-form">
    Where the forms you are listing come from.
  </Card>
</CardGroup>