# Boxhero — how to use (mcp.ai)

Connect your Boxhero account and use 14 tools for product management straight from your AI agent. Connect with your own API key. BoxHero is a cloud-based inventory management solution designed for small to medium-sized businesses, offering real-time updates, barcode scanning, team collaboration, and analytics.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_boxhero?ms=1787291220000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `boxhero_delete_item`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/boxhero`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/boxhero/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/boxhero/delete/item` — Tool to delete a specific item (barcode) by its ID. Use when you need to remove an item from the inventory.
  - body: { item_id: integer }
- `POST https://api.mcp.ai/api/boxhero/delete/location` — Tool to delete a specific warehouse location by its ID. Use when you need to remove a location from the system.
  - body: { location_id: integer }
- `POST https://api.mcp.ai/api/boxhero/get/item` — Tool to retrieve a specific item (barcode) by ID. Use when you need detailed information about a single item including its attributes, pricing, and inventory quantities.
  - body: { item_id: integer, location_ids?: integer[] }
- `POST https://api.mcp.ai/api/boxhero/get/item/attribute` — Tool to retrieve a specific item attribute by ID. Use when you need to get detailed information about an item attribute specification.
  - body: { attr_id: integer }
- `POST https://api.mcp.ai/api/boxhero/get/location` — Tool to retrieve a specific location by ID. Use when you need detailed information about a particular warehouse location including its name, quantity, and notes.
  - body: { location_id: integer }
- `POST https://api.mcp.ai/api/boxhero/get/member` — Tool to retrieve a specific team member by ID. Use when you need to get details about a particular member.
  - body: { member_id: integer }
- `POST https://api.mcp.ai/api/boxhero/get/team/info` — Tool to get information about the linked team and its mode. Use when you need to retrieve the currently linked team details.
- `POST https://api.mcp.ai/api/boxhero/list/basic/transactions` — Tool to list basic inventory transactions. Use when you need a high-level overview of in/out/move transactions.
  - body: { limit?: integer, cursor?: string, location_id?: integer }
- `POST https://api.mcp.ai/api/boxhero/list/item/attributes` — Tool to retrieve the list of item attribute specifications used within the team. Use when you need to understand what custom attributes are defined for items.
- `POST https://api.mcp.ai/api/boxhero/list/items` — Tool to list items. Use when fetching products with optional location filters and pagination.
  - body: { limit?: integer, cursor?: string, location_ids?: integer[] }
- `POST https://api.mcp.ai/api/boxhero/list/location/transactions` — Tool to retrieve the list of transactions in location mode. Use when you need to fetch transaction history with location-based details including in/out/move/adjust operations.
  - body: { type?: string, limit?: integer, cursor?: integer }
- `POST https://api.mcp.ai/api/boxhero/list/locations` — Tool to list warehouse locations. Use when you need valid warehouse_id values for filtering transactions.
- `POST https://api.mcp.ai/api/boxhero/list/members` — Tool to retrieve the list of team members. Use when you need to get all members in the team with their roles.
- `POST https://api.mcp.ai/api/boxhero/list/partners` — Tool to list partners (suppliers and customers). Use when retrieving partner information with optional type filtering and pagination.
  - body: { type?: string, limit?: integer, cursor?: integer }

## Example prompts
- "What can I do in Boxhero?"
- "Show me a summary of my Boxhero account"

## More
- Page: https://mcp.ai/boxhero
- Agent spec (llms.txt): https://mcp.ai/boxhero/llms.txt
- Postman collection: https://mcp.ai/boxhero/postman.json