BionicForms MCP Server

MCP (Model Context Protocol) server that exposes the BionicForms REST API as tools for Claude. Build forms, manage responses, and trigger AI analysis — all from Claude Desktop or Claude Code.

Quick Start

Install via npm (no build step required):

npm install -g @bionicforms/mcp-server

Then configure your MCP client (see below) with bionicforms-mcp as the command.

Configuration

Claude Desktop

Add to your 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:

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

Getting an API Key

No API key yet? Use the register tool — it creates an account and returns a key in one step. Or register at bionicforms.com and generate a key from Settings > API Keys.

Environment Variables

| 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.

Available Tools (19)

Registration

• register — Create an account and get an API key (no auth needed)

Forms

• list_forms — List all forms in your workspace
• create_form — Create a form with optional fields
• get_form — Get form details and fields
• update_form — Update title or description
• delete_form — Permanently delete a form

Schema

• update_form_schema — Replace a form's fields
• publish_form — Publish a form to accept responses

Responses

• list_responses — List submissions for a form
• get_response — Get a single response's answers
• delete_response — Delete a response

Analysis

• trigger_analysis — Run AI analysis on responses (1 credit)
• get_analysis — Get analysis results
• query_analysis — Ask questions about responses (1 credit)

Webhooks

• list_webhooks — List configured webhooks
• create_webhook — Create a webhook endpoint
• update_webhook — Update webhook settings
• delete_webhook — Delete a webhook

Account

• get_account — View workspace info, plan, and credits

Supported Field Types

text, email, phone, url, number, date, textarea, dropdown, radio, checkbox, rating, nps, slider, file, signature

Example Prompts

"Create a customer feedback form with name, email, a 1–5 rating, and a comments field. Then publish it."

"List all my forms and show me the last 10 responses for the contact form."

"Run AI analysis on the NPS survey responses and summarize the main themes."

"Create a webhook for my contact form that posts to https://hooks.zapier.com/..."

"What's my current plan and how many analysis credits do I have left?"

Claude calls the right tools automatically — no API docs needed.

Links

• Docs: https://bionicforms.com/docs/mcp
• npm: https://www.npmjs.com/package/@bionicforms/mcp-server
• GitHub: https://github.com/bionicforms/mcp-server