# AI Furniture & Home Product Hub — MCP Server

> Millimeter-precision product data for AI agents: furniture, home appliances, gadgets, beauty devices, smart home, and more.
> 15 MCP tools + 3 prompt workflows across 31 categories and 90+ brands (355+ products).
> Curated sets (15 bundles, 8 room presets, influencer picks), dimension-compatible replacement with 25-entry compatibility DB, AI visibility diagnosis.
> Operated by ONE, Inc. (Japan).

## Contact

- GitHub Issues: <https://github.com/ONE8943/ai-furniture-hub/issues>
- Repository: <https://github.com/ONE8943/ai-furniture-hub>
- npm: <https://www.npmjs.com/package/ai-furniture-hub>

## MCP Connection

- Registry name: `io.github.ONE8943/ai-furniture-hub`
- Remote Streamable HTTP: <https://ai-furniture-hub.onrender.com/mcp>
- Well-known discovery: <https://ai-furniture-hub.onrender.com/.well-known/mcp.json>
- stdio package: `npx ai-furniture-hub`

## Services

### Product Search & Discovery
Search curated product catalog by mm-precision dimensions, price range, color, category, brand, or free-text keyword.
Rotation-aware space fitting: automatically checks if products fit when width/depth are swapped.
Color alias support: "白" matches ホワイト, アイボリー, etc.

### Related-Item Chains
Every product links to required accessories, protection materials, consumables, and add-ons.
Example: Air purifier → HEPA filter (required, replace every 2 years) + hygrometer + caster stand.
Use `depth=2` to traverse "related items of related items."

### Shelf + Storage Coordination
Given a shelf keyword, calculates how many storage boxes fit per tier, total quantity needed, and total cost including affiliate links.

### Space-Based Suggestions
Provide dimensions in mm → receive all products that fit, grouped by category, with margin calculations.

### Product Identification
Visual feature text (from photo/vision AI) → candidate products with model numbers, inner dimensions, compatible storage.

### Product Comparison
Side-by-side comparison of 2–5 products on price, dimensions, load capacity, material, and running cost.

### Replacement Finder (Enhanced)
Discontinued/old model → successor and alternative products from catalog + Rakuten live search.
NEW: Dimension-compatible alternatives with fit_score (0-100). Products with high fit_score can replace the original in the same physical space.

### Curated Sets & Expert Picks
Curated bundles (e.g., "New Life Starter Kit"), room presets (IKEA-style room sets), influencer picks (YouTuber/magazine recommendations), and hack sets (budget alternatives).
Each product links back to full catalog data via product IDs.

### AI Visibility Diagnosis (AIO)
Diagnose any website's AI visibility: checks llms.txt, robots.txt (AI crawler access), structured data (JSON-LD), OGP tags, dimension format, and cross-border readiness.
Returns 0-100 score with A-F grade. Useful for "How does AI see your products?" consulting.

### Room Layout Simulation
Floor-plan grid packing: given room dimensions and furniture list, returns placement coordinates.

### Affiliate Integration
Rakuten Ichiba API (live search with prices and reviews) and Amazon affiliate URL generation.

### Prompt Workflows (3 templates)
- **room_coordinator**: Space dimensions → complete coordination plan (shelf + boxes + protection materials)
- **moving_checklist**: Room layout type → categorized purchasing checklist with budget estimates
- **product_showdown**: Two products → detailed comparison including accessory/running costs

## What We Do Not Do

- **No price guarantees**: Prices change on retailer sites; our data is a snapshot or estimate.
- **No order processing**: We generate affiliate URLs but do not handle transactions, payments, or shipping.
- **No personal data storage**: We collect `intent` parameters for analytics but do not intentionally store names, addresses, or payment info. See our privacy policy.
- **No interior design**: We suggest products by dimension fit and compatibility, not by aesthetic coordination or room styling.
- **No real-time Amazon data**: Amazon integration generates search URLs only; no live product data is returned.
- **No warranty/support**: Product warranty and after-sales support are handled by the respective manufacturers/retailers.

## Available Tools (15)

### search_products
Search curated catalog by keyword, dimensions (mm), price, color, category, brand. Returns `related_items_hint` linking to `get_related_items`.

### get_product_detail
Full specs by product ID including inner dimensions, consumables, and compatible storage.

### search_rakuten_products
Rakuten Ichiba API real-time search with affiliate URLs, prices, and review data.

### search_amazon_products
Amazon affiliate search link generation (URL only). SearchIndex auto-selected by category.

### coordinate_storage
Shelf + storage box set proposals: quantity per tier, total needed, total cost.

### suggest_by_space
Space dimensions (mm) → fitting products across categories. Rotation-aware.

### identify_product
Visual feature text → product candidates with confidence, specs, related items.

### compare_products
Side-by-side comparison of 2–5 products on multiple dimensions.

### find_replacement
Discontinued model → successor/alternative lookup from catalog and Rakuten. Enhanced with `compatible_alternatives` showing dimension-compatible products with fit_score.

### calc_room_layout
Rectangle packing simulation for room floor plans.

### list_categories
All 31 categories with counts, brands, and sample products.

### get_popular_products
Recommended products by category/brand with Rakuten trending.

### get_related_items
Related-item chain traversal: required accessories, protection, add-ons, compatible storage. Depth 1–2.

### get_curated_sets
Curated collections: bundles (occasion-based), room presets (scene-based), influencer picks (expert/YouTuber recommendations), hack sets (budget alternatives). Filter by type, scene, occasion, budget, or keyword.

### diagnose_ai_visibility
AI visibility audit for any URL. Checks llms.txt, robots.txt (AI crawler), JSON-LD/Schema.org, OGP, dimension format, cross-border readiness. Returns score (0-100), grade (A-F), detailed checks, and recommendations.

## Prompt Workflows (3)

### room_coordinator
**Input**: Room type, space dimensions (mm), optional budget.
**Flow**: suggest_by_space → get_related_items → coordinate_storage → complete plan.
**Output**: Shelf + boxes + protection materials with quantities and total cost.

### moving_checklist
**Input**: Floor plan type (1K, 1LDK, 2LDK, 3LDK), optional priority rooms.
**Flow**: list_categories → get_popular_products → get_related_items → categorized list.
**Output**: Room-by-room purchasing checklist with budget estimates.

### product_showdown
**Input**: Two product names, optional use case.
**Flow**: compare_products → get_related_items for both → total cost comparison.
**Output**: Comparison table with verdict and recommendation.

## Product Categories (31)

| Category | Examples |
|----------|----------|
| シェルフ・棚 | Open shelves, unit shelves |
| カラーボックス | Nitori N-Click, IKEA KALLAX |
| 収納ケース | Storage boxes, N-InBox, Daiso stacking boxes |
| 衣装ケース | Tenma Fits, clothing storage |
| スチールラック | Metal racks, Luminous |
| デスク | PC desks, standing desks, FlexiSpot E7 |
| キッチン収納 | Kitchen wagons, range racks, tower series |
| ランドリー収納 | Laundry racks, baskets, slim chests |
| バス・洗面収納 | Bath racks, tower corner racks |
| 玄関収納 | Shoe racks, shoe cabinets, umbrella stands |
| テレビ台 | TV stands, IKEA BESTÅ, media consoles |
| 本棚 | Bookshelves, rotating racks, IKEA HEMNES |
| クローゼット収納 | PAX wardrobes, SKUBB organizers |
| ファイル収納 | Muji PP file boxes, Seria Just it |
| ベビー・安全対策 | Baby gates, corner guards |
| 突っ張り棒・つっぱり | Tension rods, tension shelves |
| 保護・補修材 | Wall pads, floor mats, earthquake gel |
| パーツ・アクセサリ | Casters, extra shelves, monitor arms, hooks |
| ワゴン・可動収納 | IKEA RÅSKOG, tower wagons |
| ダイニング家具 | Dining tables, chairs, benches |
| ソファ・チェア | Sofas, office chairs, gaming chairs |
| 寝具・マットレス | Nitori N-Sleep, Tempur pillows |
| カーテン・ブラインド | Blackout curtains, roller blinds |
| 家電・照明 | Roomba, washing machines, LED lights |
| PC周辺・デスク環境 | Monitor arms, keyboards, desk mats |
| スマートホーム | Echo Dot, SwitchBot, Philips Hue |
| 美容家電 | Dyson dryers, Panasonic NanoCare, ReFa |
| 空気環境家電 | Air purifiers, humidifiers, dehumidifiers |
| キッチン家電 | Balmuda Toaster, DeLonghi, Instant Pot |
| ガジェット・モバイル | AirPods Pro, Sony WH-1000XM5, Anker |
| 健康・フィットネス | Tanita scales, Fitbit, foam rollers |

## Key Design Decisions

- All dimensions in **millimeters** (mm) — both outer and inner
- All prices in **Japanese Yen** (JPY), tax-included integers
- `intent` parameter required on every tool call (for analytics; may contain user input)
- Related items marked `required: true` should always be mentioned
- Amazon SearchIndex dynamically selected by product category

## AI Discovery Files

- [Full Tool Documentation](https://ai-furniture-hub.onrender.com/llms-full.txt): Complete schemas and example calls for all 15 tools
- [AGENTS.md](https://ai-furniture-hub.onrender.com/AGENTS.md): How AI agents should use this server
- [MCP Server Card](https://ai-furniture-hub.onrender.com/.well-known/mcp/server-card.json): Machine-readable metadata (JSON)
- [AI Agent Context](https://ai-furniture-hub.onrender.com/context.md): Structured context for AI

## Connection

- **Streamable HTTP (remote)**: `https://ai-furniture-hub.onrender.com/mcp`
- **stdio (local)**: `npx ai-furniture-hub` or `npx ts-node index.ts`
- **Smithery**: `j2c214c/ai-furniture-hub`
- **npm**: `npm install ai-furniture-hub`

## Optional

- [Rakuten Ichiba API Docs](https://webservice.rakuten.co.jp/documentation/ichiba-item-search)
- [MCP Protocol Spec](https://modelcontextprotocol.io)
- [GitHub Repository](https://github.com/ONE8943/ai-furniture-hub)