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_rfm | Run RFM (Recency, Frequency, Monetary) analysis on client data. Scores clients based on purchase behavior, segments them into 11 categories, and extracts ICP patterns from top performers. Args: source: Data source — "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, and tier recommendations. |
| qualify | Score a prospect against the Artefact 14.5-point ICP model. Evaluates Firmographic Fit (5 pts), Behavioral Fit (5 pts), and Strategic Fit (4.5 pts). Returns tier classification (1-4), score breakdown, and recommended engagement strategy. 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"). Returns: JSON with total score, tier, breakdown, exclusion check, and recommended action. |
| score_pipeline_health | Analyze pipeline health with velocity metrics, conversion rates, and at-risk detection. Calculates overall health score (0-100), identifies bottleneck stages, measures stage-to-stage conversion rates, and flags stalled or overdue deals. Args: pipeline_id: Optional HubSpot pipeline ID to filter. Default: all pipelines. source: "hubspot" for live data, "sample" for built-in demo data. Returns: JSON with health score, velocity metrics, conversion rates, at-risk deals, and stage distribution. |
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. |