# BIMobject MCP

> BIMobject provides access to the world's leading repository of construction content. Use this MCP to search for specific building products, retrieve detailed technical specifications, and download native BIM files like Revit or IFC formats automatically from any AI agent.

## Overview
- **Category:** real-estate
- **Price:** Free
- **Tags:** bim-objects, aec-industry, architecture-design, revit-files, building-products, bimobject

## Description

Working in architecture and engineering means dealing with thousands of components—from window frames to insulation types. Trying to find the right product data often means hopping between manufacturer websites, downloading massive spec sheets, and manually cross-referencing file types. This MCP cuts that process out entirely. It lets your AI agent search the entire BIMobject marketplace for specific materials using simple keywords or filters. You can then pull granular metadata—like required structural load ratings or material composition—for any product found. Need the CAD files? The system identifies all available formats, whether it's Revit, ArchiCAD, or IFC. When you connect to this MCP via Vinkius, your agent handles the entire content orchestration, giving you structured data and file listings without you ever having to visit a separate developer portal.

## Tools

### get_brand_details
Retrieves specific information for a named manufacturer or brand.

### get_me
Checks the current profile details associated with your connected account.

### get_product_files
Lists all the available BIM file formats (e.g., Revit, IFC) linked to a given product.

### get_product_details
Pulls detailed technical information for a single, specified product ID.

### list_brands
Fetches a list of manufacturers and brands currently in the marketplace.

### list_categories
Lists the different, broad groupings of building products available for search.

### list_classifications
Provides a list of standard industry classification systems used to organize products.

### list_featured_products
Retrieves a curated list of popular or featured items from the marketplace.

### list_latest_products
Lists products that have been recently added to the BIMobject catalog.

### search_products
Searches the entire marketplace using keywords and filters for specific building materials or components.

## Prompt Examples

**Prompt:** 
```
Search BIMobject for 'sustainable insulation' and list the first 5 results.
```

**Response:** 
```
I've searched the BIMobject marketplace. Here are the top 5 results for 'sustainable insulation': 1. EcoWool Batt (ID: pr_1), 2. BioBoard Rigid (ID: pr_2)... Would you like the technical specs for any of these?
```

**Prompt:** 
```
Get all available Revit files for product ID 'p_999'.
```

**Response:** 
```
Retrieving file list for product 'Modern Windows' (ID: p_999)... I've found 2 Revit files: 1. Fixed Frame (v2023), 2. Sliding Unit (v2023). Both are available for immediate download.
```

**Prompt:** 
```
List all brands configured in my BIMobject project.
```

**Response:** 
```
Fetching manufacturers... I found several brands associated with your profile, including Rockfon, Knauf, and Armstrong Ceiling Solutions. Which one would you like to explore?
```

## Capabilities

### Search Building Products
Find specific construction materials or components across the marketplace using keywords and filters.

### Retrieve Technical Specifications
Get granular metadata, manufacturer details, and full product profiles for a selected item.

### List Available File Types
Check which BIM formats (Revit, IFC, etc.) are available for any specific product ID.

### Explore Brands and Categories
Browse manufacturer profiles or list all defined product categories to narrow down your search scope.

### View Featured Content
List top-selling or highly recommended products directly from the marketplace listings.

## Use Cases

### Checking Material Compliance
An architect needs to confirm if a specific wall panel brand has an IFC model available for their project. They ask their agent to `search_products` and then, on the result's ID, call `get_product_files`. The agent confirms availability and lists all versions.

### Building a Brand Index
A developer needs to list every major competitor in the insulation market. They use `list_brands` first, then loop through each brand using `get_brand_details` to pull full product catalog metadata for comparison.

### Quick Design Iteration
An engineer is redesigning a window unit and needs the exact U-value. They prompt their agent with keywords, trigger `search_products`, identify the right model, and immediately call `get_product_details` to get the required thermal rating.

### Curating a Project Showcase
A marketing team wants to build a landing page showing 'Top 10 Sustainable Materials.' They use `list_featured_products` and then pull detailed specs for each using `get_product_details` before writing the content.

## Benefits

- Stop guessing on specs. Use `get_product_details` to pull granular metadata instantly, so your agent knows the exact load rating or material composition you need for a design.
- Save time finding file types. Instead of manually checking if Revit models are available, `get_product_files` lists every BIM format (IFC, RVT, etc.) linked to a product ID in one call.
- Structure your search efficiently. Start with `list_brands` or `list_categories` to limit the scope before running `search_products`, making your queries faster and more focused.
- Keep track of what's new. Use `list_latest_products` when you need to check for emerging building materials, or look at `list_featured_products` for proven industry standards.
- Manage complexity with multiple tools. Your agent can combine a brand search (`get_brand_details`) with product searches (`search_products`), handling the entire data flow without manual steps.

## How It Works

The bottom line is that your AI client handles the entire content retrieval process in one conversation thread.

1. First, use `list_brands` to get a list of manufacturers or `search_products` with keywords to narrow down your project scope.
2. Next, pass the resulting product ID to `get_product_details` and specify the required file formats using `get_product_files`. This action gathers all necessary metadata for you.
3. Your agent compiles this structured data into a clean output, giving you everything needed—from brand history (`get_brand_details`) to direct download links.

## Frequently Asked Questions

**How does the `search_products` tool work?**
The `search_products` tool lets you query the entire BIMobject marketplace using keywords or filters. It returns a list of products that match your criteria, giving you IDs to investigate further.

**Can I use `get_product_files` without finding a product first?**
No, `get_product_files` requires an existing product ID. You must first run `search_products` or `get_product_details` to get the necessary identifier.

**What is the difference between `list_brands` and `get_brand_details`?**
`list_brands` gives you a directory of all available manufacturers. You use `get_brand_details` when you want deep information about one specific brand, like its founding or primary product lines.

**How do I find the best materials for my project?**
You should start by calling `list_categories` to see what grouping systems exist. Then use those categories in conjunction with `search_products` for a targeted result set.

**If I use the `get_me` tool, what information does it return about my user account?**
It returns your current profile details. This includes identifying metadata like your linked API key status and associated organizational identifiers. You use this to confirm that your connection is active and authorized for full marketplace access.

**When I call `list_categories`, are the categories regional, or do they cover all global product types?**
The system provides a comprehensive list of globally recognized classifications. These categories span major construction sectors, allowing you to filter products regardless of their specific geographic market. You can use this scope to narrow down your initial search parameters.

**What happens if I try to run `get_product_details` using a product ID that doesn't exist?**
The agent will return a clear 'Product Not Found' error. This explicit message includes the requested ID and a suggestion for potential misspellings or alternative search methods. It prevents ambiguous failures, letting you correct your input immediately.

**How do I get both the general description and technical data using `get_product_details`?**
You must provide the specific product ID to retrieve all linked metadata. The tool pulls together descriptive text, manufacturer specifications, and technical attributes in one call. This gives you a complete profile view without needing multiple separate requests.

**Can I automatically list all available file formats for a specific product?**
Yes! Use the `get_product_files` tool with the Product ID. Your agent will return download links for all available formats like Revit, ArchiCAD, and IFC.

**How do I search for products from a specific brand?**
You can use the `list_brands` tool to find the correct Brand ID and then include it as a filter in your `search_products` query.

**Does it support international classification systems like Uniclass or OmniClass?**
Yes! Use the `list_classifications` tool to retrieve the supported systems. You can then use these to filter your product searches according to industry standards.