education
Litmos MCP Integration for OpenAI Agents SDK
Connect Litmos to OpenAI Agents SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.
Connect Litmos to OpenAI Agents SDK
Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.
Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with
--write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.
Litmos MCP Config for OpenAI Agents SDK
Use headless JSON commands for CI-style execution and MCP for agent tool discovery.
{
"mcpServers": {
"kosmokrator-litmos": {
"type": "stdio",
"command": "kosmo",
"args": [
"mcp:serve",
"--integration=litmos",
"--write=deny"
]
}
}
} Run the Gateway Manually
kosmokrator mcp:serve --integration=litmos --write=deny Why Use KosmoKrator Here
Expose only Litmos instead of a broad multi-service tool list.
Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.
Start read-only, then opt into ask or allow for trusted workspaces.
Litmos Tools Visible to OpenAI Agents
OpenAI Agents sees stable MCP tool names generated from the Litmos integration catalog.
| MCP tool | Source function | Type | Description |
|---|---|---|---|
integration__litmos__litmos_list_users | litmos.litmos_list_users | Read | List users in your Litmos organization. Returns user IDs, names, emails, and status. Supports pagination and search. |
integration__litmos__litmos_get_user | litmos.litmos_get_user | Read | Get detailed information about a specific Litmos user by their ID, including profile data, course assignments, and team memberships. |
integration__litmos__litmos_create_user | litmos.litmos_create_user | Write | Create a new user in Litmos. Requires a first name, last name, email address, and username for login. |
integration__litmos__litmos_list_courses | litmos.litmos_list_courses | Read | List courses in your Litmos organization. Returns course IDs, names, descriptions, and status. Supports pagination and search. |
integration__litmos__litmos_get_course | litmos.litmos_get_course | Read | Get detailed information about a specific Litmos course by its ID, including modules, description, and completion settings. |
integration__litmos__litmos_list_teams | litmos.litmos_list_teams | Read | List teams in your Litmos organization. Returns team IDs, names, and description. Supports pagination. |
integration__litmos__litmos_get_current_user | litmos.litmos_get_current_user | Read | Get the profile of the currently authenticated Litmos user. Useful for verifying API credentials and identifying the connected account. |