SigRank — AI Operator Benchmarking

Calculate SigRank cascade metrics from four non-negative token counts without submitting data. Returns Yield, Leverage, Velocity, SNR, and 10xDEV. No data is persisted.

{
  "type": "object",
  "properties": {
    "input": {
      "type": "number",
      "minimum": 0,
      "description": "Total input tokens consumed in the session."
    },
    "output": {
      "type": "number",
      "minimum": 0,
      "description": "Total output tokens generated."
    },
    "cache_read": {
      "type": "number",
      "minimum": 0,
      "description": "Tokens read from prompt cache (reused context)."
    },
    "cache_write": {
      "type": "number",
      "minimum": 0,
      "description": "Tokens written to prompt cache (new context stored for reuse)."
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "input",
    "output",
    "cache_read",
    "cache_write",
    "context"
  ]
}

{
  "type": "object",
  "properties": {
    "input": {
      "type": "number",
      "description": "Echoed input token count."
    },
    "output": {
      "type": "number",
      "description": "Echoed output token count."
    },
    "cache_read": {
      "type": "number",
      "description": "Echoed cache-read token count."
    },
    "cache_write": {
      "type": "number",
      "description": "Echoed cache-write token count."
    },
    "yield_": {
      "type": [
        "number",
        "null"
      ],
      "description": "Yield (Υ) = (cache_read × output) / input². Headline cascade efficiency. Null when input is zero."
    },
    "leverage": {
      "type": [
        "number",
        "null"
      ],
      "description": "Leverage = cache_read / input. Reusable context amplification. Null when input is zero."
    },
    "velocity": {
      "type": [
        "number",
        "null"
      ],
      "description": "Velocity = output / input. Output per unit of input. Null when input is zero."
    },
    "snr": {
      "type": [
        "number",
        "null"
      ],
      "description": "Signal-to-noise ratio = output / (input + output). Null when input is zero."
    },
    "dev10x": {
      "type": [
        "number",
        "null"
      ],
      "description": "log₁₀(Leverage). Logarithmic context amplification."
    },
    "non_compounding": {
      "type": "boolean",
      "description": "True if cache_write is zero (no compounding context)."
    }
  }
}

Build a SigRank Standard v0.1-draft portable operator record from available token telemetry. Input and output are required; unavailable cache telemetry remains null. Computes only the five-metric portable core through @sigrank/cascade and does not submit or persist data.

{
  "type": "object",
  "properties": {
    "input": {
      "type": "integer",
      "minimum": 0,
      "description": "Fresh input tokens."
    },
    "output": {
      "type": "integer",
      "minimum": 0,
      "description": "Output tokens."
    },
    "cache_write": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 0,
      "description": "Cache-write / cache-creation tokens, or null when unavailable."
    },
    "cache_read": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 0,
      "description": "Cache-read tokens, or null when unavailable."
    },
    "provider": {
      "type": "string",
      "minLength": 1,
      "description": "Optional provider identifier."
    },
    "model": {
      "type": "string",
      "minLength": 1,
      "description": "Optional model identifier."
    },
    "tool": {
      "type": "string",
      "minLength": 1,
      "description": "Optional tool/client identifier."
    },
    "timestamp": {
      "type": "string",
      "format": "date-time",
      "description": "Optional ISO-8601 timestamp. Defaults to the current time."
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "input",
    "output",
    "context"
  ]
}

{
  "type": "object",
  "properties": {
    "spec": {
      "const": "sigrank/0.1-draft"
    },
    "timestamp": {
      "type": "string",
      "format": "date-time"
    },
    "source": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "provider",
        "model",
        "tool"
      ],
      "properties": {
        "provider": {
          "type": "string"
        },
        "model": {
          "type": "string"
        },
        "tool": {
          "type": "string"
        }
      }
    },
    "telemetry": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "input",
        "output",
        "cache_write",
        "cache_read"
      ],
      "properties": {
        "input": {
          "type": "integer",
          "minimum": 0
        },
        "output": {
          "type": "integer",
          "minimum": 0
        },
        "cache_write": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0
        },
        "cache_read": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0
        }
      }
    },
    "metrics": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "yield",
        "leverage",
        "velocity",
        "snr",
        "dev10x"
      ],
      "properties": {
        "yield": {
          "type": [
            "number",
            "null"
          ]
        },
        "leverage": {
          "type": [
            "number",
            "null"
          ]
        },
        "velocity": {
          "type": [
            "number",
            "null"
          ]
        },
        "snr": {
          "type": [
            "number",
            "null"
          ]
        },
        "dev10x": {
          "type": [
            "number",
            "null"
          ]
        }
      }
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "spec",
    "timestamp",
    "source",
    "telemetry",
    "metrics",
    "warnings"
  ],
  "additionalProperties": false
}

Read the current public SigRank operator leaderboard. Returns ranked operators with Yield, Leverage, class tier, and display name.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 25,
      "description": "Maximum number of operators to return (1–100, default 25)."
    },
    "window": {
      "type": "string",
      "enum": [
        "7d",
        "30d",
        "90d",
        "all_time"
      ],
      "default": "30d",
      "description": "Time window for the leaderboard: 7d, 30d, 90d, or all_time."
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "context"
  ]
}

{
  "type": "object",
  "properties": {
    "window": {
      "type": "string",
      "description": "The time window used for the query."
    },
    "total_operators": {
      "type": "integer",
      "description": "Number of operators returned."
    },
    "entries": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "rank": {
            "type": "integer",
            "description": "Global rank position."
          },
          "codename": {
            "type": "string",
            "description": "Operator's unique codename (URL key, not display name)."
          },
          "display_name": {
            "type": "string",
            "description": "Human-readable operator display name."
          },
          "class_tier": {
            "type": "string",
            "description": "Operator class tier."
          },
          "yield_": {
            "type": [
              "number",
              "null"
            ],
            "description": "Yield (Υ) if compounding, else null."
          },
          "leverage": {
            "type": [
              "number",
              "null"
            ],
            "description": "Leverage if compounding, else null."
          }
        }
      }
    }
  }
}

Read one public operator profile by codename. Returns class tier, rank, percentile, Yield, Leverage, Velocity, and SNR.

{
  "type": "object",
  "properties": {
    "codename": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "The operator's unique codename (e.g. signal-ae3b5c3c55). Not the display name."
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "codename",
    "context"
  ]
}

{
  "type": "object",
  "properties": {
    "codename": {
      "type": "string",
      "description": "Operator's unique codename."
    },
    "display_name": {
      "type": "string",
      "description": "Human-readable display name."
    },
    "class_tier": {
      "type": "string",
      "description": "Operator class tier."
    },
    "rank": {
      "type": "integer",
      "description": "Global rank position."
    },
    "percentile": {
      "type": "number",
      "description": "Percentile in the public field."
    },
    "yield_": {
      "type": [
        "number",
        "null"
      ],
      "description": "Yield (Υ) if compounding, else null."
    },
    "leverage": {
      "type": [
        "number",
        "null"
      ],
      "description": "Leverage if compounding, else null."
    },
    "velocity": {
      "type": [
        "number",
        "null"
      ],
      "description": "Velocity = output / input."
    },
    "snr": {
      "type": [
        "number",
        "null"
      ],
      "description": "Signal-to-noise ratio."
    }
  }
}

Prescriptive 'what if' tool — takes your current 4 token pillars and proposed changes, runs the cascade on both, returns the exact Υ Yield delta, class change, and per-metric diffs. Test proposed pillar changes and see the payoff before changing your workflow. Changes can be absolute numbers (replace) or strings starting with +/- for relative deltas.

{
  "type": "object",
  "properties": {
    "input": {
      "type": "number",
      "minimum": 0,
      "description": "Current input tokens."
    },
    "output": {
      "type": "number",
      "minimum": 0,
      "description": "Current output tokens."
    },
    "cache_read": {
      "type": "number",
      "minimum": 0,
      "description": "Current cache-read tokens."
    },
    "cache_write": {
      "type": "number",
      "minimum": 0,
      "description": "Current cache-write tokens."
    },
    "changes": {
      "type": "object",
      "description": "Proposed changes. Keys: input, output, cache_read, cache_write. Values are absolute numbers (replace) or strings starting with +/- for relative deltas. Omitted pillars are unchanged.",
      "properties": {
        "input": {
          "type": [
            "number",
            "string"
          ],
          "description": "New input (absolute) or '+/-N' (relative)"
        },
        "output": {
          "type": [
            "number",
            "string"
          ],
          "description": "New output (absolute) or '+/-N' (relative)"
        },
        "cache_read": {
          "type": [
            "number",
            "string"
          ],
          "description": "New cache_read (absolute) or '+/-N' (relative)"
        },
        "cache_write": {
          "type": [
            "number",
            "string"
          ],
          "description": "New cache_write (absolute) or '+/-N' (relative)"
        }
      }
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "input",
    "output",
    "cache_read",
    "cache_write",
    "changes",
    "context"
  ]
}

Analyzes your token cascade and diagnoses where you're leaking efficiency. Takes 4 token pillars and produces a ranked list of efficiency leaks with severity (critical/warning/info), findings, recommendations, and estimated Υ impact. Checks: cache leverage, velocity, SNR, cache creation ratio, input bloat, and 10xDEV compounding. Use this before simulate_change to understand what's wrong.

{
  "type": "object",
  "properties": {
    "input": {
      "type": "number",
      "minimum": 0,
      "description": "Total input tokens."
    },
    "output": {
      "type": "number",
      "minimum": 0,
      "description": "Total output tokens."
    },
    "cache_read": {
      "type": "number",
      "minimum": 0,
      "description": "Cache-read tokens."
    },
    "cache_write": {
      "type": "number",
      "minimum": 0,
      "description": "Cache-write tokens."
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "input",
    "output",
    "cache_read",
    "cache_write",
    "context"
  ]
}

Generates ranked, simulated improvement suggestions for your token cascade. Takes 4 token pillars, tests multiple strategies (increase cache reads, reduce input, increase output, optimize cache creation), simulates each, and returns them ranked by Υ yield impact. Each suggestion includes the action, pillar to change, projected Υ, yield delta, projected class, and rationale. Returns the single highest-impact change as best_single_change.

{
  "type": "object",
  "properties": {
    "input": {
      "type": "number",
      "minimum": 0,
      "description": "Total input tokens."
    },
    "output": {
      "type": "number",
      "minimum": 0,
      "description": "Total output tokens."
    },
    "cache_read": {
      "type": "number",
      "minimum": 0,
      "description": "Cache-read tokens."
    },
    "cache_write": {
      "type": "number",
      "minimum": 0,
      "description": "Cache-write tokens."
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "input",
    "output",
    "cache_read",
    "cache_write",
    "context"
  ]
}

Runs the full self-improvement cycle in one call: (1) computes your current cascade from 4 token pillars, (2) diagnoses efficiency leaks, (3) generates ranked improvement suggestions, (4) simulates the top suggestion, and (5) returns the complete cycle: diagnosis + suggestions + simulated impact of the best change. The 'one-click optimize' tool — call it at the end of a session to see what to improve next time.

{
  "type": "object",
  "properties": {
    "input": {
      "type": "number",
      "minimum": 0,
      "description": "Total input tokens."
    },
    "output": {
      "type": "number",
      "minimum": 0,
      "description": "Total output tokens."
    },
    "cache_read": {
      "type": "number",
      "minimum": 0,
      "description": "Cache-read tokens."
    },
    "cache_write": {
      "type": "number",
      "minimum": 0,
      "description": "Cache-write tokens."
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "input",
    "output",
    "cache_read",
    "cache_write",
    "context"
  ]
}

Score up to 4 time windows (7d, 30d, 90d, all-time) in one call. Each window is scored independently with the full cascade (Υ, SNR, Leverage, Velocity, 10xDEV, class). Omit windows you don't have — partial input is allowed (1-4 windows). Does NOT submit to the board.

{
  "type": "object",
  "properties": {
    "7d": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "input": {
          "type": "number",
          "minimum": 0
        },
        "output": {
          "type": "number",
          "minimum": 0
        },
        "cache_read": {
          "type": "number",
          "minimum": 0
        },
        "cache_write": {
          "type": "number",
          "minimum": 0
        }
      },
      "description": "7-day window token pillars (optional)"
    },
    "30d": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "input": {
          "type": "number",
          "minimum": 0
        },
        "output": {
          "type": "number",
          "minimum": 0
        },
        "cache_read": {
          "type": "number",
          "minimum": 0
        },
        "cache_write": {
          "type": "number",
          "minimum": 0
        }
      },
      "description": "30-day window token pillars (optional)"
    },
    "90d": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "input": {
          "type": "number",
          "minimum": 0
        },
        "output": {
          "type": "number",
          "minimum": 0
        },
        "cache_read": {
          "type": "number",
          "minimum": 0
        },
        "cache_write": {
          "type": "number",
          "minimum": 0
        }
      },
      "description": "90-day window token pillars (optional)"
    },
    "all": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "input": {
          "type": "number",
          "minimum": 0
        },
        "output": {
          "type": "number",
          "minimum": 0
        },
        "cache_read": {
          "type": "number",
          "minimum": 0
        },
        "cache_write": {
          "type": "number",
          "minimum": 0
        }
      },
      "description": "All-time window token pillars (optional)"
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "context"
  ]
}

Answers 'How good am I?' — benchmarks your token cascade against the live field. Takes 4 token pillars (or a codename), computes your cascade, then compares against the live leaderboard: percentile, rank, distance from median, distance from top 10%, strongest metric, weakest metric, and a one-line interpretation. This is the human-question tool — use it when someone asks 'am I a power user?' or 'how do I compare?'.

{
  "type": "object",
  "properties": {
    "input": {
      "type": "number",
      "minimum": 0,
      "description": "Total input tokens. Required if codename is not provided."
    },
    "output": {
      "type": "number",
      "minimum": 0,
      "description": "Total output tokens. Required if codename is not provided."
    },
    "cache_read": {
      "type": "number",
      "minimum": 0,
      "description": "Cache-read tokens. Required if codename is not provided."
    },
    "cache_write": {
      "type": "number",
      "minimum": 0,
      "description": "Cache-write tokens. Required if codename is not provided."
    },
    "codename": {
      "type": "string",
      "description": "Operator codename (alternative to providing pillars). If provided, fetches live profile from the board."
    },
    "window": {
      "type": "string",
      "enum": [
        "7d",
        "30d",
        "90d",
        "all_time"
      ],
      "default": "30d",
      "description": "Time window for field comparison (default 30d)."
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "context"
  ]
}

Answers 'What would it take to reach a target rank?' — takes your current 4 token pillars and a target percentile (e.g. 90 for top 10%), then simulates the smallest metric changes needed to reach that position. Returns: current rank/percentile, simulated rank/percentile, the specific pillar changes required, and the yield delta. This turns SigRank from a scoreboard into a simulator. Use it when someone asks 'what would move my rank?' or 'how do I get to top 10%?'.

{
  "type": "object",
  "properties": {
    "input": {
      "type": "number",
      "minimum": 0,
      "description": "Current input tokens."
    },
    "output": {
      "type": "number",
      "minimum": 0,
      "description": "Current output tokens."
    },
    "cache_read": {
      "type": "number",
      "minimum": 0,
      "description": "Current cache-read tokens."
    },
    "cache_write": {
      "type": "number",
      "minimum": 0,
      "description": "Current cache-write tokens."
    },
    "target_percentile": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Target percentile (0-100). E.g. 90 for top 10%, 99 for top 1%."
    },
    "window": {
      "type": "string",
      "enum": [
        "7d",
        "30d",
        "90d",
        "all_time"
      ],
      "default": "30d",
      "description": "Time window for field comparison (default 30d)."
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "input",
    "output",
    "cache_read",
    "cache_write",
    "target_percentile",
    "context"
  ]
}

Answers 'What specifically separates operator A from operator B?' — not just 'A has more Yield', but the primary cause, secondary cause, and offsetting weakness. Takes two codenames or two sets of pillars, computes both cascades, and decomposes the yield gap into leverage, velocity, SNR, and scale contributions. Returns the most explanatory factor.

{
  "type": "object",
  "properties": {
    "a_codename": {
      "type": "string",
      "description": "Codename for operator A (alternative to a_* pillars)"
    },
    "b_codename": {
      "type": "string",
      "description": "Codename for operator B (alternative to b_* pillars)"
    },
    "a_input": {
      "type": "number",
      "minimum": 0
    },
    "a_output": {
      "type": "number",
      "minimum": 0
    },
    "a_cache_read": {
      "type": "number",
      "minimum": 0
    },
    "a_cache_write": {
      "type": "number",
      "minimum": 0
    },
    "b_input": {
      "type": "number",
      "minimum": 0
    },
    "b_output": {
      "type": "number",
      "minimum": 0
    },
    "b_cache_read": {
      "type": "number",
      "minimum": 0
    },
    "b_cache_write": {
      "type": "number",
      "minimum": 0
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "context"
  ]
}

Finds unusual operators, metric relationships, and outliers in the live leaderboard — without user prompting. Returns: highest velocity among below-median leverage operators, only top-50 operator with near-zero cache write, largest 30-day yield improvement, rarest signature, and extreme divergence. Powers automated micro-marketing and field insights.

{
  "type": "object",
  "properties": {
    "window": {
      "type": "string",
      "enum": [
        "7d",
        "30d",
        "90d",
        "all_time"
      ],
      "default": "30d"
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "context"
  ]
}

Finds operators whose operating signature most resembles yours. Takes 4 pillars or a codename, computes your signature, then searches the live leaderboard for the nearest neighbors by signature distance. Returns: nearest operators, similarity %, where they outperform you, where you outperform them, and what separates you from the better operator. Makes the leaderboard feel like a network, not a list.

{
  "type": "object",
  "properties": {
    "input": {
      "type": "number",
      "minimum": 0
    },
    "output": {
      "type": "number",
      "minimum": 0
    },
    "cache_read": {
      "type": "number",
      "minimum": 0
    },
    "cache_write": {
      "type": "number",
      "minimum": 0
    },
    "codename": {
      "type": "string",
      "description": "Operator codename (alternative to pillars)"
    },
    "window": {
      "type": "string",
      "enum": [
        "7d",
        "30d",
        "90d",
        "all_time"
      ],
      "default": "30d"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 20,
      "default": 5,
      "description": "Number of nearest neighbors to return (default 5)"
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "context"
  ]
}

Creates a 'YOU vs FIELD vs TOP 10% vs TOP 1%' comparison table for your cascade metrics. Takes 4 pillars or a codename, fetches the live leaderboard, and returns your metrics alongside field median, top quartile, top decile, and top percentile for yield, leverage, velocity, and SNR. Simple, useful, and immediately understandable.

{
  "type": "object",
  "properties": {
    "input": {
      "type": "number",
      "minimum": 0
    },
    "output": {
      "type": "number",
      "minimum": 0
    },
    "cache_read": {
      "type": "number",
      "minimum": 0
    },
    "cache_write": {
      "type": "number",
      "minimum": 0
    },
    "codename": {
      "type": "string",
      "description": "Operator codename (alternative to pillars)"
    },
    "window": {
      "type": "string",
      "enum": [
        "7d",
        "30d",
        "90d",
        "all_time"
      ],
      "default": "30d"
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "context"
  ]
}

Computes a normalized operating signature from 4 token pillars or a codename. Returns a signature code, a legacy six-label signature_label, dominant trait, and closest comparable operators from the live board. The deprecated archetype field is retained as a compatibility alias; these labels are not the 10-type Build Archetypes reference extension.

{
  "type": "object",
  "properties": {
    "input": {
      "type": "number",
      "minimum": 0
    },
    "output": {
      "type": "number",
      "minimum": 0
    },
    "cache_read": {
      "type": "number",
      "minimum": 0
    },
    "cache_write": {
      "type": "number",
      "minimum": 0
    },
    "codename": {
      "type": "string",
      "description": "Operator codename (alternative to pillars)"
    },
    "window": {
      "type": "string",
      "enum": [
        "7d",
        "30d",
        "90d",
        "all_time"
      ],
      "default": "30d"
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "context"
  ]
}