Back to Guides

Oxomi MCP Server — Baustoff Catalog Search for AI Agents

Search Oxomi catalogs, products, datasheets, and CAD drawings from AI agents via MCP. Pre-built Oxomi adapter in AnythingMCP for the German Baustoff trade.

Pre-built adapter available on AnythingMCP Cloud

Skip the self-hosted setup — install this adapter in one click with a free trial. No credit card required.

Install on Cloud — Free Trial

Oxomi Catalog & Media Search with AI Agents

Oxomi is the dominant catalog and media portal for the German Baustoff (building materials) trade — used by wholesalers and Handwerk businesses to access digital catalogs, product datasheets, technical drawings, safety data sheets (Sicherheitsdatenblätter), installation guides (Verarbeitungsanleitungen), and cross-selling references across hundreds of supplier brands.

By plugging Oxomi into MCP, your AI agent can resolve a vague product description ("the 80mm screw with the blue head") into the exact SKU + datasheet + supplier in seconds — perfect for sales counter staff, ordering workflows, and technical support.

Quick Setup with Built-in Adapter

AnythingMCP ships with a pre-configured Oxomi adapter. You provide three credentials at import time.

Step 1: Deploy AnythingMCP

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d

Step 2: Generate API Credentials in Oxomi

In your Oxomi portal:

  1. Go to Portal-Einstellungen → ID to find your numeric portal id
  2. Note the username (often an email) used for API access
  3. Generate an API token under Portal-Einstellungen → API

Step 3: Import the Adapter

Open http://localhost:3000/connectors/store, click Import on Oxomi, and fill in the three fields the form prompts for:

  • OXOMI_PORTAL_ID
  • OXOMI_USER
  • OXOMI_ACCESS_TOKEN

Each value is encrypted at rest.

Step 4: Connect to Your AI Agent

{
  "mcpServers": {
    "oxomi": {
      "url": "http://localhost:4000/mcp"
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | oxomi_search_catalogs | Find catalogs by supplier or keyword | | oxomi_get_catalog_pages | List pages of a catalog with thumbnails | | oxomi_get_catalog_attachments | Download links for catalog attachments | | oxomi_search_products | Product search by SKU or text — returns supplier + datasheet URLs | | oxomi_search_documents | Hunt for safety data sheets, installation guides, CAD files |

AI Agent Use Cases

  • "Find the safety data sheet for Knauf Diamant Spachtel"
  • "What's the article number for the Würth Würth ASSY plus VG screw 6×80?"
  • "List all Bosch power tool catalogs in our portal"
  • "I need installation guides for Saint-Gobain Rigips wall systems"

Tips

  • Results are scoped to your portal subscription — only suppliers your contract includes are visible.
  • Most descriptions are German; pass lang=en for English where translations exist.
  • For very large bulk extracts (thousands of catalog pages), prefer Oxomi's batch export over per-call tooling.

Next Steps