sigrank 0.15.0 → 0.15.3

package/README.md

@@ -16,6 +16,7 @@ For all builders, burners and 10xers.
 [![license](https://img.shields.io/badge/license-MIT-green.svg?style=flat-square)](./LICENSE)
 [![platform](https://img.shields.io/badge/platform-node-grey.svg?style=flat-square)](https://nodejs.org)
 [![live](https://img.shields.io/badge/board-signalaf.com-gold.svg?style=flat-square)](https://signalaf.com)
+[![SunrisesIllNeverSee/sigrank-mcp MCP server](https://glama.ai/mcp/servers/SunrisesIllNeverSee/sigrank-mcp/badges/score.svg)](https://glama.ai/mcp/servers/SunrisesIllNeverSee/sigrank-mcp)
 
 </div>
 

package/index.mjs

@@ -23,7 +23,14 @@
 
 import { Server } from '@modelcontextprotocol/sdk/server/index.js'
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
-import { CallToolRequestSchema, ListToolsRequestSchema, McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js'
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+  ListPromptsRequestSchema,
+  GetPromptRequestSchema,
+  McpError,
+  ErrorCode,
+} from '@modelcontextprotocol/sdk/types.js'
 import { TOOLS, callTool } from './tools.mjs'
 import { runCli } from './cli.mjs'
 import { readFileSync } from 'node:fs'
@@ -52,7 +59,10 @@ process.on('unhandledRejection', (reason) => {
 })
 
 async function startMcpServer() {
-  const server = new Server({ name: 'sigrank', version: serverVersion() }, { capabilities: { tools: {} } })
+  const server = new Server(
+    { name: 'sigrank', version: serverVersion() },
+    { capabilities: { tools: {}, prompts: {} } },
+  )
   server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }))
   server.setRequestHandler(CallToolRequestSchema, async (req) => {
     // Unknown tool name = a client/host bug → JSON-RPC -32602 protocol error, per the MCP
@@ -67,6 +77,82 @@ async function startMcpServer() {
       return { content: [{ type: 'text', text: `Error: ${e.message}` }], isError: true }
     }
   })
+
+  // --- Prompts: interactive templates that agents can offer to users ---
+  const PROMPTS = [
+    {
+      name: 'check-my-efficiency',
+      description:
+        'Pull your local token usage, compute your SigRank yield, and compare your efficiency against the leaderboard. Shows your class tier (Burner/Builder/10xer) and where you rank.',
+      arguments: [],
+    },
+    {
+      name: 'simulate-improvement',
+      description:
+        'Run a what-if analysis on your token mix: "if I increased my cache reads by 50k, how would my yield change?" Uses simulate_change to show the payoff before you change your workflow.',
+      arguments: [
+        {
+          name: 'change',
+          description: 'The change to simulate (e.g. "increase cache reads by 50000" or "reduce input by 100000")',
+          required: true,
+        },
+      ],
+    },
+    {
+      name: 'compare-with-leader',
+      description:
+        'Fetch the top operator from the SigRank leaderboard and compare their token efficiency metrics against yours. Shows the gap and what you\'d need to change to close it.',
+      arguments: [],
+    },
+  ]
+
+  server.setRequestHandler(ListPromptsRequestSchema, async () => ({ prompts: PROMPTS }))
+  server.setRequestHandler(GetPromptRequestSchema, async (req) => {
+    const name = req.params.name
+    const args = req.params.arguments || {}
+    if (name === 'check-my-efficiency') {
+      return {
+        messages: [
+          {
+            role: 'user',
+            content: {
+              type: 'text',
+              text: 'Pull my local token usage with tokenpull, compute my yield, and then fetch the leaderboard so I can see where I rank. Show me my class tier and my key metrics (Yield, Leverage, Velocity).',
+            },
+          },
+        ],
+      }
+    }
+    if (name === 'simulate-improvement') {
+      const change = args.change || 'increase cache reads by 50000'
+      return {
+        messages: [
+          {
+            role: 'user',
+            content: {
+              type: 'text',
+              text: `First pull my local token usage with tokenpull to get my current pillars. Then use simulate_change to answer: "what if I ${change}?" Show me the yield delta and whether my class tier would change.`,
+            },
+          },
+        ],
+      }
+    }
+    if (name === 'compare-with-leader') {
+      return {
+        messages: [
+          {
+            role: 'user',
+            content: {
+              type: 'text',
+              text: 'Fetch the SigRank leaderboard with get_leaderboard, then pull my local token usage with tokenpull. Compare my yield, leverage, and velocity against the top operator. What\'s the gap and what would I need to change to close it?',
+            },
+          },
+        ],
+      }
+    }
+    throw new McpError(ErrorCode.InvalidParams, `Unknown prompt: ${name}`)
+  })
+
   await server.connect(new StdioServerTransport())
 }
 

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "sigrank",
-  "version": "0.15.0",
+  "version": "0.15.3",
   "description": "SigRank MCP server — the yield cascade + live leaderboard as MCP tools any agent can call",
+  "mcpName": "io.github.SunrisesIllNeverSee/sigrank-mcp",
   "type": "module",
   "license": "MIT",
   "repository": {

package/tools.mjs

@@ -169,28 +169,54 @@ export const TOOLS = [
   {
     name: 'rank_paste',
     description:
-      'Rank a paste of ccusage-style token counts. Accepts JSON {input,output,cacheCreate,cacheRead} or 4 whitespace-separated numbers in that order. Returns Υ Yield, SNR, Leverage, Velocity, 10xDEV, class, AND a deterministic prose "card". Token-only; computes locally.',
-    inputSchema: { type: 'object', properties: { text: { type: 'string', description: 'ccusage JSON or "input output cacheCreate cacheRead"' } }, required: ['text'] },
+      'Rank a paste of ccusage-style token counts to compute your SigRank yield. Accepts JSON {input,output,cacheCreate,cacheRead} or 4 whitespace-separated numbers in that order (input output cacheCreate cacheRead). Returns Υ Yield (the headline efficiency metric), SNR, Leverage ratio (Cr/I), Velocity (O/I), 10xDEV score, operator class tier (Burner/Builder/10xer), and a deterministic prose "card" summarizing the result. All computation is local — no network calls, no prompt data leaves the machine. Use this for a quick one-off ranking without submitting to the board.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        text: {
+          type: 'string',
+          description: 'Token counts to rank. Two formats accepted: (1) JSON object {"input":N,"output":N,"cacheCreate":N,"cacheRead":N} or (2) four whitespace-separated numbers in order: input output cacheCreate cacheRead. Get these from `ccusage` output, the Claude Max dashboard, or any token reader.',
+        },
+      },
+      required: ['text'],
+    },
   },
   {
     name: 'get_leaderboard',
-    description: 'The live public SigRank board (signalaf.com) — operators ranked by yield.',
+    description:
+      "Fetch the live public SigRank leaderboard from signalaf.com — all ranked operators sorted by yield (Υ = Cache Reads × Output / Input²). Returns each operator's codename, yield, leverage ratio (Cr/I), velocity (O/I), class tier, and rank. Use this to see where operators stand overall or to find specific codenames for get_operator lookups.",
     inputSchema: { type: 'object', properties: {} },
   },
   {
     name: 'get_operator',
-    description: "One operator's live profile by codename.",
-    inputSchema: { type: 'object', properties: { codename: { type: 'string' } }, required: ['codename'] },
+    description:
+      "Fetch one operator's live profile from the SigRank board by their codename. Returns their current yield (Υ), leverage ratio (Cr/I), velocity (O/I), class tier, rank position, and per-window breakdowns (7d/30d/90d/all-time). Use this to look up any operator who has submitted to the board — codenames are public and visible on the leaderboard.",
+    inputSchema: {
+      type: 'object',
+      properties: {
+        codename: {
+          type: 'string',
+          description: 'The operator\'s public codename as shown on the SigRank leaderboard (e.g. "Ghost Falcon", "Iron Lotus"). Case-insensitive.',
+        },
+      },
+      required: ['codename'],
+    },
   },
   {
     name: 'submit_paste',
     description:
-      'Rank a paste AND publish it to the live SigRank board in one call. Computes the cascade locally (instant preview + card), then submits the RAW paste to the board\'s web-paste endpoint, which re-parses and re-scores it server-side (authoritative). A codename is required to publish; omit it for a local preview only. Token-only, no auth (matches the web paste path). Best with a ccusage JSON paste — the 4-number form ranks locally but the board may reject it.',
+      'Rank a paste of token counts AND publish it to the live SigRank board at signalaf.com in one call. Computes the cascade locally for an instant preview + card, then submits the raw paste to the board\'s web-paste endpoint, which re-parses and re-scores it server-side (the server score is authoritative). A codename is required to publish — omit it for a local preview only. Token-only, no auth required (matches the web paste path). Best with a ccusage JSON paste — the 4-number form ranks locally but the board may reject it.',
     inputSchema: {
       type: 'object',
       properties: {
-        text: { type: 'string', description: 'ccusage JSON or "input output cacheCreate cacheRead"' },
-        codename: { type: 'string', description: 'operator codename to publish under (required to submit; omit for local preview only)' },
+        text: {
+          type: 'string',
+          description: 'Token counts to rank and submit. Two formats: (1) JSON {"input":N,"output":N,"cacheCreate":N,"cacheRead":N} from ccusage, or (2) four whitespace-separated numbers: input output cacheCreate cacheRead.',
+        },
+        codename: {
+          type: 'string',
+          description: 'Operator codename to publish under on the leaderboard (e.g. "Ghost Falcon"). Required to submit — omit for local preview only (no board submission).',
+        },
       },
       required: ['text'],
     },
@@ -213,13 +239,24 @@ export const TOOLS = [
   {
     name: 'tokenpull_submit',
     description:
-      "Pull your LOCAL usage (tokenpull) AND publish it to the SigRank board in one call — the zero-paste flow. Submits the canonical 4 pillars per window, each re-scored server-side and tagged with the source platform. Requires a codename to publish; omit for local preview. Token-only.",
+      "Pull your LOCAL token usage from session logs AND publish it to the SigRank board in one call — the zero-paste flow. Reads the four canonical pillars (input, output, cacheCreate, cacheRead) per window from your local logs, computes the cascade, and submits each window to the board where it is re-scored server-side and tagged with the source platform. Requires a codename to publish; omit for a local preview only. Token-only — no prompt content is read or transmitted.",
     inputSchema: {
       type: 'object',
       properties: {
-        codename: { type: 'string', description: 'operator codename to publish under (omit for preview-only)' },
-        window:   { type: 'string', enum: ['7d', '30d', '90d', 'all'], description: 'submit only this window (default: all 4)' },
-        platform: { type: 'string', enum: ALL_PLATFORMS, description: `source platform (default: claude). Supported: ${ALL_PLATFORMS.join(', ')}` },
+        codename: {
+          type: 'string',
+          description: 'Operator codename to publish under on the leaderboard (e.g. "Iron Lotus"). Required to submit — omit for local preview only.',
+        },
+        window: {
+          type: 'string',
+          enum: ['7d', '30d', '90d', 'all'],
+          description: 'Submit only this time window (default: all 4 windows). Use "7d" for recent activity or "all" for all-time ranking.',
+        },
+        platform: {
+          type: 'string',
+          enum: ALL_PLATFORMS,
+          description: `Source platform to pull from (default: claude). Supported: ${ALL_PLATFORMS.join(', ')}. Each platform reads its own session logs locally.`,
+        },
       },
     },
   },