Octri

mcp score

Scores what agents are served, out of 10: the weakest tools first, problems with the server as a whole, and the rules costing the most points. You accept the suggested fixes in MCP Studio, and they reach agents with the next publish. See tool quality.

bash
octri mcp score [--tool <name>] [--all] [--fail-under <score>]

Flags

--tool <name>string

Prints one tool's findings, each with its key and suggested rewrites.

--allboolean

Lists every tool, not only the weakest 15.

--fail-under <score>number

Exits with an error below this score, such as 7, so a CI job fails when quality drops.

octri mcp score ignore <key>

Dismisses a finding that doesn't apply to your API. Only the score moves: what agents are served stays the same, so there's nothing to publish.

Arguments

<key>stringrequired

The finding's key, from --tool.

octri mcp score restore <key>

Brings a dismissed finding back.

Arguments

<key>stringrequired

The finding's key.

Examples

Score the server

bash
octri mcp score
Output
✔ Scoring MCP tools

MCP tool quality 7.5 / 10 A
  definitions    6.6
  coherence      9.7
  listing        every tool
  tokens listed  about 3,123
  last publish   7.5 (was 7.5)
  TOOL                GRADE  SCORE  TOP FINDING
  ──────────────────  ─────  ─────  ────────────────────────────────────────────────────────────
  createCustomer      C        5.2  The description only repeats the name.
  createProduct       C        5.2  The description only repeats the name.
  replaceProduct      C        5.2  The description only repeats the name.
  cancelSubscription  C        5.6  The description only repeats the name.
  listInvoices        B        6.0  The description only repeats the name.
  listProducts        B        6.1  The description only repeats the name.
  …

One tool's findings

bash
octri mcp score --tool createCustomer
Output
✔ Scoring MCP tools

createCustomer 5.2 / 10 C
  tokens  about 206 per turn

  high  The description only repeats the name.
    key post-customers|description-restates-name
    description, read first: Create a customer. Use this when the user asks to add a new customer.

  high  5 of 5 inputs have no description: body.name, body.email, body.currency, body.address, body.metadata.
    key post-customers|parameters-described
    input body.name, read first: The customer's name.
    input body.email: Email address.
    input body.currency, read first: The customer's currency.
    input body.address, read first: The customer's address.
    input body.metadata, read first: The customer's metadata.
  Accept fixes in MCP Studio; Publish ships them to agents. octri mcp score ignore <key> dismisses one.