Formspring CLI

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

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

bash

formspring auth login --base-url https://formspring.io
formspring me get --json

Device authorization uses the same flow as MCP device login. Tokens are stored in ~/.config/formspring/config.json.

Common commands

Task	Command
List forms	`formspring forms list --json`
Any API route	`formspring api request GET /path`
List templates	`formspring templates list --product form`
Agent discovery	`formspring commands --json`

Use --json for machine-readable output. Pass bodies with --data @file.json or --stdin.

Keeping schemas in sync

When the API changes in this application, export manifests into the CLI repo:

bash

php artisan formspring:export-api-manifest --target=../formspring-cli/schema

See the CLI repository README for npm run sync-schema and parity checks.