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