Can I use Wufoo as a CLI?

Yes. KosmoKrator exposes a Wufoo CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Wufoo through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Wufoo tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Wufoo credentials stored?

Wufoo credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Wufoo MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Wufoo CLI for AI Agents

Use the Wufoo CLI from KosmoKrator to call Wufoo tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

Wufoo CLI Setup

Wufoo can be configured headlessly with `kosmokrator integrations:configure wufoo`.

Install, configure, and verify

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure wufoo --set api_key="$WUFOO_API_KEY" --enable --read allow --write ask --json
kosmokrator integrations:doctor wufoo --json
kosmokrator integrations:status --json

Credentials

Authentication type: API key api_key. Configure credentials once, then reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.

Key	Env var	Type	Required	Label
`api_key`	`WUFOO_API_KEY`	Secret `secret`	yes	API Key
`base_url`	`WUFOO_BASE_URL`	URL `url`	no	API Base URL

Command Patterns

The generic command is stable across every integration. The provider shortcut is shorter for humans.

Generic CLI call

kosmo integrations:call wufoo.wufoo_get_current_user '{}' --json

Provider shortcut

kosmo integrations:wufoo wufoo_get_current_user '{}' --json

Discovery

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

Discovery commands

kosmo integrations:docs wufoo --json
kosmo integrations:docs wufoo.wufoo_get_current_user --json
kosmo integrations:schema wufoo.wufoo_get_current_user --json
kosmo integrations:search "Wufoo" --json
kosmo integrations:list --json

Automation Contexts

The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.

CI Run integration calls from CI jobs with JSON output, explicit credentials, and predictable exit status. Cron Jobs Schedule repeatable integration workflows from cron while keeping credentials in KosmoKrator config. Shell Scripts Call integration functions from shell scripts with stable JSON input and output. Headless Automation Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers. Coding Agents Let coding agents discover schemas and execute integration functions through CLI commands or MCP.

CLI Functions

Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.

`wufoo.wufoo_get_current_user`

Get the authenticated Wufoo user's profile. Returns account details such as name, email, and organization.

Read read

Parameters: none

Generic call

kosmo integrations:call wufoo.wufoo_get_current_user '{}' --json

Shortcut

kosmo integrations:wufoo wufoo_get_current_user '{}' --json

`wufoo.wufoo_list_users`

List Wufoo account users visible to the API key.

Read read

Parameters: params

Generic call

kosmo integrations:call wufoo.wufoo_list_users '{"params":"example_params"}' --json

Shortcut

kosmo integrations:wufoo wufoo_list_users '{"params":"example_params"}' --json

`wufoo.wufoo_list_forms`

List all forms in your Wufoo account. Returns form identifiers, names, descriptions, and metadata that can be used with other Wufoo tools.

Read read

Parameters: none

Generic call

kosmo integrations:call wufoo.wufoo_list_forms '{}' --json

Shortcut

kosmo integrations:wufoo wufoo_list_forms '{}' --json

`wufoo.wufoo_get_form`

Get details for a specific Wufoo form by its identifier. Returns the full form definition including fields, settings, and metadata.

Read read

Parameters: form_id

Generic call

kosmo integrations:call wufoo.wufoo_get_form '{"form_id":"example_form_id"}' --json

Shortcut

kosmo integrations:wufoo wufoo_get_form '{"form_id":"example_form_id"}' --json

`wufoo.wufoo_list_fields`

List all fields for a specific Wufoo form. Returns field types, labels, API IDs, and validation rules. Use this to discover field IDs before submitting entries.

Read read

Parameters: form_id

Generic call

kosmo integrations:call wufoo.wufoo_list_fields '{"form_id":"example_form_id"}' --json

Shortcut

kosmo integrations:wufoo wufoo_list_fields '{"form_id":"example_form_id"}' --json

`wufoo.wufoo_list_entries`

List entries submitted to a Wufoo form. Supports pagination and optional filters to narrow results. Use the page and pageSize parameters to paginate through large result sets.

Read read

Parameters: form_id, page, page_size, filters

Generic call

kosmo integrations:call wufoo.wufoo_list_entries '{"form_id":"example_form_id","page":1,"page_size":1,"filters":"example_filters"}' --json

Shortcut

kosmo integrations:wufoo wufoo_list_entries '{"form_id":"example_form_id","page":1,"page_size":1,"filters":"example_filters"}' --json

`wufoo.wufoo_count_entries`

Count entries submitted to a Wufoo form with optional filters.

Read read

Parameters: form_id, params

Generic call

kosmo integrations:call wufoo.wufoo_count_entries '{"form_id":"example_form_id","params":"example_params"}' --json

Shortcut

kosmo integrations:wufoo wufoo_count_entries '{"form_id":"example_form_id","params":"example_params"}' --json

`wufoo.wufoo_get_entry`

Find a single Wufoo form entry by form ID and entry ID using the documented form entries endpoint.

Read read

Parameters: form_id, entry_id

Generic call

kosmo integrations:call wufoo.wufoo_get_entry '{"form_id":"example_form_id","entry_id":"example_entry_id"}' --json

Shortcut

kosmo integrations:wufoo wufoo_get_entry '{"form_id":"example_form_id","entry_id":"example_entry_id"}' --json

`wufoo.wufoo_submit_entry`

Submit a new entry to a Wufoo form. Provide field values keyed by their API field IDs (e.g., Field1, Field2). Use list_fields to discover the field IDs for a form.

Write write

Parameters: form_id, fields

Generic call

kosmo integrations:call wufoo.wufoo_submit_entry '{"form_id":"example_form_id","fields":"example_fields"}' --json

Shortcut

kosmo integrations:wufoo wufoo_submit_entry '{"form_id":"example_form_id","fields":"example_fields"}' --json

`wufoo.wufoo_list_form_comments`

List comments made on entries for a Wufoo form.

Read read

Parameters: form_id, params

Generic call

kosmo integrations:call wufoo.wufoo_list_form_comments '{"form_id":"example_form_id","params":"example_params"}' --json

Shortcut

kosmo integrations:wufoo wufoo_list_form_comments '{"form_id":"example_form_id","params":"example_params"}' --json

`wufoo.wufoo_count_form_comments`

Count comments made on entries for a Wufoo form.

Read read

Parameters: form_id, params

Generic call

kosmo integrations:call wufoo.wufoo_count_form_comments '{"form_id":"example_form_id","params":"example_params"}' --json

Shortcut

kosmo integrations:wufoo wufoo_count_form_comments '{"form_id":"example_form_id","params":"example_params"}' --json

`wufoo.wufoo_list_reports`

List all reports in your Wufoo account. Returns report identifiers, names, descriptions, and the forms they are associated with.

Read read

Parameters: none

Generic call

kosmo integrations:call wufoo.wufoo_list_reports '{}' --json

Shortcut

kosmo integrations:wufoo wufoo_list_reports '{}' --json

`wufoo.wufoo_get_report`

Get details for a specific Wufoo report.

Read read

Parameters: report_id

Generic call

kosmo integrations:call wufoo.wufoo_get_report '{"report_id":"example_report_id"}' --json

Shortcut

kosmo integrations:wufoo wufoo_get_report '{"report_id":"example_report_id"}' --json

`wufoo.wufoo_list_report_entries`

List entries exposed by a Wufoo report.

Read read

Parameters: report_id, params

Generic call

kosmo integrations:call wufoo.wufoo_list_report_entries '{"report_id":"example_report_id","params":"example_params"}' --json

Shortcut

kosmo integrations:wufoo wufoo_list_report_entries '{"report_id":"example_report_id","params":"example_params"}' --json

`wufoo.wufoo_count_report_entries`

Count entries exposed by a Wufoo report.

Read read

Parameters: report_id, params

Generic call

kosmo integrations:call wufoo.wufoo_count_report_entries '{"report_id":"example_report_id","params":"example_params"}' --json

Shortcut

kosmo integrations:wufoo wufoo_count_report_entries '{"report_id":"example_report_id","params":"example_params"}' --json

`wufoo.wufoo_list_report_fields`

List field definitions used by a Wufoo report.

Read read

Parameters: report_id, params

Generic call

kosmo integrations:call wufoo.wufoo_list_report_fields '{"report_id":"example_report_id","params":"example_params"}' --json

Shortcut

kosmo integrations:wufoo wufoo_list_report_fields '{"report_id":"example_report_id","params":"example_params"}' --json

`wufoo.wufoo_list_report_widgets`

List widgets configured on a Wufoo report.

Read read

Parameters: report_id, params

Generic call

kosmo integrations:call wufoo.wufoo_list_report_widgets '{"report_id":"example_report_id","params":"example_params"}' --json

Shortcut

kosmo integrations:wufoo wufoo_list_report_widgets '{"report_id":"example_report_id","params":"example_params"}' --json

`wufoo.wufoo_add_webhook`

Add a webhook to a Wufoo form.

Write write

Parameters: form_id, url, handshake_key, metadata

Generic call

kosmo integrations:call wufoo.wufoo_add_webhook '{"form_id":"example_form_id","url":"example_url","handshake_key":"example_handshake_key","metadata":true}' --json

Shortcut

kosmo integrations:wufoo wufoo_add_webhook '{"form_id":"example_form_id","url":"example_url","handshake_key":"example_handshake_key","metadata":true}' --json

`wufoo.wufoo_delete_webhook`

Delete a webhook from a Wufoo form.

Write write

Parameters: form_id, webhook_id

Generic call

kosmo integrations:call wufoo.wufoo_delete_webhook '{"form_id":"example_form_id","webhook_id":"example_webhook_id"}' --json

Shortcut

kosmo integrations:wufoo wufoo_delete_webhook '{"form_id":"example_form_id","webhook_id":"example_webhook_id"}' --json

`wufoo.wufoo_api_get`

Call a documented Wufoo API v3 GET endpoint.

Read read

Parameters: path, params

Generic call

kosmo integrations:call wufoo.wufoo_api_get '{"path":"example_path","params":"example_params"}' --json

Shortcut

kosmo integrations:wufoo wufoo_api_get '{"path":"example_path","params":"example_params"}' --json

`wufoo.wufoo_api_post`

Call a documented Wufoo API v3 POST endpoint.

Write write

Parameters: path, body

Generic call

kosmo integrations:call wufoo.wufoo_api_post '{"path":"example_path","body":"example_body"}' --json

Shortcut

kosmo integrations:wufoo wufoo_api_post '{"path":"example_path","body":"example_body"}' --json

`wufoo.wufoo_api_put`

Call a documented Wufoo API v3 PUT endpoint.

Write write

Parameters: path, body

Generic call

kosmo integrations:call wufoo.wufoo_api_put '{"path":"example_path","body":"example_body"}' --json

Shortcut

kosmo integrations:wufoo wufoo_api_put '{"path":"example_path","body":"example_body"}' --json

`wufoo.wufoo_api_delete`

Call a documented Wufoo API v3 DELETE endpoint.

Write write

Parameters: path, params

Generic call

kosmo integrations:call wufoo.wufoo_api_delete '{"path":"example_path","params":"example_params"}' --json

Shortcut

kosmo integrations:wufoo wufoo_api_delete '{"path":"example_path","params":"example_params"}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

wufoo.wufoo_get_current_user 0 parameters

Schema command

kosmo integrations:schema wufoo.wufoo_get_current_user --json

Parameter	Type	Required	Description
No parameters.

wufoo.wufoo_list_users 1 parameters

Schema command

kosmo integrations:schema wufoo.wufoo_list_users --json

Parameter	Type	Required	Description
`params`	object	no	Optional query parameters such as pretty.

wufoo.wufoo_list_forms 0 parameters

Schema command

kosmo integrations:schema wufoo.wufoo_list_forms --json

Parameter	Type	Required	Description
No parameters.

wufoo.wufoo_get_form 1 parameters

Schema command

kosmo integrations:schema wufoo.wufoo_get_form --json

Parameter	Type	Required	Description
`form_id`	string	yes	The form hash or identifier (e.g., "q1w2e3r4t5y6").

wufoo.wufoo_list_fields 1 parameters

Schema command

kosmo integrations:schema wufoo.wufoo_list_fields --json

Parameter	Type	Required	Description
`form_id`	string	yes	The form hash or unique identifier.

wufoo.wufoo_list_entries 4 parameters

Schema command

kosmo integrations:schema wufoo.wufoo_list_entries --json

Parameter	Type	Required	Description
`form_id`	string	yes	The form hash or identifier to list entries for.
`page`	integer	no	Page number for pagination (0-based). Default: 0.
`page_size`	integer	no	Number of entries per page. Default: 25, maximum: 100.
`filters`	object	no	Optional field filters. Keys are filter parameters (e.g., "Filter1", "Match", "SortBy") and values are the filter values.

wufoo.wufoo_count_entries 2 parameters

Schema command

kosmo integrations:schema wufoo.wufoo_count_entries --json

Parameter	Type	Required	Description
`form_id`	string	yes	The form hash or title identifier.
`params`	object	no	Optional query parameters such as Filter1, Match, or pretty.

wufoo.wufoo_get_entry 2 parameters

Schema command

kosmo integrations:schema wufoo.wufoo_get_entry --json

Parameter	Type	Required	Description
`form_id`	string	yes	The form hash or title identifier.
`entry_id`	string	yes	The entry identifier to retrieve.

wufoo.wufoo_submit_entry 2 parameters

Schema command

kosmo integrations:schema wufoo.wufoo_submit_entry --json

Parameter	Type	Required	Description
`form_id`	string	yes	The form hash or unique identifier.
`fields`	object	yes	Object mapping field API IDs to their values (e.g., {"Field1": "John", "Field2": "john@example.com"}). Use list_fields to discover field IDs.

wufoo.wufoo_list_form_comments 2 parameters

Schema command

kosmo integrations:schema wufoo.wufoo_list_form_comments --json

Parameter	Type	Required	Description
`form_id`	string	yes	The form hash or title identifier.
`params`	object	no	Optional query parameters such as entryId, pageStart, pageSize, or pretty.

wufoo.wufoo_count_form_comments 2 parameters

Schema command

kosmo integrations:schema wufoo.wufoo_count_form_comments --json

Parameter	Type	Required	Description
`form_id`	string	yes	The form hash or title identifier.
`params`	object	no	Optional query parameters such as pretty.

wufoo.wufoo_list_reports 0 parameters

Schema command

kosmo integrations:schema wufoo.wufoo_list_reports --json

Parameter	Type	Required	Description
No parameters.

wufoo.wufoo_get_report 1 parameters

Schema command

kosmo integrations:schema wufoo.wufoo_get_report --json

Parameter	Type	Required	Description
`report_id`	string	yes	The report hash or title identifier.

wufoo.wufoo_list_report_entries 2 parameters

Schema command

kosmo integrations:schema wufoo.wufoo_list_report_entries --json

Parameter	Type	Required	Description
`report_id`	string	yes	The report hash or title identifier.
`params`	object	no	Optional query parameters such as pageStart, pageSize, sort, sortDirection, Filter1, or Match.

wufoo.wufoo_count_report_entries 2 parameters

Schema command

kosmo integrations:schema wufoo.wufoo_count_report_entries --json

Parameter	Type	Required	Description
`report_id`	string	yes	The report hash or title identifier.
`params`	object	no	Optional query parameters such as pretty.

wufoo.wufoo_list_report_fields 2 parameters

Schema command

kosmo integrations:schema wufoo.wufoo_list_report_fields --json

Parameter	Type	Required	Description
`report_id`	string	yes	The report hash or title identifier.
`params`	object	no	Optional query parameters such as system or pretty.

wufoo.wufoo_list_report_widgets 2 parameters

Schema command

kosmo integrations:schema wufoo.wufoo_list_report_widgets --json

Parameter	Type	Required	Description
`report_id`	string	yes	The report hash or title identifier.
`params`	object	no	Optional query parameters such as pretty.

wufoo.wufoo_add_webhook 4 parameters

Schema command

kosmo integrations:schema wufoo.wufoo_add_webhook --json

Parameter	Type	Required	Description
`form_id`	string	yes	The form hash or title identifier.
`url`	string	yes	The HTTPS endpoint Wufoo should call.
`handshake_key`	string	no	Optional shared secret sent with webhook payloads.
`metadata`	boolean	no	Whether Wufoo should include form and field metadata. Default: false.

wufoo.wufoo_delete_webhook 2 parameters

Schema command

kosmo integrations:schema wufoo.wufoo_delete_webhook --json

Parameter	Type	Required	Description
`form_id`	string	yes	The form hash or title identifier.
`webhook_id`	string	yes	The webhook hash identifier.

wufoo.wufoo_api_get 2 parameters

Schema command

kosmo integrations:schema wufoo.wufoo_api_get --json

Parameter	Type	Required	Description
`path`	string	yes	Endpoint path, such as /forms.json.
`params`	object	no	Optional query parameters.

wufoo.wufoo_api_post 2 parameters

Schema command

kosmo integrations:schema wufoo.wufoo_api_post --json

Parameter	Type	Required	Description
`path`	string	yes	Endpoint path, such as /forms/{id}/entries.json.
`body`	object	no	Form-encoded body fields.

wufoo.wufoo_api_put 2 parameters

Schema command

kosmo integrations:schema wufoo.wufoo_api_put --json

Parameter	Type	Required	Description
`path`	string	yes	Endpoint path, such as /forms/{id}/webhooks.json.
`body`	object	no	Form-encoded body fields.

wufoo.wufoo_api_delete 2 parameters

Schema command

kosmo integrations:schema wufoo.wufoo_api_delete --json

Parameter	Type	Required	Description
`path`	string	yes	Endpoint path, such as /forms/{id}/webhooks/{webhook_id}.json.
`params`	object	no	Optional request parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.