KosmoKrator

other

Box MCP Integration for LangGraph

Connect Box to LangGraph 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 LangGraph

Run KosmoKrator integration calls from LangGraph nodes while preserving local credentials and permissions.

Use a graph node that calls the KosmoKrator CLI for deterministic steps or an MCP client for dynamic tool selection. The gateway is local, scoped to this integration, and starts with --write=deny so LangGraph can inspect read-capable tools without receiving write access by default.

Box MCP Config for LangGraph

Headless CLI calls fit repeatable graph edges; MCP fits exploratory agent nodes.

{
  "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 LangGraph

LangGraph 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 LangGraphClient-level gateway setup.