Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot

cli-mcp — Claude Code skill: what it does, how to install

Inspects MCP server status, triggers tools, manages scopes, and controls transports through the omniroute command-line interface.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add cheaper-inference/OmniRoute --skill cli-mcp -a claude-code
Open on GitHub

What cli-mcp does

The skill provides agent workflows for interacting with an MCP server via omniroute. It covers checking server health with omniroute mcp status, restarting the daemon, and enabling or disabling transports.

Tool execution runs through omniroute mcp call <tool> [argsJson]. This subcommand accepts parameters inline, loads them from a file via --args-file, handles --stream, and restricts execution using --scope. Permissions and scopes are inspected via omniroute mcp scopes.

This skill relies entirely on the omniroute CLI being available on your system via npm or npx. Running commands will fail if omniroute is not installed beforehand.

What it helps with

  • check MCP server status in the terminal
  • invoke MCP tools with JSON arguments or files
  • restart the running MCP server instance
  • inspect tool scopes and access levels

Example prompts for the agent

  • Check the MCP server status with JSON output
  • Call the search tool passing arguments from args.json with streaming enabled
  • Restart the MCP server using omniroute

How to install cli-mcp

1Skills CLI (Vercel)

npx skills add cheaper-inference/OmniRoute --skill cli-mcp -a claude-code

2Manually: put the files in place

~/.claude/skills/cli-mcp/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/cli-mcp/

From the same set34

The whole set →
cli-setup cheaper-inference Helps the agent configure OmniRoute, manage autostart, apply CLI updates, and adjust session environment variables. Claude Code CX Codex Cursor +1 1,200installs omni-combos-routing cheaper-inference This skill creates and manages model routing combos with fallback chains, tests, and metrics. Use it when OmniRoute needs configurable provider routing. Claude Code CX Codex Cursor +1 1,200installs omni-inference cheaper-inference Connects OpenAI-compatible inference endpoints for chat, embeddings, audio, and images. Useful for AI agents calling OmniRoute endpoints. Claude Code CX Codex Cursor +1 1,100installs cli-providers cheaper-inference Manage OmniRoute provider connections from the CLI: inspect the catalog, test connections, rotate keys, and view metrics. Useful when provider setup is part of your terminal workflow. Claude Code CX Codex Cursor +1 1,100installs omni-auth cheaper-inference Manage API keys and sessions in OmniRoute. Authenticates requests via Bearer tokens, handles dashboard login with password or OIDC, and controls session access. Claude Code CX Codex Cursor +1 1,100installs cli-routing cheaper-inference Manage model routing combos from the command line with omniroute. Test routing strategies, inspect metrics, and configure fallback chains interactively. Claude Code CX Codex Cursor +1 1,100installs omni-mcp cheaper-inference Connects an agent to the OmniRoute MCP server for request routing, memory, cache, and audit work. Use it when those operations need to be available as MCP tools. Claude Code CX Codex Cursor +1 1,100installs omni-providers cheaper-inference Manages connections to 375 AI providers via REST API: adds keys, tests connections, syncs models. Claude Code CX Codex Cursor +1 1,100installs

Similar

apple-notes Hermes Agent Lets a coding agent read, search and write Apple Notes from the terminal through the memo CLI, with everything syncing over iCloud. Claude Code CX Codex Cursor +1 381installs gif-search Hermes Agent Searches and downloads GIFs directly through the Tenor API using curl and jq. Useful when your agent needs reaction media or quick links for chat. Claude Code CX Codex Cursor +1 379installs superdesign superdesigndev Create and refine interfaces, presentations, and graphics on the Superdesign canvas. Useful for drafting new layouts or comparing results from different models. Claude Code CX Codex Cursor +1 11,200installs prompt-engineer https://github.com/Jeffallan A skill that writes, refactors and tests LLM prompts: templates, JSON schemas, scoring rubrics, test suites. Useful when model output is inconsistent and you need to know why. Claude Code CX Codex Cursor +1 5,600installs setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. Claude Code 1,052,851installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. Claude Code 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. Claude Code CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. Claude Code CX Codex Cursor +1 410,700installs

Questions about cli-mcp

How to install cli-mcp in Claude Code?

Run npx skills add cheaper-inference/OmniRoute --skill cli-mcp -a claude-code in your terminal.

What does cli-mcp do?

It teaches your agent how to inspect MCP server status, restart the daemon, configure transports, and invoke registered tools using the omniroute CLI.

What are the prerequisites for cli-mcp?

You need the omniroute package installed globally with npm install -g omniroute or executable via npx omniroute.

Source text

SKILL.md · MIT
---
name: cli-mcp
description: Inspect the MCP server status, list registered tools and scopes, run tool invocations, and manage MCP audit logs from the CLI.
---
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

## Overview

Inspect the MCP server status, list registered tools and scopes, run tool invocations, and manage MCP audit logs from the CLI.

## Quick install

```bash
npm install -g omniroute   # or: npx omniroute
omniroute --version
```

## Subcommands

### `mcp`

**Example:**

```bash
omniroute mcp
```

### `mcp status`

Show MCP server status

**Flags:**

- `--json`

**Example:**

```bash
omniroute mcp status
```

### `mcp restart`

Restart the MCP server

**Example:**

```bash
omniroute mcp restart
```

### `mcp enable`

**Flags:**

- `--transport <transport>`

**Example:**

```bash
omniroute mcp enable
```

### `mcp disable`

**Example:**

```bash
omniroute mcp disable
```

### `mcp call <tool> [argsJson]`

**Flags:**

- `--args <json>`
- `--args-file <path>`
- `--stream`
- `--scope <s>`

**Example:**

```bash
omniroute mcp call <tool> [argsJson]
```

### `mcp scopes`

**Flags:**

- `--tool <name>`

**Example:**

```bash
omniroute mcp scopes
```

© cheaper-inference · MIT · cheaper-inference/OmniRoute

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor