productivity
Qualifying Lua API for KosmoKrator Agents
Agent-facing Lua documentation and function reference for the Qualifying KosmoKrator integration.Lua Namespace
Agents call this integration through app.integrations.qualifying.*.
Use lua_read_doc("integrations.qualifying") inside KosmoKrator to discover the same reference at runtime.
Call Lua from the Headless CLI
Use kosmo integrations:lua when a shell script, CI job, cron job, or another coding CLI should run a deterministic
Qualifying workflow without starting an interactive agent session.
kosmo integrations:lua --eval 'dump(app.integrations.qualifying.list_accounts({limit = 1, page = 1}))' --json kosmo integrations:lua --eval 'print(docs.read("qualifying"))' --json
kosmo integrations:lua --eval 'print(docs.read("qualifying.list_accounts"))' --json Workflow file
Put repeatable logic in a Lua file, then execute it with JSON output for the calling process.
local qualifying = app.integrations.qualifying
local result = qualifying.list_accounts({limit = 1, page = 1})
dump(result) kosmo integrations:lua workflow.lua --json
kosmo integrations:lua workflow.lua --force --json integrations:lua exposes app.integrations.qualifying, app.mcp.*, docs.*, json.*, and regex.*. Use app.integrations.qualifying.default.* or app.integrations.qualifying.work.* when you configured named credential accounts.
MCP-only Lua
If the script only needs configured MCP servers and does not need Qualifying, use the narrower mcp:lua command.
# Use mcp:lua for MCP-only scripts; use integrations:lua for this integration namespace.
kosmo mcp:lua --eval 'dump(mcp.servers())' --json Agent-Facing Lua Docs
This is the rendered version of the full Lua documentation exposed to agents when they inspect the integration namespace.
Qualifying Integration
Tools
qualifying_list_accounts
List sales accounts from Qualifying.
Parameters:
limit(integer, optional): Maximum number of accounts to return per page (default: 25, max: 100).page(integer, optional): Page number for pagination (default: 1).
qualifying_get_account
Get detailed information about a specific account.
Parameters:
id(string, required): The unique identifier of the account.
qualifying_list_contacts
List contacts from Qualifying with optional account filter.
Parameters:
limit(integer, optional): Maximum number of contacts to return per page (default: 25, max: 100).page(integer, optional): Page number for pagination (default: 1).account_id(string, optional): Filter contacts by account ID.
qualifying_get_contact
Get detailed information about a specific contact.
Parameters:
id(string, required): The unique identifier of the contact.
qualifying_list_deals
List deals from Qualifying with optional stage filter.
Parameters:
limit(integer, optional): Maximum number of deals to return per page (default: 25, max: 100).page(integer, optional): Page number for pagination (default: 1).stage(string, optional): Filter deals by pipeline stage (e.g., “lead”, “qualified”, “proposal”, “won”, “lost”).
qualifying_get_current_user
Get the profile of the currently authenticated user.
Parameters: None.
Raw agent markdown
# Qualifying Integration
## Tools
### qualifying_list_accounts
List sales accounts from Qualifying.
**Parameters:**
- `limit` (integer, optional): Maximum number of accounts to return per page (default: 25, max: 100).
- `page` (integer, optional): Page number for pagination (default: 1).
### qualifying_get_account
Get detailed information about a specific account.
**Parameters:**
- `id` (string, required): The unique identifier of the account.
### qualifying_list_contacts
List contacts from Qualifying with optional account filter.
**Parameters:**
- `limit` (integer, optional): Maximum number of contacts to return per page (default: 25, max: 100).
- `page` (integer, optional): Page number for pagination (default: 1).
- `account_id` (string, optional): Filter contacts by account ID.
### qualifying_get_contact
Get detailed information about a specific contact.
**Parameters:**
- `id` (string, required): The unique identifier of the contact.
### qualifying_list_deals
List deals from Qualifying with optional stage filter.
**Parameters:**
- `limit` (integer, optional): Maximum number of deals to return per page (default: 25, max: 100).
- `page` (integer, optional): Page number for pagination (default: 1).
- `stage` (string, optional): Filter deals by pipeline stage (e.g., "lead", "qualified", "proposal", "won", "lost").
### qualifying_get_current_user
Get the profile of the currently authenticated user.
**Parameters:** None. local result = app.integrations.qualifying.list_accounts({limit = 1, page = 1})
print(result) Functions
list_accounts Read
List sales accounts from Qualifying. Returns a paginated list of accounts with their details. Use limit and page parameters to navigate through results.
- Lua path
app.integrations.qualifying.list_accounts- Full name
qualifying.qualifying_list_accounts
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | integer | no | Maximum number of accounts to return per page (default: 25, max: 100). |
page | integer | no | Page number for pagination (default: 1). |
get_account Read
Get detailed information about a specific sales account in Qualifying. Returns the account's full profile including name, industry, website, and associated metadata.
- Lua path
app.integrations.qualifying.get_account- Full name
qualifying.qualifying_get_account
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | The unique identifier of the account. |
list_contacts Read
List contacts from Qualifying. Returns a paginated list of contacts. Optionally filter by account to see contacts belonging to a specific account.
- Lua path
app.integrations.qualifying.list_contacts- Full name
qualifying.qualifying_list_contacts
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | integer | no | Maximum number of contacts to return per page (default: 25, max: 100). |
page | integer | no | Page number for pagination (default: 1). |
account_id | string | no | Filter contacts by account ID to return only contacts associated with a specific account. |
get_contact Read
Get detailed information about a specific contact in Qualifying. Returns the contact's full profile including name, email, phone, associated account, and other metadata.
- Lua path
app.integrations.qualifying.get_contact- Full name
qualifying.qualifying_get_contact
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | The unique identifier of the contact. |
list_deals Read
List deals from Qualifying. Returns a paginated list of deals with their details. Optionally filter by stage to see deals in a specific pipeline stage (e.g., "lead", "qualified", "won", "lost").
- Lua path
app.integrations.qualifying.list_deals- Full name
qualifying.qualifying_list_deals
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | integer | no | Maximum number of deals to return per page (default: 25, max: 100). |
page | integer | no | Page number for pagination (default: 1). |
stage | string | no | Filter deals by pipeline stage (e.g., "lead", "qualified", "proposal", "won", "lost"). |
get_current_user Read
Get the profile of the currently authenticated Qualifying user. Returns user details such as name, email, and role. Useful for verifying the connection and understanding whose credentials are being used.
- Lua path
app.integrations.qualifying.get_current_user- Full name
qualifying.qualifying_get_current_user
| Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||