How to Use the BoxHero MCP in LlamaIndex

Q: How do I load BoxHero MCP tools into my LlamaIndex pipeline?

Install llama-index-tools-mcp and initialize the BasicMCPClient with your Vinkius URL. Create an McpToolSpec instance and call totoollistasync to pass the BoxHero inventory tools to your LlamaIndex FunctionAgent.

Q: Does LlamaIndex support semantic search over BoxHero items?

Yes, you can pull your BoxHero item list using listitems, convert the JSON output into LlamaIndex Document objects, and index them. This allows your LlamaIndex agent to perform semantic search on BoxHero product descriptions and custom attributes.

Q: Can I limit which BoxHero MCP tools LlamaIndex can access?

Yes, you can use the allowedtools filter during setup to restrict your LlamaIndex agent to read-only BoxHero operations. For example, you can expose getitem and listitems while blocking write operations like deleteitem.

Q: How does the agent handle custom BoxHero item attributes?

The LlamaIndex agent uses listattributes to discover the custom schema of your BoxHero inventory. It then parses these BoxHero attributes to filter search results or format product details during a LlamaIndex RAG query.

Index BoxHero inventory data directly into LlamaIndex vector stores for semantic search and grounded RAG queries.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect BoxHero MCP to LlamaIndex

Create your Vinkius account to connect BoxHero to LlamaIndex and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup BoxHero with LlamaIndex

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Index BoxHero data into LlamaIndex vector stores

This BoxHero MCP Server allows LlamaIndex to fetch raw stock details using `list_items` and index them into your vector database. Your LlamaIndex agent queries this index to find BoxHero products using natural language descriptions, matching fuzzy search terms to actual SKU codes.

Ground LlamaIndex responses in BoxHero transaction data

Your LlamaIndex agent inspects BoxHero warehouse history using `list_transactions` to answer complex questions about stock movement patterns. It combines this temporal data with static BoxHero item details retrieved by `get_item` to build a complete picture in LlamaIndex.

Map BoxHero attributes to LlamaIndex queries

Your LlamaIndex pipeline queries custom product specs using `list_attributes` and maps them to BoxHero user search queries. When a user asks LlamaIndex for items matching specific dimensions, the agent retrieves the attributes and updates the BoxHero records via `update_item` if corrections are needed.

Setup guide

Set up BoxHero MCP in LlamaIndex

Prerequisites

Python 3.10+ installed
llama-index-tools-mcp package
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install llama-index-tools-mcp llama-index-llms-openai. The MCP tools package provides BasicMCPClient and McpToolSpec.
2

Connect with BasicMCPClient
Point BasicMCPClient to your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports SSE and Streamable HTTP transports.
3

Convert to LlamaIndex tools
Call mcp_tool_spec.to_tool_list_async() to convert all BoxHero MCP tools into native FunctionTool objects that any LlamaIndex agent can use.
4

Run with any LLM
Create a FunctionAgent with the tools and your preferred LLM. Swap OpenAI for Anthropic, Gemini, or any LlamaIndex-supported provider.

agent.py

from llama_index.tools.mcp import BasicMCPClient, McpToolSpec
from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI

# Connect to the MCP
mcp_client = BasicMCPClient(
    "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)
mcp_tool_spec = McpToolSpec(client=mcp_client)

# Convert MCP tools to LlamaIndex tools
tools = await mcp_tool_spec.to_tool_list_async()

# Create and run the agent
agent = FunctionAgent(
    tools=tools,
    llm=OpenAI(model="gpt-4o"),
    system_prompt="You have access to BoxHero tools.",
)
response = await agent.run("List recent BoxHero data")

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by BoxHero. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect BoxHero now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about BoxHero MCP in LlamaIndex

Install `llama-index-tools-mcp` and initialize the `BasicMCPClient` with your Vinkius URL. Create an `McpToolSpec` instance and call `to_tool_list_async` to pass the BoxHero inventory tools to your LlamaIndex `FunctionAgent`.

Yes, you can pull your BoxHero item list using `list_items`, convert the JSON output into LlamaIndex Document objects, and index them. This allows your LlamaIndex agent to perform semantic search on BoxHero product descriptions and custom attributes.

Yes, you can use the `allowed_tools` filter during setup to restrict your LlamaIndex agent to read-only BoxHero operations. For example, you can expose `get_item` and `list_items` while blocking write operations like `delete_item`.

The LlamaIndex agent uses `list_attributes` to discover the custom schema of your BoxHero inventory. It then parses these BoxHero attributes to filter search results or format product details during a LlamaIndex RAG query.

All retrieved BoxHero inventory items, custom attributes, and storage locations are processed in memory or stored in your local LlamaIndex vector database. The Vinkius MCP gateway uses zero-trust ephemeral environments, meaning your live BoxHero warehouse data is never cached or stored on external servers.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript