KosmoKrator

other

Box MCP Integration for OpenAI Agents SDK

Connect Box to OpenAI Agents SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

10 functions 6 read 4 write Manual OAuth token auth
Submit Box feedback View package source

Connect Box 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.

Box MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

{
  "mcpServers": {
    "kosmokrator-box": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=box",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=box --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Box instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Box Tools Visible to OpenAI Agents

OpenAI Agents sees stable MCP tool names generated from the Box integration catalog.

MCP toolSource functionTypeDescription
integration__box__box_list_files box.box_list_files Read List files and folders in a Box folder. Returns item names, IDs, types (file or folder), sizes, and modification dates. Use folder ID "0" for the root folder.
integration__box__box_get_file box.box_get_file Read Get metadata for a Box file by ID. Returns the file name, size, type, created/modified dates, parent folder, and shared link info.
integration__box__box_upload_file box.box_upload_file Write Upload a file to Box. Provide the file name, content, and optionally a parent folder ID (defaults to root). Returns the uploaded file metadata.
integration__box__box_download_file box.box_download_file Read Download a file from Box by its ID. Returns the raw file contents. Use this to retrieve file data for processing.
integration__box__box_delete_file box.box_delete_file Write Delete a file from Box by its ID. This action moves the file to the trash. Use with caution — deleted files can be restored from the trash within the retention period.
integration__box__box_create_folder box.box_create_folder Write Create a new folder in Box. Provide a folder name and optionally a parent folder ID (defaults to root). Returns the new folder metadata.
integration__box__box_get_folder box.box_get_folder Read Get metadata for a Box folder by ID. Returns the folder name, size, created/modified dates, parent folder, and item counts. Use "0" for root.
integration__box__box_share_file box.box_share_file Write Create a shared link for a Box file. By default creates an open link. Optionally configure access level, password protection, and expiration.
integration__box__box_search box.box_search Read Search for files and folders in Box. Returns matching items with names, IDs, types, and paths. Useful for finding files by name or content.
integration__box__box_get_current_user box.box_get_current_user Read Get information about the currently authenticated Box user. Returns user name, email, login, and account details.

Related Box Pages

Box CLIUse direct JSON commands instead of MCP discovery. Box MCPFull gateway reference and MCP tool names. KosmoKrator for OpenAI AgentsClient-level gateway setup.