Formbricks MCP by usefulapi
Read survey responses and manage contacts, webhooks, teams and organisation users.
사용해야 할까요
품질 및 안전성
발견 사항 (5)
- LOWformbricks_list_contact_attribute_keys에서
- LOWformbricks_get_contact_attribute_key에서
- LOWformbricks_get_survey_contact_link에서
- LOWformbricks_get_survey_segment_links에서
- LOWformbricks_list_organization_users에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"formbricks": {
"url": "https://formbricks.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://formbricks.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (17)
🟢formbricks_health
Check that the Formbricks API is reachable. Formbricks v2: GET /health.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢formbricks_whoami
Return the project and environment the configured x-api-key belongs to — the fastest way to find the workspace and environment ids the other tools need. Formbricks v2: GET /me.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢formbricks_list_responses(surveyId, contactId, startDate, endDate, filterDateField, ...)
List survey responses, optionally narrowed to one survey, one contact or a date window. This is the main read: the answers people gave. Formbricks v2: GET /management/responses.
입력 스키마
{
"type": "object",
"properties": {
"surveyId": {
"description": "Only responses to this survey.",
"type": "string"
},
"contactId": {
"description": "Only responses from this contact.",
"type": "string"
},
"startDate": {
"description": "ISO-8601 lower bound on the date field.",
"type": "string"
},
"endDate": {
"description": "ISO-8601 upper bound on the date field.",
"type": "string"
},
"filterDateField": {
"description": "Which date field the window applies to.",
"type": "string",
"enum": [
"createdAt",
"updatedAt"
]
},
"limit": {
"description": "Page size, 1-100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"skip": {
"description": "How many records to skip (offset paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"sortBy": {
"description": "Field to sort on, e.g. createdAt or updatedAt.",
"type": "string"
},
"order": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢formbricks_get_response(response_id)
Fetch a single survey response with its answers, metadata and completion state. Formbricks v2: GET /management/responses/{id}.
입력 스키마
{
"type": "object",
"properties": {
"response_id": {
"type": "string",
"description": "The response's id."
}
},
"required": [
"response_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢formbricks_list_webhooks(surveyIds, limit, skip, sortBy, order)
List the webhooks configured to fire on survey events, optionally filtered to specific surveys. Formbricks v2: GET /management/webhooks.
입력 스키마
{
"type": "object",
"properties": {
"surveyIds": {
"description": "Only webhooks bound to these survey ids.",
"type": "array",
"items": {
"type": "string"
}
},
"limit": {
"description": "Page size, 1-100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"skip": {
"description": "How many records to skip (offset paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"sortBy": {
"description": "Field to sort on, e.g. createdAt or updatedAt.",
"type": "string"
},
"order": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢formbricks_get_webhook(webhook_id)
Fetch a single webhook with its URL, triggers and bound surveys. Formbricks v2: GET /management/webhooks/{id}.
입력 스키마
{
"type": "object",
"properties": {
"webhook_id": {
"type": "string",
"description": "The webhook's id."
}
},
"required": [
"webhook_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢formbricks_list_contact_attribute_keys(workspaceId, environmentId, limit, skip, sortBy, ...)
List the contact attribute keys defined in an environment — the schema of what you know about a contact. Formbricks v2: GET /management/contact-attribute-keys.
입력 스키마
{
"type": "object",
"properties": {
"workspaceId": {
"description": "Restrict to this workspace.",
"type": "string"
},
"environmentId": {
"description": "Restrict to this environment.",
"type": "string"
},
"limit": {
"description": "Page size, 1-100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"skip": {
"description": "How many records to skip (offset paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"sortBy": {
"description": "Field to sort on, e.g. createdAt or updatedAt.",
"type": "string"
},
"order": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢formbricks_get_contact_attribute_key(key_id)
Fetch a single contact attribute key. Formbricks v2: GET /management/contact-attribute-keys/{id}.
입력 스키마
{
"type": "object",
"properties": {
"key_id": {
"type": "string",
"description": "The attribute key's id."
}
},
"required": [
"key_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢formbricks_get_survey_contact_link(survey_id, contact_id)
Get the personalised survey URL for one contact — the link you send so their response is attributed to them. Formbricks v2: GET /management/surveys/{surveyId}/contact-links/contacts/{contactId}/.
입력 스키마
{
"type": "object",
"properties": {
"survey_id": {
"type": "string",
"description": "The survey to link to."
},
"contact_id": {
"type": "string",
"description": "The contact the link is for."
}
},
"required": [
"survey_id",
"contact_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢formbricks_get_survey_segment_links(survey_id, segment_id, limit, skip)
Get personalised survey URLs for every contact in a segment — how you run a targeted send. Formbricks v2: GET /management/surveys/{surveyId}/contact-links/segments/{segmentId}.
입력 스키마
{
"type": "object",
"properties": {
"survey_id": {
"type": "string",
"description": "The survey to link to."
},
"segment_id": {
"type": "string",
"description": "The segment of contacts."
},
"limit": {
"description": "Page size, 1-100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"skip": {
"description": "How many records to skip (offset paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"survey_id",
"segment_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢formbricks_list_teams(organization_id, limit, skip, sortBy, order)
List the teams in an organisation. Formbricks v2: GET /organizations/{organizationId}/teams.
입력 스키마
{
"type": "object",
"properties": {
"organization_id": {
"type": "string",
"description": "The organisation's id."
},
"limit": {
"description": "Page size, 1-100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"skip": {
"description": "How many records to skip (offset paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"sortBy": {
"description": "Field to sort on, e.g. createdAt or updatedAt.",
"type": "string"
},
"order": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
}
},
"required": [
"organization_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢formbricks_list_organization_users(organization_id, email, id, limit, skip)
List the users in an organisation, optionally looked up by id or email. Formbricks v2: GET /organizations/{organizationId}/users.
입력 스키마
{
"type": "object",
"properties": {
"organization_id": {
"type": "string",
"description": "The organisation's id."
},
"email": {
"description": "Only the user with this email.",
"type": "string"
},
"id": {
"description": "Only the user with this id.",
"type": "string"
},
"limit": {
"description": "Page size, 1-100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"skip": {
"description": "How many records to skip (offset paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"organization_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢formbricks_list_roles
List the roles that can be assigned to organisation users. Formbricks v2: GET /roles.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴formbricks_create_webhook(name, url, workspaceId, triggers, surveyIds, ...)
Register a webhook that fires on survey events. Formbricks v2: POST /management/webhooks.
입력 스키마
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "A label for the webhook."
},
"url": {
"type": "string",
"description": "The HTTPS URL Formbricks should POST to."
},
"workspaceId": {
"type": "string",
"description": "The workspace the webhook belongs to."
},
"triggers": {
"type": "array",
"items": {
"type": "string"
},
"description": "Events to fire on, e.g. [\"responseCreated\", \"responseFinished\"]."
},
"surveyIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Surveys the webhook covers. Pass an empty array for all surveys."
},
"environmentId": {
"description": "Restrict to one environment.",
"type": "string"
}
},
"required": [
"name",
"url",
"workspaceId",
"triggers",
"surveyIds"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴formbricks_delete_webhook(webhook_id)
Remove a webhook. Formbricks v2: DELETE /management/webhooks/{id}.
입력 스키마
{
"type": "object",
"properties": {
"webhook_id": {
"type": "string",
"description": "The webhook to delete."
}
},
"required": [
"webhook_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴formbricks_create_contact(workspaceId, attributes, environmentId)
Create a contact in a workspace from a set of attributes, e.g. email and userId. Formbricks v2: POST /management/contacts.
입력 스키마
{
"type": "object",
"properties": {
"workspaceId": {
"type": "string",
"description": "The workspace to create the contact in."
},
"attributes": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
},
"description": "Attribute key/value pairs, e.g. {\"email\":\"[email protected]\",\"userId\":\"u_1\"}."
},
"environmentId": {
"description": "Restrict to one environment.",
"type": "string"
}
},
"required": [
"workspaceId",
"attributes"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴formbricks_delete_response(response_id)
Delete one survey response. Irreversible — use it to honour a data-deletion request. Formbricks v2: DELETE /management/responses/{id}.
입력 스키마
{
"type": "object",
"properties": {
"response_id": {
"type": "string",
"description": "The response to delete."
}
},
"required": [
"response_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}커뮤니티
증거