All docs

Formspring CLI

Local command-line access to the REST API and MCP tools for scripts and coding agents.

Updated . 3 min read.

The Formspring CLI is a Node.js tool for humans and coding agents. It mirrors the public REST API at /api/v1 and exposes the operations that only the MCP server offers (templates, form stats, funnel builder helpers, the integration catalog).

The CLI is not published to a package registry yet. Build it from the repository, and use the REST API reference or the MCP server if you need a supported, versioned surface today.

Repository: github.com/formspring-io/formspring-cli

Install

bash
git clone git@github.com:formspring-io/formspring-cli.git
cd formspring-cli
npm install && npm run build && npm link

Authenticate

The CLI signs in with an API token or the device authorization flow described in MCP device login. Sign-in and token storage are handled by the CLI itself; its README lists the exact steps for the version you built.

Commands

Every command below is generated from the API manifest that the server exports for the CLI, so a route or tool that is not in that manifest has no command. Anything without a dedicated command is reachable through formspring api request <METHOD> <path>.

Task Command
Who am I formspring me get
List forms formspring forms list
Show, create, update, publish a form formspring forms get, formspring forms create, formspring forms update, formspring forms publish
List and export submissions formspring forms submissions list, formspring forms submissions export
Webhooks of a form formspring forms webhooks, formspring forms webhooks rotate-secret, formspring forms webhooks end-rotation
Any API route formspring api request GET /path
List templates formspring templates list
Integration catalog formspring integrations catalog
Tokens formspring tokens list, formspring tokens create, formspring tokens revoke, formspring tokens audit
Sandbox workspaces formspring sandbox create, formspring sandbox list, formspring sandbox delete

Migrations

Response imports use the response import API: formspring forms imports create, formspring forms imports dry-run, formspring forms imports confirm, formspring forms imports show, formspring forms imports resume, formspring forms imports reconcile and formspring forms imports rollback. Run formspring forms imports reconcile before a cutover; the exported import-contract.json describes the steps, limits and checksum.

Whole-workspace migrations use formspring migrations plan, formspring migrations start, formspring migrations status, formspring migrations apply, formspring migrations reconcile, formspring migrations cutover and formspring migrations rollback. Only link records are migrated today.

Pass bodies with a data file or standard input and ask for JSON output; the CLI's --help lists the flags of each command.