ai-furniture-hub
MCP server with 15 tools, 300+ furniture products, precise dimension search, curated sets, and AI product recommendation
MCP server providing 15 tools for furniture and home product search with millimeter-precision dimensions, 300+ curated products across 31 categories, and AI-powered product recommendations.
About ai-furniture-hub
ai-furniture-hub is a community-built MCP server published by ONE8943 that provides AI assistants with tools and capabilities via the Model Context Protocol. MCP server with 15 tools, 300+ furniture products, precise dimension search, curated sets, and AI product recommendation It is categorized under databases. This server exposes 15 tools that AI clients can invoke during conversations and coding sessions.
How to install
You can install ai-furniture-hub in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.
License
ai-furniture-hub is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.
Tools (15)
Search 300+ products by keyword, dimensions (mm), price, color, category, brand
Get full product specs including inner dimensions, consumables, compatible storage
Real-time Rakuten Ichiba search with 200K+ listings, prices and reviews
Generate Amazon affiliate search URLs with auto SearchIndex
Find products that fit specific space dimensions with rotation awareness
AI Furniture & Home Product Hub - MCP Server
15 tools | 355+ curated products | 31 categories | 90+ brands Millimeter-precision search, curated sets, AI visibility diagnosis, OpenAPI 3.1 schema. Built for ChatGPT, Claude, Gemini, Cursor, Perplexity, and any MCP-compatible AI agent.
Discovery & Install
- MCP Registry name:
io.github.ONE8943/ai-furniture-hub - Remote MCP endpoint:
https://ai-furniture-hub.onrender.com/mcp - Well-known discovery:
https://ai-furniture-hub.onrender.com/.well-known/mcp.json - npm package:
ai-furniture-hub
If your MCP client supports registry search, search for io.github.ONE8943/ai-furniture-hub or AI Furniture & Home Product Hub.
If your client supports direct remote MCP, connect it to https://ai-furniture-hub.onrender.com/mcp.
Why This Exists
AI agents need structured, machine-optimized product data to make useful recommendations. This MCP server provides:
- Exact-fit search: "Find a shelf that fits a 425mm gap" returns products with 1mm accuracy
- Complete solutions: One search returns the shelf + matching storage boxes + floor protection + cable organizers
- Curated by experts: Influencer picks, room presets, bundle deals, and budget hack alternatives
- Replacement intelligence: Discontinued product? Get successors ranked by dimension compatibility (fit_score 0-100)
- AI visibility consulting: Diagnose any website's AI discoverability with a single tool call
Quick Start
Option 1: Remote (Cursor / Claude / VS Code / ChatGPT)
Connect directly to the hosted server:
{
"mcpServers": {
"furniture-hub": {
"url": "https://ai-furniture-hub.onrender.com/mcp"
}
}
}
Works in any MCP client that accepts a remote Streamable HTTP URL.
Option 2: npx (local)
npx ai-furniture-hub
Option 3: Clone & Run
git clone https://github.com/ONE8943/ai-furniture-hub.git
cd ai-furniture-hub
npm install
cp .env.example .env # API keys optional - works with mock data
npm start # stdio mode
npm run start:http # HTTP mode at localhost:3000/mcp
Tools (15)
Search & Discovery
| Tool | What It Does |
|---|---|
search_products | Search 300+ products by keyword, dimensions (mm), price, color, category, brand |
get_product_detail | Full specs: inner dimensions, consumables, compatible storage, curations |
search_rakuten_products | Real-time Rakuten Ichiba search (200K+ listings with prices & reviews) |
search_amazon_products | Amazon affiliate search URL generation with auto SearchIndex |
suggest_by_space | "I have a 600x400mm space" -> everything that fits, rotation-aware |
identify_product | Visual description -> product candidates with model numbers |
Coordination & Comparison
| Tool | What It Does |
|---|---|
coordinate_storage | Shelf + storage box set proposals: quantity per tier, total cost |
compare_products | Side-by-side comparison (2-5 products) on price, size, load, reviews |
find_replacement | Discontinued model -> successors + dimension-compatible alternatives with fit_score |
calc_room_layout | Floor-plan rectangle packing with placement coordinates |
get_related_items | Accessory chains: required items, protection, consumables, hack substitutes (depth 1-2) |
Curation & Intelligence
| Tool | What It Does |
|---|---|
get_curated_sets | Bundles, room presets, influencer picks, hack sets. Filter by type/scene/budget |
get_popular_products | Trending products by category with Rakuten data |
list_categories | Browse 31 categories with counts, brands, samples |
diagnose_ai_visibility | AI visibility audit: llms.txt, robots.txt, JSON-LD, OGP, score 0-100 |
Prompt Workflows (3)
| Prompt | Flow |
|---|---|
room_coordinator | Space dimensions -> shelf + boxes + protection with quantities & cost |
moving_checklist | Floor plan type -> room-by-room purchasing checklist with budget |
product_showdown | Two products -> full comparison including accessories & running costs |
Product Categories (31)
| Area | Categories |
|---|---|
| Storage | Shelves, Color boxes, Storage cases, Clothing storage, Steel racks, Closet storage, File storage |
| Furniture | Desks, TV stands, Bookshelves, Dining, Sofas & chairs, Bedding |
| Room-specific | Kitchen, Laundry, Bath, Entrance, Baby safety |
| Hardware | Tension rods, Protection materials, Parts & accessories, Wagons |
| Appliances | Home appliances, Kitchen appliances, Air quality, Smart home |
| Tech & Lifestyle | PC peripherals, Beauty devices, Gadgets, Health & fitness |
| Decor | Curtains & blinds |
Key Features
Cinderella-Fit Search
All dimensions in millimeters - outer AND inner. Find products that fit a specific space with 1mm tolerance. Rotation-aware: automatically checks if swapping width/depth creates a fit.
Related-Item Chains
Every product links to 3-5 related items: required accessories (HEPA filters for air purifiers), protection materials (floor mats for heavy shelves), consumables (vacuum bags), compatible storage boxes.
Curated Sets
- Bundles: "New Life Starter Kit", "Work From Home Set"
- Room Presets: IKEA-style complete room configurations
- Influencer Picks: Real recommendations from YouTubers and magazines
- Hack Sets: Budget alternatives (100-yen substitutes for 1000-yen accessories)
Dimension-Compatible Replacement
Discontinued product? find_replacement returns:
- DB-registered successors
- Dimension-compatible alternatives with
fit_score(0-100) - Live Rakuten search results
AI Visibility Diagnosis (AIO)
diagnose_ai_visibility audits any URL:
- llms.txt presence
- robots.txt AI crawler access
- Structured data (JSON-LD, Schema.org)
- OGP tags
- Cross-border readiness (English metadata, multi-currency)
- Returns score (0-100), grade (A-F), actionable recommendations
Attribution & Analytics
Every API response includes _attribution metadata with a unique attribution_id, enabling:
- Per-call tracking for pay-per-call monetization
- Source detection (Apify, RapidAPI, direct)
- Contribution logging for revenue attribution
API & Integration
OpenAPI 3.1 Schema
Full OpenAPI spec available at /openapi.yaml for RapidAPI and marketplace integration.
AI Discovery Endpoints
| File | URL | Purpose |
|---|---|---|
| llms.txt | /llms.txt | AI agent overview |
| llms-full.txt | /llms-full.txt | Full tool schemas & examples |
| OpenAPI | /openapi.yaml | REST API specification |
| Server Card | /.well-known/mcp/server-card.json | Machine-readable metadata |
| context.md | /context.md | Structured AI context |
| robots.txt | /robots.txt | AI crawler permissions |
MCP Resources
furniture-hub://llms.txt
furniture-hub://llms-full.txt
Architecture
AI Agent (ChatGPT, Claude, Gemini, Cursor, Perplexity, ...)
| MCP (stdio or Streamable HTTP)
v
+-----------------------------------------------------------+
| 15 Tools + 3 Prompts |
+-----------------------------------------------------------+
| 355+ Products | 31 Categories | 90+ Brands |
| Curated Sets: bundles, room presets, influencer picks |
| Compatibility DB: dimension-based fit scoring |
| Attribution: per-request tracking with attribution_id |
+-----------------------------------------------------------+
| Adapters: Rakuten API / Amazon URL / Nitori |
| Affiliate Engine + Gap Detector + Analytics |
+-----------------------------------------------------------+
|
v
/llms.txt /llms-full.txt /openapi.yaml
/context.md /.well-known/mcp/ /robots.txt
Environment Variables
| Variable | Required | Description |
|---|---|---|
DEPLOYMENT_MODE | No | private (default, affiliate ON) or public (affiliate OFF for marketplace) |
MCP_API_KEYS_FREE | No | Comma-separated free-tier API keys for higher rate limits + curated inner dimensions |
MCP_API_KEYS_PRO | No | Comma-separated pro-tier API keys for unlimited access |
INNER_DIMENSIONS_DATA | Render only | Hidden curated inner-dimension DB injected at build time |
AFFILIATE_ID_AMAZON | No | Amazon Associate tag |
AFFILIATE_ID_RAKUTEN | No | Rakuten Affiliate ID |
RAKUTEN_APP_ID | No | Rakuten API Application ID |
RAKUTEN_API_MOCK | No | true (default) for mock data, false for live |
All environment variables are optional. The server works out of the box with mock data.
Deployment
| Platform | URL |
|---|---|
| MCP Registry | io.github.ONE8943/ai-furniture-hub |
| Render | https://ai-furniture-hub.onrender.com/mcp |
| npm | npx ai-furniture-hub |
Testing
npm run test:ci # Vitest
npm run test:all # Full legacy suite
Contributing
Issues and PRs welcome. See GitHub Issues.
License
MIT
README truncated. View full README on GitHub.
Alternatives
Related Skills
Browse all skillsConduct comprehensive, systematic literature reviews using multiple academic databases (PubMed, arXiv, bioRxiv, Semantic Scholar, etc.). This skill should be used when conducting systematic literature reviews, meta-analyses, research synthesis, or comprehensive literature searches across biomedical, scientific, and technical domains. Creates professionally formatted markdown documents and PDFs with verified citations in multiple citation styles (APA, Nature, Vancouver, etc.).
Comprehensive guide for PostgreSQL psql - the interactive terminal client for PostgreSQL. Use when connecting to PostgreSQL databases, executing queries, managing databases/tables, configuring connection options, formatting output, writing scripts, managing transactions, and using advanced psql features for database administration and development.
Notion workspace integration. Use when user wants to read/write Notion pages, search databases, create tasks, or sync content with Notion.
This skill should be used when the user requests to generate, create, or add Row-Level Security (RLS) policies for Supabase databases in multi-tenant or role-based applications. It generates comprehensive RLS policies using auth.uid(), auth.jwt() claims, and role-based access patterns. Trigger terms include RLS, row level security, supabase security, generate policies, auth policies, multi-tenant security, role-based access, database security policies, supabase permissions, tenant isolation.
Transforms conversations and discussions into structured documentation pages in Notion. Captures insights, decisions, and knowledge from chat context, formats appropriately, and saves to wikis or databases with proper organization and linking for easy discovery.
Autonomous biomedical AI agent framework for executing complex research tasks across genomics, drug discovery, molecular biology, and clinical analysis. Use this skill when conducting multi-step biomedical research including CRISPR screening design, single-cell RNA-seq analysis, ADMET prediction, GWAS interpretation, rare disease diagnosis, or lab protocol optimization. Leverages LLM reasoning with code execution and integrated biomedical databases.