KosmoKrator

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.

Inline Lua call
kosmo integrations:lua --eval 'dump(app.integrations.qualifying.list_accounts({limit = 1, page = 1}))' --json
Read Lua docs headlessly
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.

workflow.lua
local qualifying = app.integrations.qualifying
local result = qualifying.list_accounts({limit = 1, page = 1})

dump(result)
Run the workflow
kosmo integrations:lua workflow.lua --json
kosmo integrations:lua workflow.lua --force --json
Namespace note. 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.

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.
Metadata-derived Lua example
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
ParameterTypeRequiredDescription
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
ParameterTypeRequiredDescription
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
ParameterTypeRequiredDescription
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
ParameterTypeRequiredDescription
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
ParameterTypeRequiredDescription
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
ParameterTypeRequiredDescription
No parameters.