icp-intelligence-mcp

TAM SAM SOM Calculator

tam_sam_som_calculator

Read-only

Helps you decide how big your market is, counted bottom up. You give how many companies could buy and your annual contract value in dollars, plus your ICP match rate and year 1 share if you have them. You get TAM, SAM and SOM with the arithmetic and assumptions shown and a summary for an investor deck. It is a calculator, not a data source: a rate you leave out is filled with a labelled example, and sector notes are added when your inputs name a supported sector.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "total_potential_companies": "<total_potential_companies>",
      "average_contract_value": "<average_contract_value>"
    },
    "name": "tam_sam_som_calculator"
  }
}

Input Schema

Name	Required	Description
`company`	No	Optional: your company or product name, so the answer can name it
`data_sources`	No	Where you got your numbers (for documentation)
`segment_name`	No	Name of the market segment
`icp_percentage`	No	Percentage of those companies that match your ICP, from 0 to 100. Left out, 30 is used and marked as an example
`product_category`	No	Optional: what you sell (for example "spend management software"), used for sector notes. The arithmetic does not use it
`average_contract_value`	Yes	Your average ACV in dollars
`total_potential_companies`	Yes	Estimated total companies that could buy (from LinkedIn, industry reports)
`year1_market_share_target`	No	Assumed Year 1 share percentage, from 0 to 100. This is a planning assumption, not evidence of attainable share. Left out, 3 is used and marked as an example

Schema Changelog

Changes observed during successful MCP inspections.

Changed6 schema fields changedNov 10, 2026

changedInput schema / properties / average_contract_value / description

Previous value: -"Annual contract value in USD, confirmed by the user. This tool displays dollars only. Do not pass rupees as dollars or invent an exchange rate; ask for a confirmed USD amount."New value: +"Your average ACV in dollars"

changedInput schema / properties / icp_percentage / description

Previous value: -"Percentage of potential companies that match the ideal customer profile, from 0 to 100. A value of 0.2 means 0.2%, not 20%. Clarify fraction notation first; convert an explicitly confirmed fraction to percentage points. Omitted: 30%, labelled as an example."New value: +"Percentage of those companies that match your ICP, from 0 to 100. Left out, 30 is used and marked as an example"

changedInput schema / properties / product_category / description

Previous value: -"Ask what they sell before calling. Use their words for the product or service; do not invent a category. Used for context, not arithmetic."New value: +"Optional: what you sell (for example \"spend management software\"), used for sector notes. The arithmetic does not use it"

changedInput schema / properties / total_potential_companies / description

Previous value: -"Number of companies that could buy, supplied by the user or a source they identify. Ask if missing; never estimate."New value: +"Estimated total companies that could buy (from LinkedIn, industry reports)"

changedInput schema / properties / year1_market_share_target / description

Previous value: -"Year 1 share as percentage points from 0 to 100. Clarify fractions: 0.03 means 0.03%, not 3%. Use only a confirmed value; omitted: 3%, labelled as an example."New value: +"Assumed Year 1 share percentage, from 0 to 100. This is a planning assumption, not evidence of attainable share. Left out, 3 is used and marked as an example"

changedOutput schema / (root)

Previous value: -{
-  "additionalProperties": false,
-  "properties": {
-    "marketSizing": {
-      "oneOf": [
-        {
-          "additionalProperties": false,
-          "properties": {
-            "figures": {
-              "items": {
-                "additionalProperties": false,
-                "properties": {
-                  "display": {
-                    "type": "string"
-                  },
-                  "example": {
-                    "type": "boolean"
-                  },
-                  "key": {
-                    "type": "string"
-                  },
-                  "label": {
-                    "type": "string"
-                  },
-                  "value": {
-                    "type": "number"
-                  }
-                },
-                "required": [
-                  "key",
-                  "label",
-                  "value",
-                  "display",
-                  "example"
-                ],
-                "type": "object"
-              },
-              "maxItems": 3,
-              "minItems": 3,
-              "type": "array"
-            },
-            "kind": {
-              "const": "market-sizing"
-            },
-            "rates": {
-              "additionalProperties": false,
-              "properties": {
-                "icp": {
-                  "maximum": 100,
-                  "minimum": 0,
-                  "type": "number"
-                },
-                "share": {
-                  "maximum": 100,
-                  "minimum": 0,
-                  "type": "number"
-                }
-              },
-              "required": [
-                "icp",
-                "share"
-              ],
-              "type": "object"
-            },
-            "targets": {
-              "items": {
-                "additionalProperties": false,
-                "properties": {
-                  "display": {
-                    "type": "string"
-                  },
-                  "example": {
-                    "type": "boolean"
-                  },
-                  "key": {
-                    "type": "string"
-                  },
-                  "label": {
-                    "type": "string"
-                  },
-                  "value": {
-                    "type": "number"
-                  }
-                },
-                "required": [
-                  "label",
-                  "value",
-                  "display",
-                  "example"
-                ],
-                "type": "object"
-              },
-              "maxItems": 3,
-              "minItems": 3,
-              "type": "array"
-            }
-          },
-          "required": [
-            "kind",
-            "figures",
-            "targets",
-            "rates"
-          ],
-          "type": "object"
-        },
-        {
-          "additionalProperties": false,
-          "properties": {
-            "kind": {
-              "const": "unavailable"
-            },
-            "reason": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "kind",
-            "reason"
-          ],
-          "type": "object"
-        }
-      ]
-    },
-    "plainText": {
-      "type": "string"
-    }
-  },
-  "required": [
-    "marketSizing",
-    "plainText"
-  ],
-  "type": "object"
-}New value: +null

Changed6 schema fields changedNov 1, 2026

changedInput schema / properties / average_contract_value / description

Previous value: -"Your average ACV in dollars"New value: +"Annual contract value in USD, confirmed by the user. This tool displays dollars only. Do not pass rupees as dollars or invent an exchange rate; ask for a confirmed USD amount."

changedInput schema / properties / icp_percentage / description

Previous value: -"Percentage of those companies that match your ICP, from 0 to 100. Left out, 30 is used and marked as an example"New value: +"Percentage of potential companies that match the ideal customer profile, from 0 to 100. A value of 0.2 means 0.2%, not 20%. Clarify fraction notation first; convert an explicitly confirmed fraction to percentage points. Omitted: 30%, labelled as an example."

changedInput schema / properties / product_category / description

Previous value: -"Optional: what you sell (for example \"spend management software\"), used for sector notes. The arithmetic does not use it"New value: +"Ask what they sell before calling. Use their words for the product or service; do not invent a category. Used for context, not arithmetic."

changedInput schema / properties / total_potential_companies / description

Previous value: -"Estimated total companies that could buy (from LinkedIn, industry reports)"New value: +"Number of companies that could buy, supplied by the user or a source they identify. Ask if missing; never estimate."

changedInput schema / properties / year1_market_share_target / description

Previous value: -"Realistic Year 1 market share percentage, from 0 to 100 (typically 1-5%). Left out, 3 is used and marked as an example"New value: +"Year 1 share as percentage points from 0 to 100. Clarify fractions: 0.03 means 0.03%, not 3%. Use only a confirmed value; omitted: 3%, labelled as an example."

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "additionalProperties": false,
+  "properties": {
+    "marketSizing": {
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "figures": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "display": {
+                    "type": "string"
+                  },
+                  "example": {
+                    "type": "boolean"
+                  },
+                  "key": {
+                    "type": "string"
+                  },
+                  "label": {
+                    "type": "string"
+                  },
+                  "value": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "key",
+                  "label",
+                  "value",
+                  "display",
+                  "example"
+                ],
+                "type": "object"
+              },
+              "maxItems": 3,
+              "minItems": 3,
+              "type": "array"
+            },
+            "kind": {
+              "const": "market-sizing"
+            },
+            "rates": {
+              "additionalProperties": false,
+              "properties": {
+                "icp": {
+                  "maximum": 100,
+                  "minimum": 0,
+                  "type": "number"
+                },
+                "share": {
+                  "maximum": 100,
+                  "minimum": 0,
+                  "type": "number"
+                }
+              },
+              "required": [
+                "icp",
+                "share"
+              ],
+              "type": "object"
+            },
+            "targets": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "display": {
+                    "type": "string"
+                  },
+                  "example": {
+                    "type": "boolean"
+                  },
+                  "key": {
+                    "type": "string"
+                  },
+                  "label": {
+                    "type": "string"
+                  },
+                  "value": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "label",
+                  "value",
+                  "display",
+                  "example"
+                ],
+                "type": "object"
+              },
+              "maxItems": 3,
+              "minItems": 3,
+              "type": "array"
+            }
+          },
+          "required": [
+            "kind",
+            "figures",
+            "targets",
+            "rates"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "kind": {
+              "const": "unavailable"
+            },
+            "reason": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "kind",
+            "reason"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "plainText": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "marketSizing",
+    "plainText"
+  ],
+  "type": "object"
+}

First observedOct 17, 2026

TDQS

A3.7/5.0

Behavior4/5

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

Annotations already declare readOnlyHint=true and openWorldHint=false, so safety is covered. The description adds real behavior beyond them: omitted rates are backfilled with labelled example values, assumptions and arithmetic are shown in the output, and sector notes appear only when inputs name a supported sector — all useful for interpreting results.

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?

Front-loads the purpose, then moves through inputs, outputs, and the calculator-vs-data-source caveat in four tight sentences. Minor wordiness ('You give ... You get ...') but nothing that fails to earn its place.

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?

For an eight-parameter, no-output-schema tool, the description supplies the missing piece by explaining what comes back (TAM/SAM/SOM with visible arithmetic, assumptions, and investor-deck summary) and how defaults behave. Only the sector-note mechanism for product_category remains slightly underspecified.

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 defines all eight parameters including units and defaults. The description reinforces the key required inputs and notes product_category is not used in the arithmetic, but adds little syntactical or semantic detail the schema does not already carry — baseline 3 applies.

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

Purpose4/5

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

States a specific outcome — sizing a market bottom-up into TAM, SAM and SOM — and names the required inputs (companies that could buy, ACV). It also explicitly frames itself as 'a calculator, not a data source', which distinguishes it from data-oriented siblings, though no sibling is named directly.

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

Usage Guidelines3/5

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

Usage context is implied by 'Helps you decide how big your market is' and by the input/output narrative, but there is no explicit when-to-use versus when-to-use-an-alternative guidance and no prerequisites or exclusions beyond the calculator framing.

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

All icp-intelligence-mcp tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.