How do I use CPQ-BML MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@CPQ-BML MCP Server Validate BML file src/bml/quote.bml" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

de en es ja ko ru zh

CPQ-BML MCP Server

by vikram-vn

Overview Schema Source Related Servers Discussions Admin

JavaScript

Local

CPQ-BML VS Code Extension

A high-performance, feature-rich development environment for Oracle CPQ BigMachines Language (BML). Built for CPQ developers, architects, and AI pair-programmers.

⚡ Quick Start: Key Capabilities & Documentation

For complete architectural blueprints, Control Flow Graphs (CFGs), and code examples, explore our Knowledge Base:

Feature Area	Description	Deep Dive Guide
💡 IntelliSense & Autocomplete	Workspace util library suggestions (`util.pricing.`), BMQL `$var` dynamic completion, parameter signatures, Call Hierarchy (`Shift+Alt+H`), and `F12` Go to Definition.	IntelliSense Guide
🛠 BML Beautifier & Formatter	Deterministic 4-stage formatting, brace styles (`collapse`/`expand`), minimal range diffing, on-type formatting, and `.bmlbeautifyrc`.	Beautifier Guide
🔍 Real-Time Security & Linter	Real-time squiggles and `Alt+Enter` Quick-Fixes for BMQL injection risks, queries in loops, unbounded while loops, and type validation.	Linter Guide
⚡ BML Logic Scratchpad	Offline interactive sandbox to test pure BML algorithms (math, string manipulation, dates, dict, json) and view print logs instantly.	Scratchpad
🤖 Model Context Protocol (MCP)	Seamless multi-client MCP auto-registration for Cursor, Copilot, Google Antigravity, Claude Desktop, and ChatGPT.	MCP Server Guide
☁ Safe Cloud Sync & 3-Way Diff	OAuth2/Basic Auth client, side-by-side diff review on pull conflicts, and live debug streaming to CPQ DevKit Terminal.	REST API Guide
🏗 BML & BMQL Scaffolding	Explorer context scaffolding for library functions with docHeaders and `-meta.json` sidecars, plus parameterized BMQL queries.	Scaffolding
🚦 CI/CD Security Audit	Workspace-wide BML security and quality audit via MCP `audit_bml_code` tool — detects BMQL injection risks, queries in loops, and failing quality scores.	Linter Guide
⚙ Interactive Settings Panel	Webview UI dashboard for managing environments, credentials, formatter options, MCP traffic inspection, and diagnostics.	Settings Panel Guide
🔤 Smart Spell Checker	Morphological inflection analyzer and domain dictionary designed for BML identifiers and comments.	Spell Check Guide
📄 XSLT & XML Subsystem	Document Engine XSL template formatting, XPath 1.0 autocompletion, and BML `transformxml()` integration.	XSLT Guide
📊 Code Quality & Metrics	McCabe Cyclomatic Complexity, Halstead Software Science, Maintainability Index (MI), and visual dashboard.	Metrics Guide

Related MCP server: Salesforce CLI MCP Server

⌨ Key Shortcuts & Common Commands

Action	Shortcut (Windows/Linux)	Shortcut (macOS)	Command Palette (`Ctrl/Cmd+Shift+P`)
Format Document	`Shift+Alt+F`	`Shift+Option+F`	`Format Document`
Call Hierarchy	`Shift+Alt+H`	`Shift+Option+H`	`Show Call Hierarchy`
Go to Definition	`F12`	`F12`	`Go to Definition`
Find All References	`Shift+F12`	`Shift+F12`	`Find All References`
Quick Fix / Lightbulb	`Ctrl+.`	`Cmd+.`	`Quick Fix...`
Open BML Scratchpad	-	-	`CPQ-BML: Open BML Logic Scratchpad (Offline Sandbox)`
Run BML Script Locally	-	-	`CPQ-BML: Run BML Script Locally (Scratchpad)`
Scaffold Library Function	-	-	`CPQ-BML: Scaffold New Library Function (with -meta.json sidecar)`
Scaffold BMQL Query	-	-	`CPQ-BML: Scaffold Parameterized BMQL Query`
Switch Environment	-	-	`CPQ-BML: Switch Active CPQ Environment`
Export Team Profiles	-	-	`CPQ-BML: Export Team Profiles (.cpq/profiles.json)`
Open Settings Panel	-	-	`CPQ-BML: Open Settings`
Show Code Metrics	-	-	`BML: Show Code Metrics`
Pull Function from CPQ	-	-	`CPQ: Pull Function`
Debug Function Remotely	-	-	`CPQ: Debug Function`
Deploy Function	-	-	`CPQ: Deploy Current Util Function to CPQ`

⚙ Configuration Setup

Configure your CPQ environments in .env (workspace root) or through the Settings Panel (CPQ-BML: Open Settings):

# Oracle CPQ Cloud Environment Setup (.env)
CPQ_SITE_URL=https://sitename.oracle.com
CPQ_USERNAME=api_developer
CPQ_PASSWORD=YourPasswordHere!
CPQ_AUTH_METHOD=basic
CPQ_REST_VERSION=v17
CPQ_COMMERCE_PROCESS=oraclecpqo
CPQ_COMMERCE_DOCUMENT=transaction

To customize formatting options across your project, create a .bmlbeautifyrc file:

{
  "indent_size": 4,
  "brace_style": "collapse",
  "space_before_conditional": true,
  "preserve_newlines": true,
  "max_preserve_newlines": 2,
  "uppercase_reserved_words": true
}

💻 Local Development & Contributions

# Clone the repository
git clone https://github.com/vikram-vn/cpq-bml.git
cd cpq-bml

# Install dependencies
npm install

# Compile the extension bundle
npm run compile

Press F5 in VS Code to launch the Extension Development Host.

📄 License & Disclaimer

License: Licensed under the MIT License.
Disclaimer: This extension is an independent open-source tool and is not affiliated with or endorsed by Oracle Corporation.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityActive

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

salesforce-devopsOAuth
cloud.serpent
Plan Salesforce deploys, open pull requests and trigger pipelines from your AI client.
CI/CD & DevOps Version Control CRM
2
AgentPlaybooks A
ai.agentplaybooks
Manage portable AI agent playbooks, Agent Skills, MCP configurations, personas, and memory.
Autonomous Agents Knowledge & Memory
5014
OrchaOAuth
io.github.westonhancock
Securely search and manage workspace context files for AI agents and teams.
Search File Systems Knowledge & Memory
1
Builderforce
io.github.SeanHogg
Run tickets, boards, OKRs and cloud coding agents in your Builderforce workspace
Project Management Developer Tools Agent Orchestration
15

Related MCP Servers

PartnerCore
Developer Tools Version Control File Systems
ciellosinc
A
license
Not graded
quality
Not graded
maintenance
Enables AI assistants to perform Business Central AL development tasks including language server operations, container management, Git version control, and file system operations for professional BC development workflows.
Updated 9 months ago (2025-12-27 03:05 UTC)
-
Salesforce CLI MCP Server
CRM Databases Developer Tools
perrynet
A
license
Not graded
quality
D
maintenance
Enables AI assistants to interact with Salesforce organizations through project-based CLI integration, allowing execution of Apex, SOQL queries, object descriptions, and org management using local Salesforce DX project configurations.
Updated 10 months ago (2025-11-12 10:52 UTC)
MIT
AI Developer Workspace MCP
File Systems Version Control Developer Tools
Praniti1594
F
license
Not graded
quality
C
maintenance
Enables AI agents to manage local project files and Git operations through MCP tools, including file CRUD, search, Git status, recent commits, and project summaries.
Updated a month ago (2026-08-09 14:17 UTC)
-
Coding Tools MCP
Coding Agents File Systems Command Line
R-HUA
F
license
Not graded
quality
A
maintenance
Enables AI agents to develop within a local project workspace by reading and modifying files, running commands and tests, checking Git state, and persisting progress as history sessions that can be restored in later conversations.
Updated 22 days ago (2026-08-22 07:31 UTC)
-