KosmoKrator

productivity

Gravity Forms CLI for AI Agents

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

7 functions 6 read 1 write API key auth

Gravity Forms CLI Setup

Gravity Forms can be configured headlessly with `kosmokrator integrations:configure gravity`.

# 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 gravity --set api_key="$GRAVITY_API_KEY" --enable --read allow --write ask --json
kosmokrator integrations:doctor gravity --json
kosmokrator integrations:status --json

Credentials

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

KeyEnv varTypeRequiredLabel
api_key GRAVITY_API_KEY Secret secret yes API Key
url GRAVITY_URL URL url no API Base URL

Call Gravity Forms Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call gravity.gravity_list_forms '{
  "limit": 1,
  "offset": 1
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:gravity gravity_list_forms '{
  "limit": 1,
  "offset": 1
}' --json

Agent Discovery Commands

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

kosmo integrations:docs gravity --json
kosmo integrations:docs gravity.gravity_list_forms --json
kosmo integrations:schema gravity.gravity_list_forms --json
kosmo integrations:search "Gravity Forms" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Gravity Forms.

gravity.gravity_list_forms

Read read

List forms available in Gravity with optional pagination.

Parameters
limit, offset

Generic CLI call

kosmo integrations:call gravity.gravity_list_forms '{"limit":1,"offset":1}' --json

Provider shortcut

kosmo integrations:gravity gravity_list_forms '{"limit":1,"offset":1}' --json

gravity.gravity_get_form

Read read

Get details for a specific Gravity form.

Parameters
form_id

Generic CLI call

kosmo integrations:call gravity.gravity_get_form '{"form_id":"example_form_id"}' --json

Provider shortcut

kosmo integrations:gravity gravity_get_form '{"form_id":"example_form_id"}' --json

gravity.gravity_submit_form

Write write

Submit a Gravity form with field values.

Parameters
form_id, data

Generic CLI call

kosmo integrations:call gravity.gravity_submit_form '{"form_id":"example_form_id","data":"example_data"}' --json

Provider shortcut

kosmo integrations:gravity gravity_submit_form '{"form_id":"example_form_id","data":"example_data"}' --json

gravity.gravity_list_submissions

Read read

List submissions for a specific Gravity form.

Parameters
form_id, limit, offset

Generic CLI call

kosmo integrations:call gravity.gravity_list_submissions '{"form_id":"example_form_id","limit":1,"offset":1}' --json

Provider shortcut

kosmo integrations:gravity gravity_list_submissions '{"form_id":"example_form_id","limit":1,"offset":1}' --json

gravity.gravity_list_entries

Read read

List entries for a specific Gravity form.

Parameters
form_id, limit, offset

Generic CLI call

kosmo integrations:call gravity.gravity_list_entries '{"form_id":"example_form_id","limit":1,"offset":1}' --json

Provider shortcut

kosmo integrations:gravity gravity_list_entries '{"form_id":"example_form_id","limit":1,"offset":1}' --json

gravity.gravity_get_entry

Read read

Get details for a specific Gravity entry.

Parameters
entry_id

Generic CLI call

kosmo integrations:call gravity.gravity_get_entry '{"entry_id":"example_entry_id"}' --json

Provider shortcut

kosmo integrations:gravity gravity_get_entry '{"entry_id":"example_entry_id"}' --json

gravity.gravity_get_current_user

Read read

Get profile information for the authenticated Gravity user.

Parameters
none

Generic CLI call

kosmo integrations:call gravity.gravity_get_current_user '{}' --json

Provider shortcut

kosmo integrations:gravity gravity_get_current_user '{}' --json

Function Schemas

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

gravity.gravity_list_forms

List forms available in Gravity with optional pagination.

Operation
Read read
Schema command
kosmo integrations:schema gravity.gravity_list_forms --json
ParameterTypeRequiredDescription
limit integer no Maximum number of forms to return.
offset integer no Pagination offset.

gravity.gravity_get_form

Get details for a specific Gravity form.

Operation
Read read
Schema command
kosmo integrations:schema gravity.gravity_get_form --json
ParameterTypeRequiredDescription
form_id string yes The form ID.

gravity.gravity_submit_form

Submit a Gravity form with field values.

Operation
Write write
Schema command
kosmo integrations:schema gravity.gravity_submit_form --json
ParameterTypeRequiredDescription
form_id string yes The form ID.
data object yes Form field values keyed by field name or ID.

gravity.gravity_list_submissions

List submissions for a specific Gravity form.

Operation
Read read
Schema command
kosmo integrations:schema gravity.gravity_list_submissions --json
ParameterTypeRequiredDescription
form_id string yes The form ID.
limit integer no Maximum number of submissions to return.
offset integer no Pagination offset.

gravity.gravity_list_entries

List entries for a specific Gravity form.

Operation
Read read
Schema command
kosmo integrations:schema gravity.gravity_list_entries --json
ParameterTypeRequiredDescription
form_id string yes The form ID.
limit integer no Maximum number of entries to return.
offset integer no Pagination offset.

gravity.gravity_get_entry

Get details for a specific Gravity entry.

Operation
Read read
Schema command
kosmo integrations:schema gravity.gravity_get_entry --json
ParameterTypeRequiredDescription
entry_id string yes The entry ID.

gravity.gravity_get_current_user

Get profile information for the authenticated Gravity user.

Operation
Read read
Schema command
kosmo integrations:schema gravity.gravity_get_current_user --json
ParameterTypeRequiredDescription
No 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.