mcpengine/servers/typeform

Typeform MCP Server

Model Context Protocol (MCP) server for Typeform forms and surveys platform.

Features

Complete coverage of Typeform API for AI agents to manage forms, collect responses, and organize workspaces.

Tools Implemented (26 total)

Forms Management (5 tools)

• ✅ list_forms - List all forms with pagination and filtering
• ✅ get_form - Retrieve detailed form information
• ✅ create_form - Create new forms with fields and settings
• ✅ update_form - Update existing form configuration
• ✅ delete_form - Delete forms permanently

Responses (2 tools)

• ✅ list_responses - Retrieve form submissions with filtering
• ✅ delete_responses - Delete specific responses by token

Workspaces (5 tools)

• ✅ list_workspaces - List all workspaces with search
• ✅ get_workspace - Get workspace details and members
• ✅ create_workspace - Create new workspace
• ✅ update_workspace - Rename workspace
• ✅ delete_workspace - Delete workspace

Themes (5 tools)

• ✅ list_themes - List available themes
• ✅ get_theme - Get theme details and styling
• ✅ create_theme - Create custom theme
• ✅ update_theme - Update theme colors and fonts
• ✅ delete_theme - Delete custom theme

Images (3 tools)

• ✅ list_images - List uploaded images
• ✅ get_image - Get image details and URL
• ✅ delete_image - Delete uploaded image

Webhooks (5 tools)

• ✅ list_webhooks - List form webhooks
• ✅ get_webhook - Get webhook configuration
• ✅ create_webhook - Create webhook for real-time notifications
• ✅ update_webhook - Update webhook URL or status
• ✅ delete_webhook - Remove webhook

Insights (1 tool)

• ✅ get_insights - Get form analytics and statistics

Installation

npm install
npm run build

Configuration

Set your Typeform API token as an environment variable:

export TYPEFORM_API_TOKEN="your_token_here"

Get your API token from Typeform Account Settings.

Usage

As MCP Server

Add to your MCP client configuration:

{
  "mcpServers": {
    "typeform": {
      "command": "node",
      "args": ["/path/to/typeform/dist/index.js"],
      "env": {
        "TYPEFORM_API_TOKEN": "your_token_here"
      }
    }
  }
}

Standalone

node dist/index.js

API Coverage

Covers major Typeform API endpoints:

• Forms API - Create, read, update, delete forms
• Responses API - Retrieve and manage form submissions
• Workspaces API - Organize forms by team/project
• Themes API - Custom branding and styling
• Images API - Manage uploaded media
• Webhooks API - Real-time response notifications
• Insights API - Form analytics and performance

Examples

Create a Contact Form

{
  "name": "create_form",
  "arguments": {
    "title": "Contact Us",
    "fields": [
      {
        "title": "What's your name?",
        "type": "short_text",
        "ref": "name"
      },
      {
        "title": "Your email address",
        "type": "email",
        "ref": "email"
      },
      {
        "title": "How can we help?",
        "type": "long_text",
        "ref": "message"
      }
    ],
    "settings": {
      "is_public": true,
      "show_progress_bar": true
    }
  }
}

Get Form Responses

{
  "name": "list_responses",
  "arguments": {
    "form_id": "abc123",
    "page_size": 50,
    "since": "2024-01-01T00:00:00Z"
  }
}

Setup Webhook

{
  "name": "create_webhook",
  "arguments": {
    "form_id": "abc123",
    "tag": "crm-integration",
    "url": "https://your-app.com/webhooks/typeform",
    "enabled": true
  }
}

Development

# Build
npm run build

# Watch mode
npm run dev

License

MIT