publicCRMJan 1, 20260 calls

HubSpot MCP Template

Curated MCP template for contacts, companies, deals, and sales workflows.

Hosted MCP endpoint

/api/mcp/preset-hubspot

Private servers require an Astrail API key in the Authorization header.

MCP client snippets

Claude Desktop config

{
  "mcpServers": {
    "hubspot-mcp-template": {
      "url": "/api/mcp/preset-hubspot"
    }
  }
}

cURL initialize

curl -sS -X POST "/api/mcp/preset-hubspot" \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

cURL tools/list

curl -sS -X POST "/api/mcp/preset-hubspot" \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

cURL tools/call

curl -sS -X POST "/api/mcp/preset-hubspot" \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"hubspot_search_contacts","arguments":{"query":"example"}}}'

Runtime behavior

Runtime healthneeds_mapping

Endpoint healthnot_checked

Execution modemapping_required

Deterministic executionNot yet executable

Generated sourceExport only

Endpoint mapRequired

Endpoint mappedNo

Auth-required endpointsNone detected

Browser runtime endpointsNone detected

Last statusnot recorded

Last execution modenot recorded

Last toolnot recorded

Last latencynot recorded

Upstream statusnot recorded

Trace IDnot recorded

Error codenone

Observabilitystructured fallback

Rate limit modestandard

Missing authauth_required

Missing mappingmapping_required

Astrail does not evaluate generated TypeScript inside Next.js. Hosted calls are routed through stored tool metadata and endpoint maps.

Tools

hubspot_search_contacts

Search HubSpot contacts by email, company, or lifecycle stage.

hubspot_create_contact

Create a HubSpot contact with structured fields.

hubspot_update_deal_stage

Move a deal to a new pipeline stage.

server.ts

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const server = new McpServer({ name: "HubSpot MCP Template", version: "1.0.0" });

// Curated Astrail template. Add the provider API token and replace the
// placeholder handlers with real fetch calls for: hubspot_search_contacts, hubspot_create_contact, hubspot_update_deal_stage.

server.tool("template_status", "Confirm this curated MCP template is installed.", z.object({}), async () => ({
  content: [{ type: "text", text: "Template installed. Add provider credentials to enable live API calls." }],
}));

const transport = new StdioServerTransport();
await server.connect(transport);