deoochform-mcp

<p align="center">
  <a href="https://deoochform.com">
    <img src="https://deoochform.com/email-logo.png" alt="Deoochform" height="64">
  </a>
</p>

<h1 align="center">Deoochform MCP Server</h1>

<p align="center">
  Create forms, read submissions, and build invitations from Claude, ChatGPT,<br>
  Cursor, or any MCP capable assistant.
</p>

<p align="center">
  <a href="https://deoochform.com">Website</a> ·
  <a href="https://deoochform.com/docs/mcp-server">Docs</a> ·
  <a href="https://registry.modelcontextprotocol.io/v0/servers?search=deooch">MCP Registry</a> ·
  <a href="https://deoochform.com/pricing">Pricing</a>
</p>

<p align="center">
  <img alt="Transport: streamable HTTP" src="https://img.shields.io/badge/transport-streamable%20HTTP-2B55C4">
  <img alt="Auth: OAuth 2.1 with PKCE" src="https://img.shields.io/badge/auth-OAuth%202.1%20%2B%20PKCE-1B6B51">
  <img alt="Tools: 10" src="https://img.shields.io/badge/tools-10-555">
  <img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-555">
</p>

---

## What this is

[Deoochform](https://deoochform.com) is a form builder with a remote MCP server
built in. You can drag fields around in the visual studio like any other form
tool, or skip that entirely and ask your assistant to build the form for you,
then read the responses back the same way.

Respondents never sign in. They open a public `/f/<slug>` link, fill it in, and
submit.

This repository is the public home of the connector: the manifest, the tool
reference, and the setup notes. The product itself is hosted, so there is
nothing to install or run.

**Endpoint**

```
https://deoochform.com/api/mcp/v2
```

Remote, streamable HTTP, OAuth. There is no API key to copy or store.

## Connect it

Every client is the same three steps: add a remote or custom MCP connector,
paste the URL, sign in when the browser opens.

| Client | Where |
|---|---|
| **Claude** | Settings → Connectors → Add custom connector → paste the URL |
| **ChatGPT** | Search **deooch** in the app directory, or Settings → Connectors → Create custom connector |
| **Cursor** | Settings → MCP → Add new MCP server → type `http` → paste the URL |
| **Windsurf, Zed, others** | Anywhere that accepts a remote MCP server URL |

A browser tab opens, you approve the connection, and you are done. The
connection acts as you, with your role and your plan.

Full walkthrough with screenshots and the common errors:
**[deoochform.com/docs/mcp-server](https://deoochform.com/docs/mcp-server)**

## Tools

**Forms**

| Tool | What it does |
|---|---|
| `list_templates` | Browse the template library to start from |
| `create_form` | Create a new form and return its public link |
| `update_form` | Update a form's title, description, fields, or status |
| `get_form` | Get a form's full definition |
| `list_forms` | List forms in this workspace |

**Responses**

| Tool | What it does |
|---|---|
| `list_submissions` | List submissions for a form |
| `get_submission` | Get a single submission by id |

**Invitations**

| Tool | What it does |
|---|---|
| `list_invitation_templates` | Browse invitation designs |
| `create_invitation` | Create an invitation |
| `publish_invitation` | Publish one and return its public link |

Ten tools, and the list is the permission model: the server cannot do anything
these do not expose. There is **no delete tool**, **no billing access**, and no
reach into workspace members or other workspaces. `update_form` can set a form
to closed, which stops new responses without destroying anything.

See [docs/tools.md](docs/tools.md) for parameters and return shapes.

## Try it

Once connected, ask in plain language:

```
Create a customer feedback form with a star rating, a "what could we
do better" box, and an optional email field. Give me the link.
```

```
How many people filled in the feedback form this week, and what are
they complaining about?
```

The assistant calls `create_form`, you get a shareable link back, and
`list_submissions` reads the answers when they arrive.

## What the product does

- **13 field types** plus sections, validation, and required fields
- **Conditional logic** on every plan, including free
- **Payment fields** through Stripe: product, subscription and donation
- **Conversational layout**, one question per screen, as a per form setting
- **Answer piping**, so a later question can quote an earlier answer
- **Quiz scoring** with an answer key and per question points
- **Notifications** by email, Slack, or Google Sheets sync
- **Export** to CSV and Excel

## Authentication

Browser based OAuth 2.1 with PKCE. No token to paste, nothing stored in a
config file. Dynamic client registration is supported, so most clients need
nothing but the URL.

Discovery follows the spec, so a client that has never seen the server can find
its way in unaided:

```
/.well-known/oauth-protected-resource/api/mcp/v2   → who authorizes this
/.well-known/oauth-authorization-server            → the OAuth endpoints
```

Details, including the consent step and why PKCE alone is not enough, are in
[docs/authentication.md](docs/authentication.md).

## Two endpoints

| URL | Payments | Use |
|---|---|---|
| `/api/mcp` | Enabled | The original connector. Existing clients stay pointed here. |
| `/api/mcp/v2` | **Disabled** | Listed in public directories. Cannot see or create payment fields, so nothing built through it can take money. |

Capability is settled per URL rather than per request, because an app directory
registers its OAuth client against a base URL and then freezes it. If you are
adding the connector today, use `/api/mcp/v2`.

## Registry

Published to the official MCP Registry as:

```
io.github.musaib001/deooch-forms
```

## Links

- Website: <https://deoochform.com>
- MCP server docs: <https://deoochform.com/docs/mcp-server>
- What is an MCP connector: <https://deoochform.com/blog/what-is-an-mcp-connector>
- AI form MCP connectors, compared: <https://deoochform.com/blog/ai-form-mcp-connectors>
- Form templates: <https://deoochform.com/templates>
- Pricing: <https://deoochform.com/pricing>
- Support: <https://deoochform.com/contact>

## License

MIT. See [LICENSE](LICENSE).

The MIT license covers this repository's contents. The hosted Deoochform
service is governed by its own [terms](https://deoochform.com/terms) and
[privacy policy](https://deoochform.com/privacy).