eng-leadership-toolkit

Developer value & salary calculator

calculate_developer_value

Read-onlyIdempotent

Assess a software developer's market value: score 15 skills across 5 pillars (core craft, systems & judgment, impact & ownership, collaboration & influence, AI leverage), get a weighted total score, seniority level, and a 2026 Western-Europe gross salary estimate. Same logic as the live calculator at marian.coach. Unscored skills default to the level's baseline.

Input Schema

TableJSON Schema

Name	Required	Description
`level`	No	Required. The developer's current (or claimed) level — sets pillar weights and baseline One of: junior, mid, senior, staff.
`scores`	No	Optional 0-10 score per skill. Valid keys: discipline-mastery, code-quality, debugging, system-design, tech-decisions, data-performance, shipping-outcomes, production-ownership, domain-expertise, communication, mentoring, cross-functional, ai-output, ai-quality, ai-workflows. Omitted skills use the level baseline (junior 3, mid 5, senior 6, staff 7).
`context`	No	Optional. A short description of your goal and why you are calling this tool. Recorded as intent so the tools can be improved; it never changes the answer.

Output Schema

TableJSON Schema

Name	Required	Description
`math`	No	Napkin math behind the case.
`email`	No	Forwardable email to the manager.
`level`	No	Seniority level the score maps to, when the tool computes one.
`report`	Yes	The full human-readable report.
`source`	Yes	Canonical marian.coach page this answer is derived from.
`verdict`	No	Headline verdict, when the tool returns one.
`evidence`	No	Sources the case may cite.
`onePager`	No	Manager-facing one-pager, forwardable to finance.
`salaryEur`	No	Estimated 2026 Western-Europe gross annual salary in EUR.
`objections`	No	The usual objections, answered.
`slackShort`	No	Slack/Teams-length version of the ask.
`totalScore`	No	Weighted 0-10 score, when the tool computes one.
`valueFormula`	No	The four value lines to add up (money saved, cost of delay, missed opportunity, roadmap slippage) plus the count-then-halve CFO rule.
`talkingPoints`	No	Five talking points for the conversation.
`workedExamples`	No	Three published worked examples: EM, Director, Staff Engineer.

Schema Changelog

Changes observed during successful MCP inspections.

Changed8 schema fields changedSep 11, 2026

changedInput schema / properties / context / description

Previous value: -"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.\""New value: +"Optional. A short description of your goal and why you are calling this tool. Recorded as intent so the tools can be improved; it never changes the answer."

changedInput schema / properties / level / description

Previous value: -"The developer's current (or claimed) level — sets pillar weights and baseline"New value: +"Required. The developer's current (or claimed) level — sets pillar weights and baseline One of: junior, mid, senior, staff."

removedInput schema / properties / level / enum

Removed value: -[
-  "junior",
-  "mid",
-  "senior",
-  "staff"
-]

addedInput schema / properties / scores / additionalProperties / anyOf

Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "string"
+  }
+]

removedInput schema / properties / scores / additionalProperties / maximum
```
Removed value: -10
```
removedInput schema / properties / scores / additionalProperties / minimum
```
Removed value: -0
```
removedInput schema / properties / scores / additionalProperties / type
```
Removed value: -"number"
```

removedInput schema / required

Removed value: -[
-  "level",
-  "context"
-]

Changed2 schema fields changedAug 27, 2026

addedInput schema / properties / context

Added value: +{
+  "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.\"",
+  "type": "string"
+}

changedInput schema / required

Previous value: -[
-  "level"
-]New value: +[
+  "level",
+  "context"
+]

Changed9 schema fields changedAug 17, 2026

addedOutput schema / properties / email

Added value: +{
+  "additionalProperties": false,
+  "description": "Forwardable email to the manager.",
+  "properties": {
+    "body": {
+      "type": "string"
+    },
+    "subject": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "subject",
+    "body"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / evidence

Added value: +{
+  "description": "Sources the case may cite.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "claim": {
+        "type": "string"
+      },
+      "source": {
+        "type": "string"
+      },
+      "url": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "claim",
+      "source",
+      "url"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / math

Added value: +{
+  "additionalProperties": false,
+  "description": "Napkin math behind the case.",
+  "properties": {
+    "askEur": {
+      "type": "number"
+    },
+    "discountedEur": {
+      "type": "number"
+    },
+    "lines": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "note": {
+      "type": "string"
+    },
+    "packPriceEur": {
+      "type": "number"
+    },
+    "roiMultiple": {
+      "anyOf": [
+        {
+          "type": "number"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "totalEur": {
+      "type": "number"
+    }
+  },
+  "required": [
+    "lines",
+    "totalEur",
+    "discountedEur",
+    "askEur",
+    "packPriceEur",
+    "roiMultiple",
+    "note"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / objections

Added value: +{
+  "description": "The usual objections, answered.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "answer": {
+        "type": "string"
+      },
+      "objection": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "objection",
+      "answer"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / onePager

Added value: +{
+  "additionalProperties": false,
+  "description": "Manager-facing one-pager, forwardable to finance.",
+  "properties": {
+    "sections": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "body": {
+            "type": "string"
+          },
+          "bullets": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "heading": {
+            "type": "string"
+          },
+          "table": {
+            "items": {
+              "items": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "string"
+                }
+              ],
+              "type": "array"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "heading"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "title": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "title",
+    "sections"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / slackShort

Added value: +{
+  "description": "Slack/Teams-length version of the ask.",
+  "type": "string"
+}

addedOutput schema / properties / talkingPoints

Added value: +{
+  "description": "Five talking points for the conversation.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / valueFormula

Added value: +{
+  "additionalProperties": false,
+  "description": "The four value lines to add up (money saved, cost of delay, missed opportunity, roadmap slippage) plus the count-then-halve CFO rule.",
+  "properties": {
+    "heading": {
+      "type": "string"
+    },
+    "lines": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "rule": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "heading",
+    "lines",
+    "rule"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / workedExamples

Added value: +{
+  "description": "Three published worked examples: EM, Director, Staff Engineer.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "kpis": {
+        "type": "string"
+      },
+      "math": {
+        "type": "string"
+      },
+      "role": {
+        "type": "string"
+      },
+      "setup": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "role",
+      "setup",
+      "kpis",
+      "math"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Changed1 schema field changedJul 26, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "level": {
+      "description": "Seniority level the score maps to, when the tool computes one.",
+      "type": "string"
+    },
+    "report": {
+      "description": "The full human-readable report.",
+      "type": "string"
+    },
+    "salaryEur": {
+      "description": "Estimated 2026 Western-Europe gross annual salary in EUR.",
+      "type": "number"
+    },
+    "source": {
+      "description": "Canonical marian.coach page this answer is derived from.",
+      "type": "string"
+    },
+    "totalScore": {
+      "description": "Weighted 0-10 score, when the tool computes one.",
+      "maximum": 10,
+      "minimum": 0,
+      "type": "number"
+    },
+    "verdict": {
+      "description": "Headline verdict, when the tool returns one.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "report",
+    "source"
+  ],
+  "type": "object"
+}

First observedJul 12, 2026

TDQS

A3.7/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the safety profile (readOnly, idempotent, non-destructive), so the description earns credit for the extras it adds: weights come from the level, unscored skills fall back to a level baseline, and the optional context string is recorded but never affects the result. That disclosure of determinism and defaulting behavior is genuinely useful beyond the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, front-loaded with the purpose and output shape, with the baseline-default rule as a useful trailing clarification. The 'Same logic as the live calculator at marian.coach' sentence is a credibility note that borders on filler but is short enough not to hurt.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so explaining return values is optional, yet the description still names the key outputs. Inputs are fully documented in the schema. The only real gap is the absent routing guidance against sibling calculators, which is a usage matter rather than a completeness failure.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents the level enum, the fifteen valid skill keys, score range, and baselines. The description restates the baseline-default rule and the pillar grouping but adds no syntax or semantics the schema lacks; baseline 3 is appropriate when structured fields do the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Assess a software developer's market value') and enumerates the concrete outputs: a 15-skill/5-pillar score, weighted total, seniority level, and a 2026 Western-Europe gross salary estimate. The resource ('software developer') and geographic/year scope make it distinguishable from siblings like calculate_engineering_manager_value or assess_team_lead_readiness.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explains what the tool computes but never says when to reach for it versus alternatives such as calculate_engineering_manager_value or get_engineering_leadership_benchmarks. The reference to 'the live calculator at marian.coach' is a provenance note, not usage guidance, and no exclusions or prerequisites are given.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All eng-leadership-toolkit tools Inspect

Try in Browser

Pay for results, not tokens.Fund a bounty. Let AI agents compete and collaborate to solve your problems.agentbounties.appAd

Glama MCP Gateway

Add one secure layer between your agents and this server.