NueForm

MCP Integration

Connect your favorite AI platform to NueForm using the Model Context Protocol.

The Model Context Protocol (MCP) is an open standard that lets AI assistants interact directly with external services. NueForm's MCP server gives your AI full access to your workspace — forms, responses, analytics, teams, webhooks, and more.

What Can You Do?

With MCP connected, you can ask your AI things like:

  • "What's my completion rate across all forms this month?"
  • "Create a customer satisfaction survey with NPS scoring."
  • "Export all responses from Q1 as a CSV."
  • "Add sarah@company.com to the Marketing team."
  • "Which questions take the longest to answer?"

Your AI translates these natural language requests into the appropriate NueForm API calls automatically.

Prerequisites

  • A NueForm account (free tier works)
  • An MCP-compatible AI client (see setup guides below)

Setup Guides

NueForm's MCP server URL:

text
https://nueform.com/api/mcp

Authentication is handled via OAuth — your AI client will open a browser window for you to sign in with your NueForm account. No API keys needed.

Claude Desktop

Add the following to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

json
{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.com/api/mcp"
    }
  }
}

Restart Claude Desktop. You'll be prompted to sign in with your NueForm account on first use.

Claude Code (CLI)

Run the following command:

bash
claude mcp add nueform --transport http https://nueform.com/api/mcp

Or add it to your .claude/settings.json:

json
{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.com/api/mcp"
    }
  }
}

Cursor

Add to your .cursor/mcp.json in your project root (or global settings):

json
{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.com/api/mcp"
    }
  }
}

Windsurf

Add to your MCP configuration in Windsurf settings:

json
{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.com/api/mcp"
    }
  }
}

VS Code (GitHub Copilot)

Add to .vscode/mcp.json in your workspace:

json
{
  "servers": {
    "nueform": {
      "url": "https://nueform.com/api/mcp"
    }
  }
}

Other MCP Clients

Any client that supports HTTP Streamable MCP transport can connect to NueForm. Point it to:

  • Server URL: https://nueform.com/api/mcp
  • Authentication: OAuth 2.0 (the client should handle the flow automatically)

Available Tools

NueForm's MCP server exposes 40 tools across 6 categories:

Forms (8 tools)

ToolDescription
list_formsList forms with search, pagination, and filters
get_formGet a form with all its questions
create_formCreate a new form with optional questions
update_formUpdate form settings and questions
delete_formDelete a form and all its data
publish_formPublish a form (creates a version snapshot)
unpublish_formUnpublish a form
duplicate_formDuplicate a form with all questions

Analytics (5 tools)

ToolDescription
get_dashboard_analyticsAggregated analytics across all forms
get_form_analyticsAnalytics for a specific form
get_geo_pointsGeographic scatter data for responses
get_temporal_responseResponse time distribution by hour
get_question_timingPer-question timing scatter data

Responses (5 tools)

ToolDescription
list_responsesList responses with date and completion filters
get_responseGet a single response with all answers
delete_responseDelete a single response
export_responses_csvExport all responses as CSV
bulk_delete_responsesDelete up to 100 responses at once

Webhooks (6 tools)

ToolDescription
get_form_webhookGet webhook config for a form
update_form_webhookSet or remove a form's webhook URL
list_global_webhooksList global webhook endpoints (Pro+)
update_global_webhooksUpdate global webhooks (Pro+)
get_webhook_secretGet webhook signing secret (Pro+)
regenerate_webhook_secretRegenerate signing secret (Pro+)

Teams (12 tools)

ToolDescription
list_teamsList all teams you belong to
create_teamCreate a new team
get_teamGet team details and members
update_teamUpdate team name
delete_teamDelete a team (owner only)
list_team_membersList team members
add_team_memberAdd a member by email
update_team_memberChange a member's role
remove_team_memberRemove a member
list_invitationsList pending invitations
create_invitationInvite a user by email
delete_invitationCancel a pending invitation

General (4 tools)

ToolDescription
get_userGet your profile and plan info
list_filesList uploaded files
get_form_themeGet a form's theme settings
update_form_themeUpdate colors, fonts, and styling

Example Usage

Analyzing Form Performance

You: "What's the completion rate for my Customer Feedback form this month?"

AI: Uses get_form_analytics with date filters, then reports: "Your Customer Feedback form has a 73% completion rate this month (219 completed out of 300 total responses). That's up from 68% last month."

Creating a Form

You: "Create a quick 3-question customer satisfaction survey with a rating, a comment box, and an email field."

AI: Uses create_form with questions array, then confirms: "Done! I've created 'Customer Satisfaction Survey' with 3 questions. Want me to publish it?"

Managing Responses

You: "Export all responses from my Job Application form as a CSV so I can review them in a spreadsheet."

AI: Uses export_responses_csv and returns the CSV data, which you can save to a file.

Troubleshooting

"Authentication failed"

Make sure you're signed into the correct NueForm account. Try disconnecting and reconnecting the MCP server in your AI client.

"Permission denied" on webhook or team tools

Some tools require specific plan tiers (Pro or Enterprise) or team roles (admin or owner). Check your plan on the billing page.

Tools not appearing

Restart your AI client after adding the MCP configuration. Some clients require a full restart to detect new MCP servers.

Rate limiting

NueForm's MCP server follows the same rate limits as the REST API. If you're making many requests in quick succession, the AI may need to wait between calls.

Last updated: April 6, 2026