Ivory River Compute MCP
An official MCP server for Ivory River Compute that allows AI agents to search the PC component catalog, retrieve product details, browse BYOPC build tiers, configure custom systems with compatibility checks, generate quotes, and hand off users to the Aivy assistant for checkout.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://mcp.ivoryriver.store/sseWhat you can do with it
- Search for PC components and pre-built systems using semantic or keyword queries
- Configure custom gaming PCs by selecting tiers and components with compatibility checks
- Retrieve detailed product specifications and pricing information
- Generate quotes for custom builds and hand off users to the in-browser checkout
Source and maintenance
Protocol and capabilities
- Server
- ir-mcp-server 0.1.0
- MCP protocol
- 2025-06-18
- Tools
- 8 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {}
}Tools
8 advertised
search_products
Search the Ivory River catalog with semantic + keyword hybrid ranking. Use for natural-language queries like "rtx 5090 laptop under $3000" or "case for AM5 build with tempered glass".
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1
},
"query": {
"type": "string",
"description": "Free-text search query."
},
"in_stock": {
"type": "boolean",
"default": true,
"description": "Whether to exclude out-of-stock items. Default true."
}
}
}get_product
Get full detail for a single product by ID. Includes price, stock, attributes, and (for BYOPC builds) a configurator summary.
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"description": "WooCommerce product ID."
},
"fields": {
"type": "string",
"description": "Optional comma-separated field projection."
}
}
}list_builds
List the four BYOPC tiers (Squire, Knight, DragonSlayer, Archangel) with their base prices and aggregate component summaries. Use this to overview what custom-build options exist before drilling into a specific tier.
{
"type": "object",
"properties": {}
}list_build_options
Pull the full configurator schema for a single BYOPC tier: every field (Processor, Motherboard, GPU, RAM, Storage, etc.) with all child product options including price, stock, and IDs. Use this to see what selections are available before quoting.
{
"type": "object",
"required": [
"tier_id"
],
"properties": {
"tier_id": {
"type": "integer",
"description": "BYOPC tier product ID. 378 Squire, 459 Knight, 371 DragonSlayer, 460 Archangel."
}
}
}quote_build
Itemize a configured BYOPC build: returns line totals + grand total + pairwise compatibility check. Empty selections are valid -- the server auto-fills the cheapest in-stock option for any required field.
{
"type": "object",
"required": [
"tier_id"
],
"properties": {
"tier_id": {
"type": "integer"
},
"selections": {
"type": "object",
"description": "Object mapping field_id (string) → child_product_id (integer). E.g. {\"123\": 456, \"789\": 101}.",
"additionalProperties": {
"type": "integer"
}
}
}
}check_compatibility
Pairwise socket / DDR / form-factor compatibility check between two products. Returns { compatible, reason }. Use before recommending a CPU + motherboard pairing or RAM + motherboard.
{
"type": "object",
"required": [
"product_id_1",
"product_id_2"
],
"properties": {
"product_id_1": {
"type": "integer"
},
"product_id_2": {
"type": "integer"
}
}
}recommend_build
Recommend BYOPC desktop tiers, optionally filtered by budget. `use_case` is informational (echoed in metadata) and helps the agent reason; the result is sorted by total ascending. For laptop recommendations, call search_products with category="laptops" instead.
{
"type": "object",
"properties": {
"budget": {
"type": "number",
"description": "USD ceiling. Builds with total > budget are dropped."
},
"use_case": {
"type": "string",
"description": "Free-form e.g. \"competitive FPS gaming\", \"video editing\"."
}
}
}get_aivy_handoff_link
Build the URL the agent hands to the user to finalize a recommendation. Lands the user on ivoryriver.store with the chat widget auto-opened, the agent's recommendation pre-staged, and quick-reply chips: [Yes, add to cart] [Show me the breakdown] [Modify components]. Use this AFTER you've recommended a build (via recommend_build / list_build_options / quote_build) and the user wants to proceed. The user always finishes the purchase in the browser; you never check out.
{
"type": "object",
"required": [
"recommendation"
],
"properties": {
"context": {
"type": "string",
"description": "Optional one-line summary of what the user originally asked (e.g. \"streaming + 4K editing under $2K\"). Shown to the chat backend so Aivy understands the original ask."
},
"agent_name": {
"type": "string",
"description": "How the agent should be named in the handoff greeting (e.g. \"Claude Desktop\", \"Cursor\", \"your AI assistant\"). Cosmetic; defaults to \"your AI assistant\"."
},
"recommendation": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"byopc",
"product",
"generic"
],
"type": "string",
"description": "byopc = a BYOPC tier with selections; product = a specific WooCommerce product (laptop, GPU, etc.); generic = no specific product, conversation context only."
},
"tier_id": {
"type": "integer",
"description": "BYOPC tier product ID (kind=byopc)."
},
"tier_name": {
"type": "string",
"description": "Human-readable tier name shown in the chat (kind=byopc)."
},
"product_id": {
"type": "integer",
"description": "WooCommerce product ID (kind=product)."
},
"selections": {
"type": "object",
"description": "field_id → child_product_id (kind=byopc).",
"additionalProperties": {
"type": "integer"
}
},
"product_name": {
"type": "string",
"description": "Human-readable product name shown in the chat (kind=product)."
},
"quoted_total": {
"type": "number",
"description": "USD total quoted to the user. Cosmetic in the greeting; the server re-quotes when the user confirms."
}
},
"description": "The recommendation to hand off."
}
}
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1169 ms
- 95th percentile latency
- 1169 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1169 ms · metadata changed · 8 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport sse ivory-river-compute-mcp https://mcp.ivoryriver.store/sseCline
{
"mcpServers": {
"ivory-river-compute-mcp": {
"type": "sse",
"url": "https://mcp.ivoryriver.store/sse",
"disabled": false
}
}
}Gemini CLI
gemini mcp add --transport sse ivory-river-compute-mcp https://mcp.ivoryriver.store/sseLet your agent find its tools
Find servers like Ivory River Compute MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other commerce servers
Do you run Ivory River Compute MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.