artefact-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HUBSPOT_API_KEY | No | HubSpot private app token. Without it, tools work with source="sample". | |
| ARTEFACT_LICENSE_KEY | No | License key for Pro/Enterprise tier. Free tier (sample data) works without a key. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tasks | {
"list": {},
"cancel": {},
"requests": {
"tools": {
"call": {}
},
"prompts": {
"get": {}
},
"resources": {
"read": {}
}
}
} |
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| run_rfmA | Run RFM (Recency, Frequency, Monetary) analysis on client data. Scores clients based on purchase behavior, segments them into 11 categories, extracts ICP patterns from top performers, and detects win/loss pattern signals. Args: source: Data source — "auto" (uses HubSpot if API key is set, otherwise sample data), "hubspot" for live HubSpot data, "sample" for built-in demo data. industry_preset: Scoring preset — "b2b_service", "saas", "manufacturing", or "default". Returns: JSON with scored clients, segment distribution, ICP patterns, signals, and tier recommendations. |
| qualifyA | Score a prospect against the Artefact 14.5-point ICP model with constraint context. Evaluates Firmographic Fit (5 pts), Behavioral Fit (5 pts), and Strategic Fit (4.5 pts). Returns tier classification, score breakdown, recommended engagement strategy, and how this prospect relates to your scaling constraints. Provide EITHER company_id (HubSpot ID, requires HUBSPOT_API_KEY) OR company_data (JSON string). Args: company_id: HubSpot company ID to fetch and score. company_data: JSON string with company attributes. Example keys: industry, annual_revenue, employee_count, geography, tech_stack (list), growth_signals (list), content_engagement ("active"|"occasional"|"none"), purchase_history ("regular"|"occasional"|"never"), decision_maker_access ("c_suite"|"director"|"manager"|"indirect"|"none"), budget_authority ("dedicated"|"shared"|"possible"|"none"), strategic_alignment ("strong"|"partial"|"misaligned"). scoring_config: Optional JSON string to override default scoring parameters. Returns: JSON with total score, tier, breakdown, constraint context, and recommended action. |
| score_pipeline_healthA | Analyze pipeline health with velocity metrics, signal detection, and exit criteria testing. Calculates overall health score (0-100), identifies bottleneck stages, measures stage-to-stage conversion rates, flags stalled deals, detects pipeline signals, and optionally tests deals against exit criteria. Args: pipeline_id: Optional HubSpot pipeline ID to filter. Default: all pipelines. source: "auto" (uses HubSpot if API key is set, otherwise sample data), "hubspot" for live data, "sample" for built-in demo data. exit_criteria: Optional JSON string with exit criteria to test against. List of objects: [{stage, test_name, required_field, is_blocking}]. Returns: JSON with health score, velocity, conversion rates, at-risk deals, signals, and optional exit criteria test results. |
| detect_signals | Scan pipeline data for all 6 signal types and return structured findings. Detects: win_loss_pattern, conversion_drop_off, velocity_anomaly, attribution_shift, data_quality, and pipeline concentration signals. Each signal includes signal_type, signal_strength (0-1), evidence, and recommended_action — enabling evidence-backed GTM decisions. Args: source: "auto" (uses HubSpot if API key is set, otherwise sample data), "hubspot" for live data, "sample" for built-in demo data. pipeline_id: Optional HubSpot pipeline ID to filter. Returns: JSON with detected signals, summary, critical signals, and signal taxonomy. |
| identify_constraintA | Identify the dominant scaling constraint bottlenecking revenue. Analyzes pipeline coverage, conversion rates, velocity, and deal characteristics to determine which of 4 constraints is dominant: Lead Generation, Conversion, Delivery, or Profitability. Returns the Revenue Formula breakdown (Traffic × CR1 × CR2 × ... × ACV × 1/Churn) with gap-to-benchmark for each lever and the weakest link. Args: source: "auto" (uses HubSpot if API key is set, otherwise sample data), "hubspot" for live data, "sample" for built-in demo data. pipeline_id: Optional HubSpot pipeline ID to filter. quota: Optional quarterly revenue quota for pipeline coverage calculation. Returns: JSON with dominant constraint, severity scores, revenue formula, and recommended focus. |
| analyze_engineA | Analyze a Value Engine: Growth, Fulfillment, or Innovation. Each engine has its own stages, metrics, and health scoring:
Args: engine_type: Which engine — "growth", "fulfillment", or "innovation". source: "auto" (uses HubSpot if API key is set, otherwise sample data), "hubspot" for live data, "sample" for built-in demo data. pipeline_id: Optional HubSpot pipeline ID to filter. Returns: JSON with engine definition, health score, metrics, signals, and recommendations. |
| propose_gtm_changeA | Draft a structured GTM commit proposal following the GTM OS anatomy. Creates a version-controlled change proposal with: Intent, Diff, Impact Surface, Risk Level, Evidence, and Measurement Plan. Does NOT apply the change — outputs a proposal for human review. Args: entity_type: What's being changed — "icp", "persona", "positioning", "pipeline_stage", "exit_criteria", "gtm_motion", "scoring_model", "playbook". change_description: Human-readable description of the proposed change. current_state: Optional description of current state (before). proposed_state: Optional description of proposed state (after). signal_type: Optional signal type that triggered this change (win_loss_pattern, conversion_drop_off, velocity_anomaly, spiced_frequency, attribution_shift, data_quality). signal_data: Optional JSON string with structured evidence from signal detection. Returns: JSON with structured commit proposal and next steps. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| scoring_model | ICP 14.5-point scoring model reference. |
| tier_definitions | 4-tier classification system (Ideal / Strong / Moderate / Poor). |
| rfm_segments | 11 RFM segment definitions with scoring scales. |
| spiced_framework | SPICED discovery framework reference. |
| value_engines | 3 Value Engines: Growth, Fulfillment, Innovation — stages, metrics, and mapping. |
| exit_criteria | Pipeline stage exit criteria framework with standard test library. |
| constraints | 4 scaling constraints (Lead Gen, Conversion, Delivery, Profitability) with diagnostics. |
| signal_taxonomy | 6 signal types for evidence-backed GTM intelligence. |
| revenue_formula | WbD multiplicative pipeline model + NRR compounding formula. |
| gtm_commit_anatomy | 5-component structure for version-controlled GTM changes. |
| server_version | Server version and status information. |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/artefactventures/artefact-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server