de en es ja ko ru zh

LexQ

Name: LexQ
Author: lexq-io

by lexq-io

Overview Schema Source Related Servers Discussions Admin

TypeScript

Hybrid

LexQ CLI

The Decision Operations Platform for engineering teams. CLI and MCP server for LexQ — move business rules out of your deploy pipeline, prove every change with Impact Simulation, and ship without a git push.

Website · Docs · Console · MCP Registry

npm License

Why LexQ?

Your business rules — pricing, promotions, fee logic, eligibility checks — change often. But every change ships through the same PR → review → staging → deploy cycle as your core application code. A one-line discount rule takes two weeks.

This is an architectural problem, not a process problem. Business logic that changes weekly shouldn't live in code that ships quarterly.

LexQ separates the two. Rules live outside your application. You change them in a visual console or through this CLI. You prove every change with Impact Simulation against real execution data. You deploy without touching your codebase.

Every decision leaves a full audit trace.

Related MCP server: @run-iq/mcp-server

Install

npm install -g @lexq/cli

Or run without installing:

npx @lexq/cli

Requires Node.js 22+.

Quick Start

# 1. Authenticate
lexq auth login
# Enter your API key (create one at console.lexq.io → Management → API Keys)

# 2. Verify
lexq auth whoami

# 3. Start from a domain template — provisions facts, sample rules, and a policy group
lexq domain-templates list
lexq domain-templates apply --template ECOMMERCE
# Returns: policyGroupId, policyVersionId, factsCreated, rulesCreated

# 4. Test a rule against your data before shipping
lexq analytics dry-run --version-id <VERSION_ID> --debug \
  --json '{"facts":{"loyaltyTier":"PLATINUM","purchaseSubtotalUsd":150}}'

# 5. Deploy
lexq deploy publish --group-id <GROUP_ID> --version-id <VERSION_ID> --memo "v1"
lexq deploy live --group-id <GROUP_ID> --version-id <VERSION_ID> --memo "Initial deploy"

For AI Agents — the Complete Partner API

LexQ is designed to be AI-native. The entire policy engine Partner API is exposed via Model Context Protocol. Claude, Cursor, and other MCP-compatible agents can create, simulate, and deploy rules autonomously, with human approval before production.

Claude.ai (Cloud — no install)

Settings → Connectors → Add Custom Integration
Enter: https://mcp.lexq.io
Sign in with your LexQ account and select an API key
Done — the full toolset available in every conversation

Remote (Streamable HTTP)

For any MCP client that supports remote servers:

{
  "mcpServers": {
    "lexq": {
      "url": "https://mcp.lexq.io"
    }
  }
}

OAuth 2.1 authentication is handled automatically by your client.

Local (stdio)

Run LexQ CLI as a local MCP server:

lexq serve --mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "lexq": {
      "command": "npx",
      "args": [
        "-y",
        "@lexq/cli",
        "serve",
        "--mcp"
      ]
    }
  }
}

VS Code / Cursor

.vscode/mcp.json:

{
  "servers": {
    "lexq": {
      "command": "npx",
      "args": [
        "-y",
        "@lexq/cli",
        "serve",
        "--mcp"
      ]
    }
  }
}

Prerequisite: lexq auth login must have been run once to store an API key in ~/.lexq/config.json, or LEXQ_API_KEY must be set in the client's environment block.

Registry

The server is listed on the official MCP Registry as io.lexq/lexq. Clients that browse the registry find both the npm package and the hosted endpoint in that one entry.

Protocol Support

The local stdio server and the hosted Streamable HTTP endpoint both serve two MCP revisions from one set of tool definitions, so a client sees the same tools either way.

Revision	How a client reaches it
`2026-07-28`	A per-request `_meta` envelope. No handshake.
`2025-11-25`	The `initialize` handshake.

There is nothing to configure. The server answers in whichever revision the opening message used, so a client can move to 2026-07-28 on its own schedule and one that has not moved keeps working.

AI Agent Skills

LexQ CLI ships with AI Agent Skills — structured documentation agents read to understand how to use the tools, not just what they are.

skills/
├── lexq-shared/SKILL.md       Core concepts, auth, workflow
├── lexq-groups/SKILL.md       Policy groups, conflict resolution, A/B testing
├── lexq-rules/SKILL.md        Condition syntax, action types, mutex
├── lexq-simulation/SKILL.md   Dry run, Impact Simulation, compare
├── lexq-execution/SKILL.md    History, stats, failure logs, provenance, replay, latency profile
└── lexq-recipes/SKILL.md      End-to-end recipes

.claude/CLAUDE.md              Claude Code project context
AGENTS.md                      Universal agent guide (Cursor, Windsurf, Gemini CLI, Cline)
CONTEXT.md                     Platform architecture & glossary

After installing @lexq/cli, agents can read skills from:

node_modules/@lexq/cli/skills/
node_modules/@lexq/cli/AGENTS.md
node_modules/@lexq/cli/CONTEXT.md

Commands

lexq auth                  login | logout | whoami
lexq status                API health check
lexq serve                 Run as MCP stdio server (--mcp)
lexq groups                list | get | create | update | delete | reorder
lexq groups ab-test        start | stop | adjust
lexq versions              list | get | create | update | delete | clone
lexq rules                 list | get | create | update | delete | reorder | toggle
lexq facts                 list | create | update | delete | action-metadata | unregistered
lexq domain-templates      list | preview | apply
lexq deploy                publish | live | rollback | undeploy | history | detail | overview | deployable | diff | schedule | unschedule | schedules
lexq analytics             dry-run | dry-run-compare | requirements
lexq analytics simulation  start | status | list | cancel | export
lexq analytics dataset     upload | template
lexq profile               <groupId> — per-rule latency profile
lexq history               list | get | stats
lexq replay                decision | start | list | get | cancel
lexq logs                  list | get | action | bulk-action
lexq provenance            get | reveal-audits
lexq webhook-subscriptions list | get | save | delete | test

Global Options

Flag	Description
`--format <json\|table>`	Output format (default: `json`)
`--api-key <key>`	Override stored API key
`--base-url <url>`	Override API base URL
`--dry-run`	Preview the HTTP request without executing
`--verbose`	Show request/response details
`--no-color`	Disable colored output

Configuration

Config is stored at ~/.lexq/config.json:

{
  "apiKey": "YOUR_API_KEY",
  "baseUrl": "https://api.lexq.io/api/v1/partners",
  "format": "json"
}

The file holds an API key in plain text, so it is written 0600 inside a 0700 directory — readable by its owner and nobody else on the machine. An install created by an older version is repaired on the next save.

Environment variables

These are read by the MCP server (lexq serve --mcp) and take precedence over the stored config. They let an editor or CI target an environment through the client's own config block, without writing to ~/.lexq/config.json. CLI commands use --api-key and --base-url instead.

Variable	Overrides
`LEXQ_API_KEY`	`apiKey`
`PARTNER_BASE_URL`	`baseUrl`

Development

git clone https://github.com/lexq-io/lexq-cli.git
cd lexq-cli
pnpm install
pnpm build
pnpm start -- groups list

pnpm typecheck                  # Type check
pnpm lint                       # ESLint
pnpm build                      # Bundle to dist/

Checks that guard a stated fact against the thing that owns it. All of them run in CI.

pnpm enums:check                # Generated enums match the engine contract
pnpm prose:check                # Numbers and code tables in prose match the contract
pnpm ab-key:check               # Tool descriptions still name the A/B traffic key
pnpm surface:check              # Nothing internal reached a public file
pnpm registry:check             # server.json agrees with package.json
pnpm schemas:check              # tools/list matches the recorded snapshot (needs a build)
pnpm test:fact-key              # Fact key grammar
pnpm test:decimals              # Metric precision display
pnpm test:export-format         # Export byte fidelity
pnpm protocol:check             # README matches the revisions the server serves

Security

Report a vulnerability through GitHub's private reporting form. The policy, including what is in scope, is in SECURITY.md.

License

Apache-2.0

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

Need Help?

Related Servers

Related MCP Connectors

SIGNALS Loyalty Agent Platform
global.signals
63 MCP tools for loyalty programs, rewards, and member operations with HITL approval.
CRM Marketing Autonomous Agents
2
DATPAQ
com.datpaq
34 production API tools over one hosted MCP endpoint.
Developer Tools
2
Algenta MCP Server B
io.github.thyn-ai
Governed data discovery, exact queries, decisions, simulations, and runtime utilities over MCP.
Data Platforms Search RAG Systems
1402
mcp-knowledge C
io.github.getgapup
100+ MCP tools for AI agents: content metadata, trade intelligence, business-expertise analysis.
Knowledge & Memory Research & Data RAG Systems
2792

Related MCP Servers

MCP360 Universal Gatewayofficial
RAG Systems Agent Orchestration Developer Tools
mcp360
A
license
C
quality
D
maintenance
Provides unified access to 100+ MCP tools from the marketplace plus custom MCPs through a single gateway with search and execute capabilities.
Updated 3 months ago (2026-06-17 06:57 UTC)
2
7 npm
23
MIT
@run-iq/mcp-serverofficial
Legal & Compliance Finance
Run-IQ
A
license
Not graded
quality
D
maintenance
MCP server exposing a parametric policy engine for evaluating, simulating, and managing rules, with dynamic plugin support for domain-specific calculations.
Updated 6 months ago (2026-03-19 01:09 UTC)
21 npm
1
MIT
Emin MCP Server
Developer Tools Autonomous Agents
eminogrande
A
license
Not graded
quality
B
maintenance
Provides portable working rules and tooling instructions as MCP resources, ensuring consistent agent behavior across clients.
Updated 2 months ago (2026-07-20 02:30 UTC)
MIT
SF Assistant MCP Server
Cloud Platforms Databases ERP Systems
josemachado-vp
F
license
A
quality
C
maintenance
MCP server for SAP SuccessFactors that provides 52 tools across 15 categories for querying live data, generating business rules, validating imports, running analytics, comparing instances, auditing data, and building cutover checklists.
Updated 2 months ago (2026-07-16 18:05 UTC)
52
-