mothermachine

Browse / SMB ops and CRM

formbricks/formbricks

Formbricks

Open-source survey platform with an OAuth MCP server for surveys, workflows and feedback records.

AdaptableOperable Business appWeb app Hybrid TypeScript MCP server License: AGPL-3.0 with ee/ under commercial license

In-app, website, link and email surveys with templates, targeting and integrations. The Builder ships an MCP server at /api/mcp (cloud or self-hosted) that an agent connects to with your own login over OAuth 2.1; survey and workflow tools work on every edition, feedback-record tools need Enterprise. Self-hosting is AGPL with an ee/ directory under a commercial license.

Use it when
  • I want a survey tool our agent can create and launch surveys in, without an API key to babysit
  • I need in-app feedback surveys hosted on our own box under our own domain
Gotchas
  • Feedback-record MCP tools return authorization errors without the Enterprise entitlement and a feedback dataset
  • delete_feedback_record and update_feedback_record are irreversible and need owner or manager role
  • ee/ directory is commercially licensed; do not fork it as AGPL
  • External code contributions are accepted only as an exception

Last activity Sep 2, 2026. Fit: adaptable 2, operable 2.

Editions

Self-hosted · Free open source

  • Clonegit clone https://github.com/formbricks/formbricks
  • ImageContainer

Cloud Free · Free closed source

Cloud paid plans · Free closed source

Enterprise Edition · Free closed source

No distribution recorded.

For agents: JSON · Markdown

Adaptable: what is yours to change

Make it yours

Config only23 things to edit

Self-host with Docker and set env vars; the Builder documents them at docs/self-hosting/configuration/environment-variables.mdx. WEBAPP_URL, DATABASE_URL, ENCRYPTION_KEY, NEXTAUTH_SECRET and SMTP_* are the required set; OIDC_*, SAML and AZUREAD_* add SSO; AI_* and SENTIMENT_* switch on model features with your own provider; ENTERPRISE_LICENSE_KEY unlocks ee/. Survey design happens in-product, not in code.

Env vars
WEBAPP_URL NEXTAUTH_URL NEXTAUTH_SECRET ENCRYPTION_KEY DATABASE_URL REDIS_URL SMTP_HOST SMTP_PORT SMTP_USER SMTP_PASSWORD MAIL_FROM CRON_SECRET OIDC_ISSUER OIDC_CLIENT_ID OIDC_CLIENT_SECRET AI_PROVIDER AI_MODEL S3_BUCKET_NAME ENTERPRISE_LICENSE_KEY MCP_OAUTH_JWKS_URL TELEMETRY_DISABLED
Config files
.env.example docs/self-hosting/configuration/environment-variables.mdx
Prompt files
none
Accounts you need
SMTP providerFormbricks Cloud account (cloud edition)model provider (optional AI features)

Source

Operable: what an agent can drive

Interface

OfficialMCP serverpublished by the builderremote or local

How an agent can drive an Operable Listing, in five levels: native (built for the agent as the primary interface), official (the Builder ships an agent interface), wrapped (a third party wraps the software's API), config (an agent can only drive it by editing files), gui (screen control only). An interface is official only when it is published by the same organization that ships the software. GUI-level Listings are allowed and sorted last.

Docs
app.formbricks.com/api/mcp
Tools
list_surveys get_survey create_survey patch_survey delete_survey list_workflows create_workflow test_workflow list_feedback_records search_feedback_records create_feedback_record

Reach

Partial coverage. 4 of 9 jobs reachable through the stated interface.

JobThrough the interfaceEvidence
Create and edit surveysReachableMCP tools create_survey, patch_survey, validate_survey (docs/platform/mcp/overview.mdx)
List and read surveysReachableMCP tools list_surveys, get_survey
Delete surveysReachableMCP tool delete_survey under surveys:write
Build and run workflowsReachableMCP tools create_workflow, enable_workflow, test_workflow, list_workflow_runs
Read survey responsesNot reachableNo responses tool in the MCP scope table; feedback-record tools need Enterprise (feedbackDirectories); Management API v1/v2 has responses
Search feedback by meaningNot reachablesearch_feedback_records needs Enterprise plus an embedding model; unavailable on free self-host
Target in-app surveys to user segmentsNot reachableTargeting and actions are not in the MCP tool list
Connect Slack, Notion, Zapier, n8n integrationsNot reachableNo integration tools in MCP; configured in-app
Invite and manage organization membersNot reachableNo member tools in MCP; list_workspaces is read-only

Code stack

Languages
TypeScript
Frameworks
Next.jsReactPrismaAuth.jsTailwind CSS
Package manager
pnpm
Database
PostgreSQLRedis
Hosting target
Docker
Built
Human-written (recorded, never ranked)

Model stack

Providers
configurable: OpenAI-compatible, Azure, AWS Bedrock, Google Cloud
Models
none
Keys you need
AI_PROVIDER AI_MODEL AI_OPENAI_COMPATIBLE_API_KEY AI_AZURE_API_KEY SENTIMENT_PROVIDER_API_KEY TRANSLATION_PROVIDER_API_KEY EMBEDDING_PROVIDER_API_KEY
Prompts live in
none

Skills

Repo carries one contributor-facing Next.js documentation skill, mirrored for Claude and Codex. [contributor tooling, not adopter-facing]

Kind
contributor
Paths
.agents/skills/nextjs-docs/SKILL.md .claude/skills/nextjs-docs .codex/skills/nextjs-docs

Evidence and confidence

FieldWhere it was seenConfidence
formFactorREADME: Next.js web app, Docker self-host95%
executionModelAI_PROVIDER, SENTIMENT_*, TRANSLATION_* env vars: optional model features on a deterministic survey core80%
operabilitydocs/platform/mcp/overview.mdx in the Builder's repo: MCP server at /api/mcp with OAuth 2.195%
effortdocs/self-hosting/configuration/environment-variables.mdx; .env.example85%
editionsREADME: AGPLv3 self-host, cloud with generous free plan; ENTERPRISE_LICENSE_KEY75%
activeGitHub pushedAt 2026-09-02–
reach85%

Open questions

  • Cloud plan prices and whether MCP access is on the free cloud plan
  • Does the Management API v2 expose responses so an agent could pair it with MCP?

Sources