mcpField
O
omni-settings

omni-settings

github.com/cheaper-inferenceCloud & DevOps82.3k1.1k installsUpdated today
Repository

About omni-settings

omni-settings provides authenticated API endpoints for reading and changing OmniRoute's global application settings. It covers configuration areas from prompts and reasoning budgets to proxies, databases, and feature flags.

Key features

  1. 01Read and update global settings
  2. 02Configure system prompts and reasoning budgets
  3. 03Manage proxy and IP-filter settings
  4. 04Inspect and configure database options
  5. 05Export and import settings

Use cases

  1. 01Adjust application settings through the API
  2. 02Configure reasoning request rewriting
  3. 03Manage proxy and access-filter configuration
  4. 04Transfer settings between configurations

MCP support

The README describes API settings for MCP accessibility and compression, but does not specify an MCP server or client interface.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/cheaper-inference/omniroute --skill omni-settings

After installing, type/omni-settingsin Claude Code to confirm it loaded.

Bundled filesreferences/endpoints.md

Details

From the project README

Overview

Read and update global application settings: system prompts, thinking budget, IP filters, payload rules, combo defaults, and require-login configuration.

Authentication

All requests require a valid Bearer token or session cookie. Obtain a token via POST /api/auth/login or configure REQUIRE_API_KEY=false for local development.

Endpoints

Payloads

See the full OpenAPI specification at GET /api/openapi/spec or docs/openapi.yaml for detailed request/response schemas.

GET /api/settings/thinking-budget — behavior

Returns proxy-level thinking/reasoning request rewrite settings:

FieldMeaning
modepassthrough (leave client reasoning alone — required for Codex visible thinking), auto (strips all client thinking fields), custom, adaptive
customBudgetFixed budget when mode=custom
effortLevelBase effort when mode=adaptive

Not compression and not "decrypt encrypted reasoning". Full guide: docs/guides/THINKING_BUDGET.md.

Example — keep client-controlled reasoning (Codex/Desktop):

curl -X PUT https://localhost:20128/api/settings/thinking-budget \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"passthrough","customBudget":10240,"effortLevel":"medium"}'

Warning: mode=auto deletes reasoning / reasoning_effort / Claude thinking from the outbound body before upstream. That can empty thinking panels even when the client requested Ultra + summary.

Comments

Markdown supported