niceform-mcp-server

MCP (Model Context Protocol) server for niceform.ai - Create AI-powered forms from any MCP-compatible client like Claude Desktop.

Features

• create_form - Generate forms from natural language descriptions
• get_preview_url - Preview forms before publishing
• publish_form - Make forms live and publicly accessible
• list_form_responses - Retrieve paginated submissions for forms you own

Installation

From npm (when published)

npm install -g niceform-mcp-server

From source

# Clone the repository
git clone https://github.com/niceform/form-platform-web-app
cd form-platform-web-app

# Install dependencies
npm install

# Build the MCP server
npm run mcp:build

Configuration

Get an API Key

1. Sign in to niceform.ai
2. Go to Settings → API Keys
3. Create a new API key
4. Copy the key (it's only shown once!)

Environment Variables

| Variable | Required | Description | | ------------------ | -------- | ---------------------------------------------------- | | NICEFORM_API_KEY | Yes | Your niceform.ai API key | | NICEFORM_API_URL | No | API base URL (defaults to https://www.niceform.ai) |

Usage with Claude Desktop

Add to your Claude Desktop configuration file:

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

{
  "mcpServers": {
    "niceform": {
      "command": "npx",
      "args": ["niceform-mcp-server"],
      "env": {
        "NICEFORM_API_KEY": "nf_live_your_api_key_here"
      }
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "niceform": {
      "command": "niceform-mcp",
      "env": {
        "NICEFORM_API_KEY": "nf_live_your_api_key_here"
      }
    }
  }
}

Available Tools

create_form

Create a new form from a natural language description.

Parameters:

• description (required): Natural language description of the form
• idempotency_key (required): A unique caller-generated key, preferably a UUID; reuse it when retrying the same creation
• style_preference (optional): One of modern, minimal, colorful, professional, default

Example:

Create a customer feedback form for a coffee shop with:
- Overall rating (1-5 stars)
- Service quality rating
- Coffee quality rating
- Free text comments
- Optional email for follow-up

get_preview_url

Get the preview URL for a form to see how it looks.

Parameters:

• form_id (required): The form ID from create_form

publish_form

Publish a form to make it publicly accessible.

Parameters:

• form_id (required): The form ID to publish
• name (optional): Override the form name

list_form_responses

Retrieve submissions for a form you own. Responses may contain personal data, so only request and expose fields needed for the user's task.

Parameters:

• form_id (required): The form UUID or public ID
• status (optional): submitted, completed, incomplete, or all; defaults to submitted
• limit (optional): Integer page size from 1 to 100; defaults to 25
• cursor (optional): Opaque cursor returned by the preceding page

Example Workflow

You: Create a simple contact form with name, email, and message fields

Claude: [Uses create_form tool]
        Form created! Preview URL: https://www.niceform.ai/forms/abc123

You: Looks good, publish it

Claude: [Uses publish_form tool]
        Published! Share this URL: https://www.niceform.ai/forms/abc123

Development

# Watch mode (auto-rebuild on changes)
npm run mcp:dev

# Build once
npm run mcp:build

# Run the server directly
npm run mcp:start

Troubleshooting

"NICEFORM_API_KEY is not set"

Make sure your API key is correctly set in the Claude Desktop config file. The key should start with nf_live_ or nf_test_.

"Invalid API key"

Your API key may have been revoked or expired. Generate a new one from the niceform.ai dashboard.

"Rate limit exceeded"

You've made too many requests. Wait for the retry period indicated in the error message.

Tools not appearing in Claude

1. Restart Claude Desktop after updating the config
2. Check the config file syntax (must be valid JSON)
3. Verify the command path is correct

License

MIT

Links

• niceform.ai - AI-powered form builder
• MCP Documentation - Model Context Protocol
• Claude Desktop - Download Claude Desktop