{"passport":{"unfragile":{"@version":"1.0","version":"2026-05","artifact":{"id":"hubspot-mcp-server","slug":"hubspot-mcp-server","name":"HubSpot MCP Server","type":"mcp","url":"https://github.com/hubspot/hubspot-mcp-server","page_url":"https://unfragile.ai/hubspot-mcp-server","categories":["mcp-servers"],"tags":["hubspot","crm","marketing","official"],"pricing":{"model":"free","free":true,"starting_price":null},"status":"active","verified":false},"capabilities":[{"id":"hubspot-mcp-server__cap_0","uri":"capability://tool.use.integration.contact.lifecycle.management.via.mcp.tools","name":"contact lifecycle management via mcp tools","description":"Exposes HubSpot contact CRUD operations through MCP tool schema, enabling AI agents to create, read, update, and delete contacts with property mapping to HubSpot's contact object model. Implements bidirectional sync between agent state and HubSpot's contact database through standardized MCP tool definitions that translate agent requests into HubSpot API calls with automatic property validation and error handling.","intents":["I need my AI agent to create new contacts from form submissions or lead sources","I want to update contact properties (email, phone, lifecycle stage) based on agent decisions","I need to retrieve contact history and properties to inform agent reasoning","I want to delete or merge duplicate contacts programmatically"],"best_for":["AI agent developers building lead qualification workflows","Teams automating contact enrichment and segmentation","Developers integrating HubSpot CRM with multi-step AI reasoning loops"],"limitations":["Batch operations limited by HubSpot API rate limits (10 requests/second for standard tier)","No built-in conflict resolution for concurrent contact updates from multiple agents","Property schema must be pre-defined in HubSpot; dynamic property creation not supported","Soft-delete operations not exposed; deletion is permanent"],"requires":["HubSpot API key with contacts scope","MCP client implementation (Claude Desktop, Cline, or compatible)","Network connectivity to HubSpot API endpoints"],"input_types":["JSON object with contact properties (email, firstName, lastName, phone, customProperties)","Contact ID or email for lookup/update operations","Filter criteria for batch retrieval"],"output_types":["Contact object with all properties and metadata","Contact ID for newly created contacts","Boolean success/failure for delete operations","Array of contacts matching filter criteria"],"categories":["tool-use-integration","crm-operations"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"hubspot-mcp-server__cap_1","uri":"capability://tool.use.integration.company.and.organization.hierarchy.traversal","name":"company and organization hierarchy traversal","description":"Provides MCP tools to navigate HubSpot's company object graph, including parent-child relationships, associated contacts, and deal pipelines. Implements hierarchical queries that allow agents to understand organizational structure and relationships without requiring multiple sequential API calls, using HubSpot's association API under the hood to resolve company-to-contact and company-to-deal relationships.","intents":["I need to understand the organizational structure of an account (parent company, subsidiaries, divisions)","I want to find all contacts associated with a specific company","I need to retrieve all deals in a company's pipeline to assess account health","I want to identify decision-makers and stakeholders within an organization"],"best_for":["Enterprise sales agents building account-based selling workflows","Customer success teams analyzing account structure and relationships","Developers building multi-tenant AI systems that need to respect organizational boundaries"],"limitations":["Association queries return only direct relationships; transitive queries (e.g., contacts of subsidiaries) require multiple API calls","Company hierarchy depth limited by API response size; very large organizations may require pagination","No real-time change notifications; agents see eventual-consistent view of company data"],"requires":["HubSpot API key with companies and associations scopes","Company IDs or domain names for lookup","MCP client with support for multi-step tool chains"],"input_types":["Company ID (numeric)","Company domain name","Filter criteria (industry, employee count, revenue range)"],"output_types":["Company object with properties and metadata","Array of associated contacts with roles","Array of associated deals with pipeline stage","Parent/child company relationships"],"categories":["tool-use-integration","memory-knowledge"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"hubspot-mcp-server__cap_2","uri":"capability://tool.use.integration.deal.pipeline.stage.progression.and.forecasting","name":"deal pipeline stage progression and forecasting","description":"Exposes deal CRUD operations and pipeline stage transitions through MCP tools, enabling agents to move deals through sales pipelines, update deal properties (amount, close date, probability), and retrieve pipeline analytics. Implements validation of stage transitions based on HubSpot's pipeline configuration, preventing invalid state changes and maintaining data integrity across the sales process.","intents":["I need my agent to advance deals through pipeline stages based on customer actions or milestones","I want to update deal amounts and close dates as negotiations progress","I need to retrieve pipeline metrics (deals by stage, win rate, average deal size) for forecasting","I want to create deals from qualified leads and assign them to sales reps"],"best_for":["Sales operations teams automating deal progression workflows","AI agents managing sales pipelines with minimal human intervention","Revenue intelligence systems that need to track deal health and forecast accuracy"],"limitations":["Stage transitions validated against pipeline configuration; custom pipelines require pre-configuration in HubSpot","No built-in conflict resolution for concurrent deal updates (last-write-wins)","Deal probability not automatically calculated; must be set explicitly by agent or user","No support for deal splitting or multi-owner scenarios"],"requires":["HubSpot API key with deals scope","Pipeline ID for the target pipeline","Valid stage names matching HubSpot pipeline configuration"],"input_types":["Deal ID or deal name","Target pipeline stage (string)","Deal properties (amount, closeDate, dealStage, probability)","Filter criteria for pipeline analytics"],"output_types":["Deal object with current properties and stage","Pipeline summary (deals by stage, total value, count)","Deal history/activity log","Boolean success for stage transition"],"categories":["tool-use-integration","automation-workflow"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"hubspot-mcp-server__cap_3","uri":"capability://tool.use.integration.ticket.and.support.case.management","name":"ticket and support case management","description":"Provides MCP tools for creating, updating, and retrieving support tickets with status tracking, priority assignment, and assignment to support agents. Implements ticket lifecycle management including status transitions (new → open → waiting on customer → resolved → closed) and integrates with HubSpot's service hub to track customer support interactions and SLA compliance.","intents":["I need my agent to create support tickets from customer inquiries or emails","I want to update ticket status and priority based on customer interactions","I need to assign tickets to available support agents based on workload or expertise","I want to retrieve ticket history and resolution time metrics for support analytics"],"best_for":["Customer support teams automating ticket triage and routing","AI agents handling first-line support and ticket creation","Support operations teams tracking SLA compliance and agent performance"],"limitations":["No built-in intelligent routing; assignment logic must be implemented by agent","SLA tracking read-only; SLA policies must be configured in HubSpot","No support for ticket templates or canned responses","Ticket merging not supported through API"],"requires":["HubSpot API key with tickets scope","Valid ticket status values matching HubSpot configuration","Support agent IDs for assignment operations"],"input_types":["Ticket subject and description","Contact ID or email for ticket association","Priority level (low, medium, high, urgent)","Ticket status (new, open, waiting_on_customer, resolved, closed)"],"output_types":["Ticket object with ID, status, priority, and metadata","Ticket history and activity timeline","SLA status and remaining time","Array of tickets matching filter criteria"],"categories":["tool-use-integration","automation-workflow"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"hubspot-mcp-server__cap_4","uri":"capability://tool.use.integration.email.campaign.and.marketing.automation.execution","name":"email campaign and marketing automation execution","description":"Exposes HubSpot's marketing email and workflow automation capabilities through MCP tools, enabling agents to trigger email sequences, enroll contacts in workflows, and retrieve campaign performance metrics. Implements workflow state management and email personalization by integrating with HubSpot's contact property system to dynamically populate email variables and conditional logic.","intents":["I need my agent to enroll contacts in marketing workflows based on behavior or attributes","I want to trigger email sequences to leads or customers at the right time","I need to retrieve email open rates, click rates, and conversion metrics for campaign analysis","I want to send personalized emails with dynamic content based on contact properties"],"best_for":["Marketing automation specialists building AI-driven campaign workflows","Growth teams automating lead nurturing sequences","Developers building AI agents that need to execute marketing actions"],"limitations":["Email templates must be pre-created in HubSpot; dynamic template creation not supported","Workflow enrollment is asynchronous; agents cannot immediately verify enrollment","Email personalization limited to contact properties; no computed/derived fields","Campaign analytics have 24-hour delay due to HubSpot's reporting lag"],"requires":["HubSpot API key with marketing scope","Pre-created email templates and workflows in HubSpot","Contact IDs or email addresses for enrollment"],"input_types":["Workflow ID for enrollment","Contact ID or email address","Email template ID","Contact properties for personalization"],"output_types":["Enrollment confirmation with workflow instance ID","Email campaign metrics (opens, clicks, conversions, unsubscribes)","Contact engagement history","Boolean success for workflow enrollment"],"categories":["tool-use-integration","automation-workflow"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"hubspot-mcp-server__cap_5","uri":"capability://tool.use.integration.contact.property.schema.introspection.and.validation","name":"contact property schema introspection and validation","description":"Provides MCP tools to query HubSpot's contact property schema, including property names, types, validation rules, and custom properties. Enables agents to dynamically discover available properties and validate property values before attempting updates, preventing API errors from invalid property assignments and enabling self-correcting agent behavior.","intents":["I need to discover what contact properties are available in my HubSpot instance","I want to validate property values before updating contacts to avoid API errors","I need to understand property types and constraints (required, read-only, enum values)","I want my agent to handle custom properties without hardcoding property names"],"best_for":["Developers building flexible AI agents that adapt to custom HubSpot configurations","Teams with complex custom property schemas that change frequently","Multi-tenant systems that need to support different HubSpot configurations per customer"],"limitations":["Schema introspection adds latency; caching recommended for repeated queries","Property descriptions are user-defined; no standardized documentation","No support for computed properties or formula fields","Custom property creation not supported through API"],"requires":["HubSpot API key with properties scope","MCP client with caching support for performance"],"input_types":["Property name (optional filter)","Property type filter (string, number, date, enum)"],"output_types":["Property schema object with name, type, required, readOnly, enumValues","Array of all available properties","Validation error messages for invalid property values"],"categories":["tool-use-integration","memory-knowledge"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"hubspot-mcp-server__cap_6","uri":"capability://tool.use.integration.batch.contact.and.company.operations.with.error.handling","name":"batch contact and company operations with error handling","description":"Provides MCP tools for batch operations on contacts and companies (create, update, delete multiple records in single requests), with granular error handling that reports per-record success/failure. Implements request batching to respect HubSpot API rate limits while maximizing throughput, and provides detailed error messages for failed records to enable agent retry logic.","intents":["I need to import or sync large contact lists from external sources","I want to bulk update contact properties (e.g., lifecycle stage) based on agent decisions","I need to handle partial failures gracefully when batch operations encounter errors","I want to maximize API efficiency by batching multiple operations"],"best_for":["Data integration teams syncing external data sources with HubSpot","Bulk data migration and cleanup operations","AI agents performing large-scale contact enrichment or segmentation"],"limitations":["Batch size limited to 100 records per request (HubSpot API constraint)","No transactional guarantees; partial batch failures are possible","Duplicate detection based on email only; no custom deduplication logic","Batch operations are asynchronous; agents cannot immediately verify completion"],"requires":["HubSpot API key with contacts/companies scope","Batch size <= 100 records per request","Valid property values for all records"],"input_types":["Array of contact/company objects with properties","Batch operation type (create, update, upsert)","Deduplication strategy (email, custom field)"],"output_types":["Batch operation result with per-record success/failure status","Array of created/updated record IDs","Detailed error messages for failed records","Summary statistics (total, succeeded, failed)"],"categories":["tool-use-integration","data-processing-analysis"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"hubspot-mcp-server__cap_7","uri":"capability://tool.use.integration.contact.activity.and.engagement.timeline.retrieval","name":"contact activity and engagement timeline retrieval","description":"Provides MCP tools to retrieve contact activity history including emails sent/received, meetings, calls, form submissions, and website visits. Implements timeline aggregation across multiple HubSpot modules (email, meetings, forms, tracking) to provide agents with a unified view of customer engagement without requiring separate API calls per activity type.","intents":["I need to understand a contact's engagement history before my agent makes outreach decisions","I want to retrieve recent activities to inform lead scoring or qualification","I need to identify the most effective communication channels for a contact","I want to track customer interactions across email, calls, and meetings"],"best_for":["Sales agents building context-aware outreach strategies","Lead scoring systems that incorporate engagement signals","Customer success teams analyzing account health and engagement trends"],"limitations":["Activity history limited to last 90 days by default; older data requires custom queries","Website tracking requires HubSpot tracking code; not available for all contacts","Activity timestamps are UTC; timezone conversion required for agent reasoning","No real-time activity streaming; agents see eventual-consistent view"],"requires":["HubSpot API key with contacts and CRM scope","Contact ID for activity retrieval","HubSpot tracking code installed for website activity"],"input_types":["Contact ID","Activity type filter (email, meeting, call, form, page_view)","Date range for activity retrieval"],"output_types":["Activity timeline with chronologically ordered events","Activity object with type, timestamp, metadata (sender, subject, duration)","Engagement summary (total emails, meetings, form submissions)","Most recent activity timestamp"],"categories":["tool-use-integration","memory-knowledge"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"hubspot-mcp-server__cap_8","uri":"capability://tool.use.integration.list.membership.and.segmentation.management","name":"list membership and segmentation management","description":"Provides MCP tools to manage contact list membership, including adding/removing contacts from static lists and querying list membership. Implements list-based segmentation that allows agents to organize contacts by criteria and trigger list-based workflows, integrating with HubSpot's list system for audience management and campaign targeting.","intents":["I need to add qualified leads to specific lists for targeted campaigns","I want to remove contacts from lists based on agent decisions (e.g., unqualified, churned)","I need to query list membership to understand audience composition","I want to use lists as entry points for marketing workflows and automation"],"best_for":["Marketing teams managing audience segments and campaign targeting","AI agents performing contact segmentation and list management","Developers building audience-based automation workflows"],"limitations":["Only static lists supported; dynamic lists require HubSpot UI configuration","List membership changes are asynchronous; immediate verification not available","No support for list hierarchies or nested lists","List size limits apply (max 65,000 contacts per list)"],"requires":["HubSpot API key with lists scope","List IDs for membership operations","Contact IDs for add/remove operations"],"input_types":["List ID","Contact ID or array of contact IDs","Operation type (add, remove, clear)"],"output_types":["List membership confirmation","Array of contacts in list","List metadata (name, size, created date)","Boolean success for membership operations"],"categories":["tool-use-integration","automation-workflow"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"hubspot-mcp-server__cap_9","uri":"capability://tool.use.integration.mcp.tool.schema.registration.and.capability.discovery","name":"mcp tool schema registration and capability discovery","description":"Implements MCP server protocol to expose HubSpot capabilities as standardized MCP tools with JSON schema definitions, enabling MCP clients (Claude Desktop, Cline, etc.) to discover and invoke HubSpot operations. Uses MCP's tool registry pattern to dynamically expose HubSpot API operations as callable tools with input/output schemas, enabling seamless integration with AI agents that support the MCP protocol.","intents":["I need my MCP client to discover available HubSpot operations without manual configuration","I want to invoke HubSpot tools from Claude or other MCP-compatible AI agents","I need standardized tool schemas for HubSpot operations to enable agent reasoning","I want to integrate HubSpot with my existing MCP-based AI workflows"],"best_for":["Developers building MCP-based AI agent systems","Teams using Claude Desktop or Cline with HubSpot integration","Organizations standardizing on MCP for tool integration"],"limitations":["MCP protocol overhead adds ~50-100ms per tool invocation vs direct API calls","Tool schema complexity limited by MCP's JSON schema support","No built-in rate limiting; agents must implement their own throttling","Requires MCP-compatible client; not compatible with non-MCP AI platforms"],"requires":["MCP client implementation (Claude Desktop, Cline, or compatible)","HubSpot API key","Network connectivity to MCP server"],"input_types":["MCP tool invocation with JSON parameters","Tool name and argument schema"],"output_types":["MCP tool result with JSON response","Tool schema definitions for client discovery","Error responses with detailed error messages"],"categories":["tool-use-integration","automation-workflow"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"hubspot-mcp-server__headline","uri":"capability://tool.use.integration.hubspot.mcp.server.for.crm.and.marketing.management","name":"hubspot mcp server for crm and marketing management","description":"The HubSpot MCP Server is an official tool designed for managing CRM and marketing tasks, providing seamless access to contacts, deals, and marketing emails via the HubSpot API.","intents":["best HubSpot MCP server","MCP server for CRM management","HubSpot tools for marketing automation","CRM integration with HubSpot API","best tools for managing marketing emails"],"best_for":["CRM management","marketing automation"],"limitations":[],"requires":[],"input_types":[],"output_types":[],"categories":["tool-use-integration"],"confidence":0.5,"matches":0,"success_rate":0}],"trust":{"score":63,"verified":false,"data_access_risk":"high","permissions":["HubSpot API key with contacts scope","MCP client implementation (Claude Desktop, Cline, or compatible)","Network connectivity to HubSpot API endpoints","HubSpot API key with companies and associations scopes","Company IDs or domain names for lookup","MCP client with support for multi-step tool chains","HubSpot API key with deals scope","Pipeline ID for the target pipeline","Valid stage names matching HubSpot pipeline configuration","HubSpot API key with tickets scope"],"failure_modes":["Batch operations limited by HubSpot API rate limits (10 requests/second for standard tier)","No built-in conflict resolution for concurrent contact updates from multiple agents","Property schema must be pre-defined in HubSpot; dynamic property creation not supported","Soft-delete operations not exposed; deletion is permanent","Association queries return only direct relationships; transitive queries (e.g., contacts of subsidiaries) require multiple API calls","Company hierarchy depth limited by API response size; very large organizations may require pagination","No real-time change notifications; agents see eventual-consistent view of company data","Stage transitions validated against pipeline configuration; custom pipelines require pre-configuration in HubSpot","No built-in conflict resolution for concurrent deal updates (last-write-wins)","Deal probability not automatically calculated; must be set explicitly by agent or user","builder identity is not verified yet","no observed match outcomes yet"],"rank_breakdown":{"adoption":0.7,"quality":0.9,"ecosystem":0.52,"match_graph":0.25,"freshness":0.75,"weights":{"adoption":0.25,"quality":0.25,"ecosystem":0.15,"match_graph":0.23,"freshness":0.12}},"observed_outcomes":{"matches":0,"success_rate":0,"avg_confidence":0,"top_intents":[],"last_matched_at":null},"maintenance":{"status":"active","updated_at":"2026-06-17T09:51:04.692Z","last_scraped_at":null,"last_commit":null},"community":{"stars":null,"forks":null,"weekly_downloads":null,"model_downloads":null,"model_likes":null}},"distribution":{"claim_url":"https://unfragile.ai/submit?claim=hubspot-mcp-server","compare_url":"https://unfragile.ai/compare?artifact=hubspot-mcp-server"}},"signature":"ssfwSOGShuskBR1hK+ZDuHV/uDSG1KwrL74YZbELx3o4IPVeykMHWTGsAFHNpSu3zT73+goLWrgt1IdDeekTCQ==","signedAt":"2026-06-21T18:49:26.494Z","signedBy":"unfragile.ai","version":1},"_links":{"self":"https://unfragile.ai/api/v1/passport/hubspot-mcp-server","artifact":"https://unfragile.ai/hubspot-mcp-server","verify":"https://unfragile.ai/api/v1/verify?slug=hubspot-mcp-server","publicKey":"https://unfragile.ai/api/v1/trust-passport-public-key","spec":"https://unfragile.ai/trust","schema":"https://unfragile.ai/schema.json","docs":"https://unfragile.ai/docs"}}