Skip to content
ICP Intelligence
ICP Intelligence · documentation

ICP Intelligence documentation

The MCP address, the REST API behind the web forms, and every field of all 9 tools.

MCP server

REST API (used by the web forms)

Send POST https://icp-intelligence.gtmhelix.com/api/tools/<tool name> with a JSON body {"input": {...}}. The answer is JSON: {"ok": true, "tool": "...", "title": "...", "text": "..."}, where text is the same Markdown the MCP tool returns. The endpoint calls the same server code as the MCP address.

curl -s -X POST https://icp-intelligence.gtmhelix.com/api/tools/icp_deep_dive \
  -H "Content-Type: application/json" \
  -d '{"input": {"customer_descriptions": "Mid-market healthcare clinic groups with 5 to 20 locations, Series A funded; the operations director buys and the pain is no-shows. Also healthcare dental chains with 10+ clinics and physiotherapy franchises.", "product_category": "clinic scheduling software"}}'

Tool reference

Generated from the server's own input schemas on 25 September 2026.

ICP Deep Dive icp_deep_dive

Analyze customer data to detect ICP patterns - firmographics, technographics, buying behavior Open the form.

FieldTypeRequiredAllowed valuesMeaning
customerslist of objectsnoList of customer objects with available attributes
customer_descriptionsstringnoAlternative: Describe your best customers in text format
product_categorystringnoWhat type of product you sell

ICP Scoring Model icp_scoring_model

Create a lead qualification scoring template: criteria with example point weights set by importance level, a scorecard and tier bands to adjust. Your success patterns are shown for reference; they do not set the weights Open the form.

FieldTypeRequiredAllowed valuesMeaning
scoring_criterialist of objectsnoCriteria for scoring with importance levels
success_correlationstringnoWhat correlates with success? (e.g., "deals with VP Sales champion close 2x faster")
product_categorystringno

Buyer Group Analyzer buyer_group_analyzer

Map buyer group dynamics, influence relationships, and decision-making process Open the form.

FieldTypeRequiredAllowed valuesMeaning
deal_sizestringnoACV range (e.g., "$50K-100K")
target_company_sizestringnoCompany size (e.g., "500-1000 employees")
product_categorystringyesWhat you sell
known_stakeholderslist of stringsnoRoles you know are involved
typical_championstringnoYour typical champion role

TAM SAM SOM Calculator tam_sam_som_calculator

Calculate TAM/SAM/SOM using bottom-up methodology from your data (calculation framework, not data source) Open the form.

FieldTypeRequiredAllowed valuesMeaning
total_potential_companiesnumberyesEstimated total companies that could buy (from LinkedIn, industry reports)
average_contract_valuenumberyesYour average ACV in dollars
icp_percentagenumbernoPercentage that match your ICP (1-100)
year1_market_share_targetnumbernoRealistic Year 1 market share percentage (typically 1-5%)
data_sourcesstringnoWhere you got your numbers (for documentation)
segment_namestringnoName of the market segment

Lookalike Signal Generator lookalike_signal_generator

Generate platform-specific targeting criteria and search queries (generates criteria, not data) Open the form.

FieldTypeRequiredAllowed valuesMeaning
icp_firmographicsobjectnoFirmographic criteria
icp_technographicslist of stringsnoTechnologies your ICP typically uses
champion_titleslist of stringsyesJob titles of your champions
buying_triggerslist of stringsnoEvents that trigger buying
platformslist of stringsnoAccepted but not used yet: the output always includes every platform section (linkedin, google_ads, 6sense, zoominfo)

Account Prioritization account_prioritization

Rank and prioritize accounts using multi-dimensional scoring Open the form.

FieldTypeRequiredAllowed valuesMeaning
accountslist of objectsnoList of accounts to prioritize. Each account: name, fit_score (0 to 100), intent_signals (0 to 100), relationship, timing
prioritization_weightsobjectnoOptional custom weights in percent for fit, intent, relationship and timing. A missing weight uses its default (40, 30, 15, 15); the tool does not check that the weights sum to 100

ICP Gap Analysis icp_gap_analysis

Analyze gaps between current customer base and ideal ICP Open the form.

FieldTypeRequiredAllowed valuesMeaning
current_customersstringyesDescription of your current customer base
ideal_icpstringyesDescription of your ideal customer profile
current_metricsobjectnoCurrent performance metrics
target_metricsobjectnoTarget performance metrics

ICP Evolution Tracker icp_evolution_tracker

Checklist for reviewing how your ICP should evolve: shows your recent wins, losses and market changes next to what to check. It does not analyze the text Open the form.

FieldTypeRequiredAllowed valuesMeaning
current_icpstringyesYour current ICP definition
recent_winsstringnoDescription of recent successful customers
recent_lossesstringnoDescription of recent lost deals
market_changesstringnoRecent market or competitive changes
time_periodstringnoTime period for analysis (e.g., "Q4 2024")

ICP Interview Synthesizer icp_interview_synthesizer

Extract ICP patterns from customer interview notes or transcripts Open the form.

FieldTypeRequiredAllowed valuesMeaning
interview_noteslist of objectsnoStructured interview notes
raw_transcriptsstringnoAlternative: Paste raw interview transcripts or notes
analysis_focusstringnoAccepted but not used yet: every run gives the complete analysis (pain_points, buying_journey, value_props, all)