formbase MCP server

formbase MCP server

The hosted MCP server for formbase.so. formbase collects and verifies information from customers for workflows and AI agents. Your agent creates a request for one person. That person, the recipient, gets a branded form with what you already know filled in, completes it on any device without an account, and formbase hands the answers back under field keys your agent can read. Over the same connection an agent can also build, publish, translate and share forms, and read their submissions.

This repository holds documentation and example configs only. There is nothing to install or run. The server lives at:

https://api.formbase.so/api/mcp

It speaks MCP (the Model Context Protocol, the standard AI tools use to call other apps) over streamable HTTP. Most AI tools sign in with OAuth: you paste the URL, sign in to formbase in the browser, and pick a workspace. Scripts and headless agents send an API token instead.

Connect your AI tool

Leave any client ID, secret or token field empty. The tool finds the formbase sign-in page from the server and registers itself.

Claude Code

claude mcp add --transport http formbase https://api.formbase.so/api/mcp

Then type /mcp in Claude Code to sign in.

To share the server with everyone who works on a project, commit a .mcp.json to the project instead (this repository has a copy: .mcp.json):

{
  "mcpServers": {
    "formbase": {
      "type": "http",
      "url": "https://api.formbase.so/api/mcp"
    }
  }
}

Claude desktop (and claude.ai)

In Claude, open Customize › Connectors › + › Add custom connector and paste the URL. A connector added on claude.ai also works in the desktop and mobile apps. On Team and Enterprise, an owner adds it first under Organization settings › Connectors; on Free you can add one custom connector.

Cursor

Add this to .cursor/mcp.json in your project, or to ~/.cursor/mcp.json for every project (this repository has a copy: .cursor/mcp.json):

{
  "mcpServers": {
    "formbase": {
      "url": "https://api.formbase.so/api/mcp"
    }
  }
}

VS Code

Run MCP: Add Server from the Command Palette, choose HTTP, and paste the URL. See VS Code's MCP guide for where it saves the server.

Other tools

Any tool that supports remote MCP servers with sign-in works the same way: look for where it adds a server by URL. The connect guide also covers ChatGPT and Codex.

Sign in and pick a workspace

The first time the agent uses formbase, your AI tool opens a formbase page in the browser. Sign in, pick the workspace, and click Authorize. The connection reaches that one workspace only. To use another workspace, add formbase a second time and pick the other one.

To check that it works, ask:

List my formbase forms and whether each one is published.

To remove the connection, open OAuth and API Keys in the formbase workspace sidebar and click Disconnect next to it under Connected apps.

Scripts and headless agents: use an API token

A client that cannot open a browser, such as a script, a CI job or a headless agent, sends an API token as a header instead. Create one under OAuth and API Keys in your workspace sidebar (API tokens). It starts with fb_. Keep it out of git.

Claude Code, from the command line:

claude mcp add --transport http formbase https://api.formbase.so/api/mcp \
  --header "Authorization: Bearer fb_YOUR_TOKEN"

Or in a project's .mcp.json:

Shortened. The full README is on GitHub.