Box

Follow these steps to run an MCP Box agent and connect a chatbot toolkit in the cloud using Meshagent Rooms.

Required Environment Variables

Set the following environment variables before starting the service:

• BOX_CLIENT_ID: Your Box application client ID
• BOX_CLIENT_SECRET: Your Box application client secret

Steps

1. Install Meshagent and Tool Support

   pip install "meshagent[all]"
   

2. Sign up and Authenticate

   • Register an account and authenticate your CLI following the guide:
     Meshagent CLI Getting Started

3. Launch the MCP Box Server as an Agent

   meshagent service test --room=test --role=agent --image=meshagent/mcp-box:latest \
     --env MESHAGENT_PORT=8001 \
     --env BOX_CLIENT_ID=your_client_id \
     --env BOX_CLIENT_SECRET=your_client_secret \
     --port="num=8001 path=/webhook liveness=/ type=meshagent.callable" \
     --name=mcp-box-service
   

   • This command will start a Meshagent room with the MCP server available as an agent.
     Note: Rooms automatically close if they go inactive.

4. Start a Chatbot with the Box Toolkit

   meshagent chatbot join --room=test --agent-name=sample --name=sample --toolkit=mcp-box
   

   • Starts a chatbot in the Meshagent room that can use the Box toolkit.
   • You can use multiple toolkits in the same room with the same agent.
   • The command output will provide a link to the room so you can interact with the agent and tools directly.

---

Tools Available

Tool Summary

Tools provided by this Server	Short Description
box_ai_extract_data	Extract data from a single file in Box using AI.
box_ask_ai_tool	Ask box ai about a file in Box.
box_ask_ai_tool_multi_file	Use Box AI to analyze and respond to a prompt based on the content of multiple files.
box_authorize_app_tool	Authorize the Box application.
box_docgen_create_batch_tool	Generate documents from a Box Doc Gen template using a local JSON file.
box_docgen_get_job_tool	Fetch a single DocGen job by its ID.
box_docgen_list_jobs_by_batch_tool	List all DocGen jobs that belong to a particular batch.
box_docgen_list_jobs_tool	List all DocGen jobs for the current user (paginated).
box_docgen_template_create_tool	Mark a file as a Box Doc Gen template.
box_docgen_template_delete_tool	Unmark a file as a Box Doc Gen template.
box_docgen_template_get_by_id_tool	Retrieve details of a specific Box Doc Gen template.
box_docgen_template_list_jobs_tool	List all Doc Gen jobs that used a specific template.
box_docgen_template_list_tags_tool	List all tags on a Box Doc Gen template.
box_docgen_template_list_tool	List all Box Doc Gen templates accessible to the user.
box_download_file_tool	Download a file from Box and return its content as a string.
box_hubs_ask_ai_tool	Ask box ai about a hub in Box.
box_list_folder_content_by_folder_id	List the content of a folder in Box by its ID.
box_manage_folder_tool	Manage Box folders - create, delete, or update.
box_read_tool	Read the text content of a file in Box.
box_search_folder_by_name	Locate a folder in Box by its name.
box_search_tool	Search for files in Box with the given query.
box_upload_file_from_content_tool	Upload content as a file to Box using the toolkit.
box_upload_file_from_path_tool	Upload a file to Box from a filesystem path.
box_who_am_i	Get the current user’s information.

---

Tools Details

Tool: box_ai_extract_data

Extract data from a single file in Box using AI.

Parameter	Type	Description
fields	string
file_id	string

---

Tool: box_ask_ai_tool

Ask box ai about a file in Box.

Parameter	Type	Description
file_id	string
prompt	string

---

Tool: box_ask_ai_tool_multi_file

Use Box AI to analyze and respond to a prompt based on the content of multiple files.

• Allows users to query Box AI with a prompt, leveraging the content of multiple files in Box. The AI processes the files and generates a response. | Parameter | Type | Description | |-----------|--------|-------------| | file_ids | array | | | prompt | string | |

---

Tool: box_authorize_app_tool

Authorize the Box application.

• Start the Box app authorization process.
• Returns: str - Message.

---

Tool: box_docgen_create_batch_tool

Generate documents from a Box Doc Gen template using a local JSON file.

Parameter	Type	Description
destination_folder_id	string
file_id	string
user_input_file_path	string
output_type	string	optional

---

Tool: box_docgen_get_job_tool

Fetch a single DocGen job by its ID.

Parameter	Type	Description
job_id	string

---

Tool: box_docgen_list_jobs_by_batch_tool

List all DocGen jobs that belong to a particular batch.

Parameter	Type	Description
batch_id	string
limit	string	optional
marker	string	optional

---

Tool: box_docgen_list_jobs_tool

List all DocGen jobs for the current user (paginated).

Parameter	Type	Description
limit	string	optional
marker	string	optional

---

Tool: box_docgen_template_create_tool

Mark a file as a Box Doc Gen template.

Parameter	Type	Description
file_id	string

---

Tool: box_docgen_template_delete_tool

Unmark a file as a Box Doc Gen template.

Parameter	Type	Description
template_id	string

---

Tool: box_docgen_template_get_by_id_tool

Retrieve details of a specific Box Doc Gen template.

Parameter	Type	Description
template_id	string

---

Tool: box_docgen_template_list_jobs_tool

List all Doc Gen jobs that used a specific template.

Parameter	Type	Description
template_id	string
limit	string	optional
marker	string	optional

---

Tool: box_docgen_template_list_tags_tool

List all tags on a Box Doc Gen template.

Parameter	Type	Description
template_id	string
limit	string	optional
marker	string	optional
template_version_id	string	optional

---

Tool: box_docgen_template_list_tool

List all Box Doc Gen templates accessible to the user.

Parameter	Type	Description
limit	string	optional
marker	string	optional

---

Tool: box_download_file_tool

Download a file from Box and return its content as a string.

• Supports text files (returns content directly) and images (returns base64-encoded).
• Other file types will return an error.
• Optionally saves the file locally.

Parameter	Type	Description
file_id	string
save_file	boolean	optional
save_path	string	optional

---

Tool: box_hubs_ask_ai_tool

Ask box ai about a hub in Box.

• Requires the hub ID.

Parameter	Type	Description
hubs_id	string
prompt	string

---

Tool: box_list_folder_content_by_folder_id

List the content of a folder in Box by its ID.

Parameter	Type	Description
folder_id	string
is_recursive	boolean	optional

---

Tool: box_manage_folder_tool

Manage Box folders - create, delete, or update.

Parameter	Type	Description
action	string
description	string	optional
folder_id	string	optional
name	string	optional
parent_id	string	optional
recursive	boolean	optional

---

Tool: box_read_tool

Read the text content of a file in Box.

Parameter	Type	Description
file_id	string

---

Tool: box_search_folder_by_name

Locate a folder in Box by its name.

Parameter	Type	Description
folder_name	string

---

Tool: box_search_tool

Search for files in Box with the given query.

Parameter	Type	Description
query	string
ancestor_folder_ids	string	optional
file_extensions	string	optional
where_to_look_for_query	string	optional

---

Tool: box_upload_file_from_content_tool

Upload content as a file to Box using the toolkit.

Parameter	Type	Description
content	string
file_name	string
folder_id	string	optional
is_base64	boolean	optional

---

Tool: box_upload_file_from_path_tool

Upload a file to Box from a filesystem path.

Parameter	Type	Description
file_path	string
folder_id	string	optional
new_file_name	string	optional

---

Tool: box_who_am_i

Get the current user’s information.

• Also useful to check the connection status.
• Returns: str – The current user’s information.

---

Meshagent & Box MCP Resources

• Meshagent Website
• Meshagent Room API: Getting Started
• Meshagent Room API: Overview
• Meshagent MCP Tool Image on Docker Hub

For more details on the Model Context Protocol, visit Anthropic’s MCP announcement.
Why run MCP Servers with Docker? Read more here.