MCP Server

Let Claude and other AI agents build forms, manage responses, and run analysis through the Model Context Protocol.

Package @bionicforms/mcp-server

The BionicForms MCP server exposes 19 tools that let AI agents create forms, collect responses, trigger AI analysis, and manage webhooks — all through natural language conversation.

REST API Docs Get your API key

Quick Start

Get up and running in under a minute. You need Node.js installed and a BionicForms API key.

1. Get an API key

Sign up at bionicforms.com and go to Settings → API Keys. Or let Claude do it — the register tool works without an API key.

2. Install the MCP server

Terminal

npm install -g @bionicforms/mcp-server

3. Add to your Claude config

See the Configuration section below for Claude Desktop and Claude Code setup.

4. Start using it

Ask Claude to create a form, list your responses, or run analysis — it will use the BionicForms tools automatically.

Configuration

Add the MCP server to your Claude client. Replace bf_k1_your_key_here with your actual API key.

Claude Desktop

Add to your claude_desktop_config.json:

claude_desktop_config.json

{ "mcpServers": { "bionicforms": { "command": "npx", "args": ["-y", "@bionicforms/mcp-server"], "env": { "BIONICFORMS_API_KEY": "bf_k1_your_key_here" } } } }

Claude Code

Add to .mcp.json in your project root:

.mcp.json

{ "mcpServers": { "bionicforms": { "command": "npx", "args": ["-y", "@bionicforms/mcp-server"], "env": { "BIONICFORMS_API_KEY": "bf_k1_your_key_here" } } } }

Authentication

The MCP server uses the same API keys as the REST API. Set your key via the BIONICFORMS_API_KEY environment variable in your Claude config.

No key yet? The register tool is the only tool that works without authentication. Ask Claude to register a new account and it will return an API key.

Get a key from Settings → API Keys in your dashboard, or use the register tool to create an account and key in one step.

Registration

Create an account and get an API key without any prior authentication.

Tool register

Create an account and get an API key

No authentication required. Returns an API key that can be used for all other tools.

Parameters

Name	Type	Required	Description
`email`	string	yes	Account email address
`password`	string	yes	Password (min 8 characters)
`name`	string	no	Display name

Forms

Create, list, update, and delete forms.

Tool list_forms

List all forms in your workspace

Returns form titles, statuses, response counts, and public URLs. Supports pagination.

Parameters

Name	Type	Required	Description
`page`	integer	no	Page number (default: 1)
`per_page`	integer	no	Results per page (default: 50, max: 100)

Tool create_form

Create a new form

Optionally include fields to set up the schema immediately. Call publish_form when ready to accept responses.

Parameters

Name	Type	Required	Description
`title`	string	yes	Form title
`description`	string	no	Form description
`fields`	array	no	Array of field objects (see Field Types)

Tool get_form

Get full details of a form

Returns fields, status, response count, and public URL.

Parameters

Name	Type	Required	Description
`form_id`	uuid	yes	Form ID

Tool update_form

Update a form's title or description

Does not modify the schema — use update_form_schema for that.

Parameters

Name	Type	Required	Description
`form_id`	uuid	yes	Form ID
`title`	string	no	New title
`description`	string	no	New description

Tool delete_form

Permanently delete a form

Deletes the form and all its responses. This cannot be undone.

Parameters

Name	Type	Required	Description
`form_id`	uuid	yes	Form ID

Schema

Manage form fields and publish forms.

Tool update_form_schema

Replace a form's fields entirely

Provide the complete list of fields — this overwrites the existing schema.

Parameters

Name	Type	Required	Description
`form_id`	uuid	yes	Form ID
`fields`	array	yes	Complete list of field objects

Tool publish_form

Publish a form to accept responses

Returns the public URL where respondents can fill out the form.

Parameters

Name	Type	Required	Description
`form_id`	uuid	yes	Form ID

Responses

List, view, and delete form submissions.

Tool list_responses

List submissions for a form

Supports pagination and text search across answers.

Parameters

Name	Type	Required	Description
`form_id`	uuid	yes	Form ID
`page`	integer	no	Page number (default: 1)
`per_page`	integer	no	Results per page (default: 50, max: 100)
`search`	string	no	Search text to filter responses

Tool get_response

Get a single response's full details

Returns all field answers for the submission.

Parameters

Name	Type	Required	Description
`form_id`	uuid	yes	Form ID
`response_id`	uuid	yes	Response ID

Tool delete_response

Permanently delete a response

This cannot be undone.

Parameters

Name	Type	Required	Description
`form_id`	uuid	yes	Form ID
`response_id`	uuid	yes	Response ID

Analysis

Trigger AI-powered analysis on form responses.

Tool trigger_analysis

Run AI analysis on all responses

Costs 1 AI credit. Returns a run ID — use get_analysis to check results.

Parameters

Name	Type	Required	Description
`form_id`	uuid	yes	Form ID

Tool get_analysis

Get analysis results

Returns summary, sentiment, themes, urgency, and quantitative stats. Returns null fields if analysis is still processing.

Parameters

Name	Type	Required	Description
`form_id`	uuid	yes	Form ID

Tool query_analysis

Ask a question about responses

Natural language query against analyzed data. Costs 1 AI credit. Requires a completed analysis run.

Parameters

Name	Type	Required	Description
`form_id`	uuid	yes	Form ID
`query`	string	yes	Natural language question

Webhooks

Receive real-time notifications when forms are submitted.

Tool list_webhooks

List all configured webhooks

Shows webhook URLs, descriptions, and active status.

Tool create_webhook

Create a webhook endpoint

Optionally scope to specific forms. Returns the webhook with its signing secret.

Parameters

Name	Type	Required	Description
`url`	string	yes	Webhook endpoint URL (must be HTTPS)
`description`	string	no	What this webhook is for
`form_ids`	array	no	Limit to specific form IDs

Tool update_webhook

Update webhook settings

Change URL, description, active status, or form scope.

Parameters

Name	Type	Required	Description
`webhook_id`	uuid	yes	Webhook ID
`url`	string	no	New endpoint URL
`description`	string	no	New description
`is_active`	boolean	no	Enable or disable
`form_ids`	array	no	New list of form IDs

Tool delete_webhook

Delete a webhook

Stops receiving events immediately.

Parameters

Name	Type	Required	Description
`webhook_id`	uuid	yes	Webhook ID

Account

View workspace and billing information.

Tool get_account

Get workspace info, plan, and credits

Returns current plan details and remaining AI credit balance.

Field Types

Supported field types when creating or updating form schemas. Each field needs at least a type and label.

Type	Description	Properties
`text`	Single-line text input	—
`email`	Email address with validation	—
`phone`	Phone number	—
`url`	URL with validation	—
`number`	Numeric input	—
`date`	Date picker	—
`textarea`	Multi-line text	—
`dropdown`	Single-select dropdown	`options: ["A", "B"]`
`radio`	Single-select radio buttons	`options: ["A", "B"]`
`checkbox`	Multi-select checkboxes	`options: ["A", "B"]`
`rating`	Star rating	`max: 5`
`nps`	Net Promoter Score (0-10)	—
`slider`	Range slider	`min, max, step`
`file`	File upload	—
`signature`	Signature pad	—

Example Field

{ "type": "dropdown", "label": "How did you hear about us?", "required": false, "properties": { "options": ["Search", "Social Media", "Referral", "Other"] } }

Environment Variables

Configure the MCP server via environment variables in your Claude config.

Variable	Required	Default	Description
`BIONICFORMS_API_KEY`	Yes*	—	Your API key (starts with `bf_k1_`)
`BIONICFORMS_URL`	No	`https://bionicforms.com`	API base URL

* Not required for the register tool, which is the only unauthenticated tool.

Example Prompts

Here are some things you can ask Claude once the MCP server is connected.

Create a form

"Create a customer feedback form with fields for name, email, a 1-5 rating, and a text area for comments. Then publish it."

Tools used: create_form → publish_form

Analyze responses

"Run an analysis on my feedback form and tell me what the top complaints are."

Tools used: list_forms → trigger_analysis → query_analysis

Set up webhooks

"Create a webhook to send submissions from my contact form to https://hooks.example.com/inbox."

Tools used: list_forms → create_webhook

Check your account

"How many AI credits do I have left? What plan am I on?"

Tools used: get_account