MCP Server Box

Extract or analyze information from one or more files using a natural language prompt and return a SINGLE response.

This tool provides maximum flexibility for data extraction and analysis. Instead of defining structured fields, you simply ask Box AI a question or give it instructions in natural language. When multiple files are provided, Box AI analyzes ALL files together to provide ONE comprehensive answer.

This is the most flexible extraction tool but provides unstructured results. Use structured extraction tools (template-based or field-based) when you need consistent, machine-readable output.

Use cases:

• Single file analysis: "What are the key terms of this contract?"

• Multiple files analysis: "Compare the pricing across these three proposals and summarize differences"

• Complex questions: "Based on these financial documents, what are the main risk factors?"

• Summarization: "Provide a 3-paragraph summary of the main points across these meeting notes"

NOT for batch processing: If you need to ask the same question about multiple files separately (e.g., "summarize each report individually"), call this tool once per file in a loop.

Args: ctx (Context): The context object containing the request and lifespan context. file_ids (List[str]): A list of file IDs to extract information from, example: ["1234567890", "0987654321"]. prompt (str): The fields to extract. ai_agent_id (Optional[str]): The ID of the AI agent to use for the extraction. If None, the default AI agent will be used. Returns: dict: The AI response containing the extracted information.