BezelIQ MCP Registry

What is this?

BezelIQ exposes capabilities as Model Context Protocol (MCP) servers so that AI assistants (Claude, Cursor, Windsurf, OpenAI Agents, etc.) can call BezelIQ tools directly from within a conversation.

This page lists all available MCP endpoints, what each one does, and how to configure your AI client to use them.

Available MCPs

v0.1.0 Streamable HTTP No auth required

Oro Docs MCP

Search BezelIQ Oro Commerce documentation and selected application source. Ideal for developers building on or integrating with Oro Commerce.

POST https://mcp.bezeliq.ai/oro Tools

search_oro — ranked BM25 search over Oro docs and source; supports keyword/semantic/hybrid modes, corpus filter (docs|source|all), section filter
query_docs_filesystem_oro — safe read-only filesystem queries (rg, grep, find, ls, cat, head, tail, …) root-confined to Oro corpora
get_mcp_card — returns structured MCP cards for this registry and for the Oro capability

Transport

Streamable HTTP (stateless). Each POST to /oro is a complete MCP request/response. No persistent session required.

Auth

None required for public endpoints.

MCP Cards

/cards — all available cards
/cards/oro — Oro capability card

Client Configuration

Claude Desktop / claude_desktop_config.json

{
  "mcpServers": {
    "oro-docs": {
      "transport": "streamable-http",
      "url": "https://mcp.bezeliq.ai/oro"
    }
  }
}

Cursor / .cursor/mcp.json

{
  "mcpServers": {
    "oro-docs": {
      "url": "https://mcp.bezeliq.ai/oro",
      "transport": "http"
    }
  }
}

Windsurf / mcp_config.json

{
  "mcpServers": {
    "oro-docs": {
      "serverUrl": "https://mcp.bezeliq.ai/oro",
      "transport": "streamableHttp"
    }
  }
}

Example Tool Calls

search_oro

// Keyword search — docs + source
{ "tool": "search_oro", "arguments": { "query": "WorkflowBundle transition", "limit": 5 } }

// Docs only
{ "tool": "search_oro", "arguments": { "query": "storefront theme configuration", "corpus": "docs" } }

// Source only
{ "tool": "search_oro", "arguments": { "query": "MessageQueueBundle consumer", "corpus": "source" } }

// Semantic (degrades to keyword if OPENAI_API_KEY not set)
{ "tool": "search_oro", "arguments": { "query": "entity config", "mode": "semantic" } }

query_docs_filesystem_oro

// Find all files mentioning workflows
{ "tool": "query_docs_filesystem_oro", "arguments": { "command": "grep -rl WorkflowBundle DOCS_ROOT" } }

// List documentation sections
{ "tool": "query_docs_filesystem_oro", "arguments": { "command": "ls DOCS_ROOT" } }

// Read a specific doc
{ "tool": "query_docs_filesystem_oro", "arguments": { "command": "cat DOCS_ROOT/workflow/index.rst" } }

All Endpoints

Path	Method	Description
/	GET	This catalog page
/oro	POST	Oro Docs MCP endpoint (MCP protocol)
/oro	GET	Human-readable Oro endpoint docs
/cards	GET	JSON list of all MCP cards
/cards/oro	GET	Oro Docs MCP card (JSON)
/health	GET	Health check