@commandable/integration-data 0.0.6 → 0.1.0

package/integrations/hubspot/manifest.json

@@ -0,0 +1,230 @@
+{
+  "name": "hubspot",
+  "version": "0.1.0",
+  "tools": [
+    {
+      "name": "search_contacts",
+      "description": "Search for contacts. Use query for simple free-text search, and filters for precise property-based filtering. Returns a compact list of matching contacts.",
+      "inputSchema": "schemas/search_contacts.json",
+      "handler": "handlers/search_contacts.js",
+      "scope": "read"
+    },
+    {
+      "name": "get_contact",
+      "description": "Get a contact by ID. Use properties to request specific fields, and associations to include linked object IDs (e.g. companies, deals, tickets).",
+      "inputSchema": "schemas/get_contact.json",
+      "handler": "handlers/get_contact.js",
+      "scope": "read"
+    },
+    {
+      "name": "create_contact",
+      "description": "Create a contact. Provide common fields (firstname/lastname/email) and/or a properties map for other HubSpot contact properties.",
+      "inputSchema": "schemas/create_contact.json",
+      "handler": "handlers/create_contact.js",
+      "scope": "write"
+    },
+    {
+      "name": "update_contact",
+      "description": "Update a contact by ID. Provide any fields to update as common fields and/or in the properties map. Fields not provided are unchanged.",
+      "inputSchema": "schemas/update_contact.json",
+      "handler": "handlers/update_contact.js",
+      "scope": "write"
+    },
+    {
+      "name": "archive_contact",
+      "description": "Archive (delete) a contact by ID. This moves the record to the recycle bin.",
+      "inputSchema": "schemas/archive_contact.json",
+      "handler": "handlers/archive_contact.js",
+      "scope": "write"
+    },
+
+    {
+      "name": "search_companies",
+      "description": "Search for companies. Use query for free-text search and filters for property-based filtering. Returns a compact list of matching companies.",
+      "inputSchema": "schemas/search_companies.json",
+      "handler": "handlers/search_companies.js",
+      "scope": "read"
+    },
+    {
+      "name": "get_company",
+      "description": "Get a company by ID. Use properties to request specific fields, and associations to include linked object IDs (e.g. contacts, deals, tickets).",
+      "inputSchema": "schemas/get_company.json",
+      "handler": "handlers/get_company.js",
+      "scope": "read"
+    },
+    {
+      "name": "create_company",
+      "description": "Create a company. Provide name/domain and/or a properties map for other HubSpot company properties.",
+      "inputSchema": "schemas/create_company.json",
+      "handler": "handlers/create_company.js",
+      "scope": "write"
+    },
+    {
+      "name": "update_company",
+      "description": "Update a company by ID. Provide any fields to update as common fields and/or in the properties map. Fields not provided are unchanged.",
+      "inputSchema": "schemas/update_company.json",
+      "handler": "handlers/update_company.js",
+      "scope": "write"
+    },
+    {
+      "name": "archive_company",
+      "description": "Archive (delete) a company by ID. This moves the record to the recycle bin.",
+      "inputSchema": "schemas/archive_company.json",
+      "handler": "handlers/archive_company.js",
+      "scope": "write"
+    },
+
+    {
+      "name": "list_owners",
+      "description": "List CRM owners (users) available in the HubSpot account. Useful for assigning owners to records via hubspot_owner_id.",
+      "inputSchema": "schemas/list_owners.json",
+      "handler": "handlers/list_owners.js",
+      "scope": "read"
+    },
+    {
+      "name": "list_properties",
+      "description": "List properties for an object type (e.g. contacts, companies, deals, tickets). Use this to discover valid property names for filtering and updates.",
+      "inputSchema": "schemas/list_properties.json",
+      "handler": "handlers/list_properties.js",
+      "scope": "read"
+    },
+    {
+      "name": "list_pipelines",
+      "description": "List pipelines and stages for an object type (commonly deals or tickets). Use this to find valid pipeline and stage IDs before creating/updating records.",
+      "inputSchema": "schemas/list_pipelines.json",
+      "handler": "handlers/list_pipelines.js",
+      "scope": "read"
+    },
+
+    {
+      "name": "get_associations",
+      "description": "Get associations from a CRM record to another object type. Returns the associated record IDs (paginated).",
+      "inputSchema": "schemas/get_associations.json",
+      "handler": "handlers/get_associations.js",
+      "scope": "read"
+    },
+    {
+      "name": "create_association",
+      "description": "Create a default (unlabeled) association between two CRM records. Example: associate a contact with a company or a deal with a contact.",
+      "inputSchema": "schemas/create_association.json",
+      "handler": "handlers/create_association.js",
+      "scope": "write"
+    },
+    {
+      "name": "remove_association",
+      "description": "Remove an association between two CRM records. This uses HubSpot's association batch archive endpoint under the hood.",
+      "inputSchema": "schemas/remove_association.json",
+      "handler": "handlers/remove_association.js",
+      "scope": "write"
+    },
+
+    {
+      "name": "search_deals",
+      "description": "Search for deals. Use query for free-text search and filters for property-based filtering (e.g. pipeline, dealstage, amount).",
+      "inputSchema": "schemas/search_deals.json",
+      "handler": "handlers/search_deals.js",
+      "scope": "read"
+    },
+    {
+      "name": "get_deal",
+      "description": "Get a deal by ID. Use properties to request specific fields, and associations to include linked object IDs.",
+      "inputSchema": "schemas/get_deal.json",
+      "handler": "handlers/get_deal.js",
+      "scope": "read"
+    },
+    {
+      "name": "create_deal",
+      "description": "Create a deal. Provide dealname/amount/pipeline/dealstage and/or a properties map for other HubSpot deal properties.",
+      "inputSchema": "schemas/create_deal.json",
+      "handler": "handlers/create_deal.js",
+      "scope": "write"
+    },
+    {
+      "name": "update_deal",
+      "description": "Update a deal by ID. Common updates include moving stages via dealstage. Fields not provided are unchanged.",
+      "inputSchema": "schemas/update_deal.json",
+      "handler": "handlers/update_deal.js",
+      "scope": "write"
+    },
+    {
+      "name": "archive_deal",
+      "description": "Archive (delete) a deal by ID. This moves the record to the recycle bin.",
+      "inputSchema": "schemas/archive_deal.json",
+      "handler": "handlers/archive_deal.js",
+      "scope": "write"
+    },
+
+    {
+      "name": "search_tickets",
+      "description": "Search for tickets. Use query for free-text search and filters for property-based filtering (e.g. hs_pipeline, hs_pipeline_stage, priority).",
+      "inputSchema": "schemas/search_tickets.json",
+      "handler": "handlers/search_tickets.js",
+      "scope": "read"
+    },
+    {
+      "name": "get_ticket",
+      "description": "Get a ticket by ID. Use properties to request specific fields, and associations to include linked object IDs.",
+      "inputSchema": "schemas/get_ticket.json",
+      "handler": "handlers/get_ticket.js",
+      "scope": "read"
+    },
+    {
+      "name": "create_ticket",
+      "description": "Create a ticket. Provide subject/content/pipeline/stage and/or a properties map for other HubSpot ticket properties.",
+      "inputSchema": "schemas/create_ticket.json",
+      "handler": "handlers/create_ticket.js",
+      "scope": "write"
+    },
+    {
+      "name": "update_ticket",
+      "description": "Update a ticket by ID. Common updates include changing hs_pipeline_stage. Fields not provided are unchanged.",
+      "inputSchema": "schemas/update_ticket.json",
+      "handler": "handlers/update_ticket.js",
+      "scope": "write"
+    },
+    {
+      "name": "archive_ticket",
+      "description": "Archive (delete) a ticket by ID. This moves the record to the recycle bin.",
+      "inputSchema": "schemas/archive_ticket.json",
+      "handler": "handlers/archive_ticket.js",
+      "scope": "write"
+    },
+
+    {
+      "name": "search_notes",
+      "description": "Search notes. Use query for free-text search and filters for precise property-based filtering.",
+      "inputSchema": "schemas/search_notes.json",
+      "handler": "handlers/search_notes.js",
+      "scope": "read"
+    },
+    {
+      "name": "create_note",
+      "description": "Create a note and (optionally) associate it to one or more CRM records (contacts, companies, deals, tickets). Provide body text; the handler sets hs_note_body and hs_timestamp automatically unless overridden.",
+      "inputSchema": "schemas/create_note.json",
+      "handler": "handlers/create_note.js",
+      "scope": "write"
+    },
+    {
+      "name": "search_tasks",
+      "description": "Search tasks. Use query for free-text search and filters for precise property-based filtering.",
+      "inputSchema": "schemas/search_tasks.json",
+      "handler": "handlers/search_tasks.js",
+      "scope": "read"
+    },
+    {
+      "name": "create_task",
+      "description": "Create a task and (optionally) associate it to one or more CRM records. Provide subject/body/status/priority and a due timestamp; the handler maps these to HubSpot task properties.",
+      "inputSchema": "schemas/create_task.json",
+      "handler": "handlers/create_task.js",
+      "scope": "write"
+    },
+    {
+      "name": "update_task",
+      "description": "Update a task by ID. Common updates include setting hs_task_status to COMPLETED.",
+      "inputSchema": "schemas/update_task.json",
+      "handler": "handlers/update_task.js",
+      "scope": "write"
+    }
+  ]
+}
+

package/integrations/hubspot/prompt.md

@@ -0,0 +1,69 @@
+## HubSpot guidance
+
+This integration uses HubSpot CRM v3 object endpoints and CRM v4 association endpoints.
+
+- Prefer `search_*` tools for discovery (they support free-text `query` and structured `filters`).
+- Use `get_*` tools when you already have an object ID and want full details / associations.
+
+### Search filters
+
+All `search_*` tools accept:
+
+- `query`: free-text search (optional)
+- `filters`: property-based filtering. Each filter is `{ propertyName, operator, value? }`.
+
+Common operators:
+
+- `EQ`, `NEQ`
+- `LT`, `LTE`, `GT`, `GTE` (numbers or millisecond timestamps)
+- `CONTAINS_TOKEN` (tokenized contains)
+- `HAS_PROPERTY`, `NOT_HAS_PROPERTY` (value ignored)
+- `BETWEEN` (pass `value` as a string `"low,high"`; timestamps in ms recommended)
+
+### Common property names (quick reference)
+
+Contacts:
+- `firstname`, `lastname`, `email`
+
+Companies:
+- `name`, `domain`
+
+Deals:
+- `dealname`, `amount`, `pipeline`, `dealstage`, `closedate`
+
+Tickets:
+- `subject`, `content`, `hs_pipeline`, `hs_pipeline_stage`
+
+### Pipelines and stages (deals/tickets)
+
+Pipelines and stages are stored as IDs (not human-friendly names). Recommended workflow:
+
+1. Call `list_pipelines` with `objectType: "deals"` or `objectType: "tickets"`.
+2. Pick a pipeline ID and stage ID from the response.
+3. Use those IDs when calling `create_deal` / `update_deal` (via `pipeline` / `dealstage`) or `create_ticket` / `update_ticket` (via `hs_pipeline` / `hs_pipeline_stage`).
+
+### Associations
+
+- Use `get_associations` to list linked records (returns associated IDs).
+- Use `create_association` to link two records (default/unlabeled association).
+- Use `remove_association` to unlink records.
+
+### Engagement objects
+
+Notes:
+- Content: `hs_note_body`
+- Timestamp: `hs_timestamp` (milliseconds)
+
+Tasks:
+- Subject: `hs_task_subject`
+- Body: `hs_task_body`
+- Status: `hs_task_status` (`NOT_STARTED` or `COMPLETED`)
+- Priority: `hs_task_priority` (`LOW`, `MEDIUM`, `HIGH`)
+- Due timestamp: `hs_timestamp` (milliseconds)
+
+The `create_note` and `create_task` tools can also associate the engagement to CRM records in the same call.
+
+### Pagination
+
+HubSpot uses cursor-based pagination. When a response includes `paging.next.after`, pass that value back as `after` in your next call.
+

package/integrations/hubspot/schemas/archive_company.json

@@ -0,0 +1,13 @@
+{
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "title": "Company ID",
+      "description": "HubSpot company object ID."
+    }
+  },
+  "required": ["id"],
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/archive_contact.json

@@ -0,0 +1,13 @@
+{
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "title": "Contact ID",
+      "description": "HubSpot contact object ID."
+    }
+  },
+  "required": ["id"],
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/archive_deal.json

@@ -0,0 +1,9 @@
+{
+  "type": "object",
+  "properties": {
+    "id": { "type": "string", "description": "HubSpot deal object ID." }
+  },
+  "required": ["id"],
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/archive_ticket.json

@@ -0,0 +1,9 @@
+{
+  "type": "object",
+  "properties": {
+    "id": { "type": "string", "description": "HubSpot ticket object ID." }
+  },
+  "required": ["id"],
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/create_association.json

@@ -0,0 +1,24 @@
+{
+  "type": "object",
+  "properties": {
+    "fromObjectType": {
+      "type": "string",
+      "description": "Object type of the source record (e.g. contacts, companies, deals, tickets)."
+    },
+    "fromObjectId": {
+      "type": "string",
+      "description": "Object ID of the source record."
+    },
+    "toObjectType": {
+      "type": "string",
+      "description": "Object type of the target record."
+    },
+    "toObjectId": {
+      "type": "string",
+      "description": "Object ID of the target record."
+    }
+  },
+  "required": ["fromObjectType", "fromObjectId", "toObjectType", "toObjectId"],
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/create_company.json

@@ -0,0 +1,14 @@
+{
+  "type": "object",
+  "properties": {
+    "name": { "type": "string" },
+    "domain": { "type": "string" },
+    "properties": {
+      "type": "object",
+      "description": "Additional HubSpot company properties to set (propertyName -> value).",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/create_contact.json

@@ -0,0 +1,15 @@
+{
+  "type": "object",
+  "properties": {
+    "firstname": { "type": "string" },
+    "lastname": { "type": "string" },
+    "email": { "type": "string" },
+    "properties": {
+      "type": "object",
+      "description": "Additional HubSpot contact properties to set (propertyName -> value).",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/create_deal.json

@@ -0,0 +1,20 @@
+{
+  "type": "object",
+  "properties": {
+    "dealname": { "type": "string", "description": "Deal name (maps to dealname property)." },
+    "amount": { "type": ["string", "number"], "description": "Deal amount (maps to amount property)." },
+    "pipeline": { "type": "string", "description": "Pipeline ID (maps to pipeline property)." },
+    "dealstage": { "type": "string", "description": "Deal stage ID (maps to dealstage property)." },
+    "closedate": {
+      "type": ["string", "number"],
+      "description": "Close date. Prefer Unix timestamp in milliseconds (maps to closedate property)."
+    },
+    "properties": {
+      "type": "object",
+      "description": "Additional HubSpot deal properties to set (propertyName -> value).",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/create_note.json

@@ -0,0 +1,37 @@
+{
+  "type": "object",
+  "properties": {
+    "body": {
+      "type": "string",
+      "description": "Note text content. The handler maps this to hs_note_body."
+    },
+    "timestamp": {
+      "type": ["string", "number"],
+      "description": "Timestamp for hs_timestamp. Prefer Unix timestamp in milliseconds. If omitted, current time is used."
+    },
+    "hubspot_owner_id": {
+      "type": ["string", "number"],
+      "description": "Optional owner ID to attribute the note to."
+    },
+    "associateWith": {
+      "type": "array",
+      "description": "CRM records to associate this note with.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "objectType": { "type": "string", "description": "e.g. contacts, companies, deals, tickets" },
+          "objectId": { "type": "string", "description": "HubSpot object ID" }
+        },
+        "required": ["objectType", "objectId"],
+        "additionalProperties": false
+      }
+    },
+    "properties": {
+      "type": "object",
+      "description": "Advanced: raw HubSpot note properties to set/override (propertyName -> value).",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/create_task.json

@@ -0,0 +1,51 @@
+{
+  "type": "object",
+  "properties": {
+    "subject": {
+      "type": "string",
+      "description": "Task subject/title (maps to hs_task_subject)."
+    },
+    "body": {
+      "type": "string",
+      "description": "Task body/notes (maps to hs_task_body)."
+    },
+    "status": {
+      "type": "string",
+      "enum": ["NOT_STARTED", "COMPLETED"],
+      "description": "Task status (maps to hs_task_status)."
+    },
+    "priority": {
+      "type": "string",
+      "enum": ["LOW", "MEDIUM", "HIGH"],
+      "description": "Task priority (maps to hs_task_priority)."
+    },
+    "dueTimestamp": {
+      "type": ["string", "number"],
+      "description": "Due date/time timestamp for the task. HubSpot tasks use hs_timestamp for due date. Prefer Unix timestamp in milliseconds."
+    },
+    "hubspot_owner_id": {
+      "type": ["string", "number"],
+      "description": "Optional owner ID to assign the task to."
+    },
+    "associateWith": {
+      "type": "array",
+      "description": "CRM records to associate this task with.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "objectType": { "type": "string", "description": "e.g. contacts, companies, deals, tickets" },
+          "objectId": { "type": "string", "description": "HubSpot object ID" }
+        },
+        "required": ["objectType", "objectId"],
+        "additionalProperties": false
+      }
+    },
+    "properties": {
+      "type": "object",
+      "description": "Advanced: raw HubSpot task properties to set/override (propertyName -> value).",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/create_ticket.json

@@ -0,0 +1,16 @@
+{
+  "type": "object",
+  "properties": {
+    "subject": { "type": "string", "description": "Ticket subject (maps to subject property)." },
+    "content": { "type": "string", "description": "Ticket content/body (maps to content property)." },
+    "hs_pipeline": { "type": "string", "description": "Pipeline ID (maps to hs_pipeline property)." },
+    "hs_pipeline_stage": { "type": "string", "description": "Pipeline stage ID (maps to hs_pipeline_stage property)." },
+    "properties": {
+      "type": "object",
+      "description": "Additional HubSpot ticket properties to set (propertyName -> value).",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/empty.json

@@ -0,0 +1,6 @@
+{
+  "type": "object",
+  "properties": {},
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/get_associations.json

@@ -0,0 +1,30 @@
+{
+  "type": "object",
+  "properties": {
+    "fromObjectType": {
+      "type": "string",
+      "description": "Object type of the source record (e.g. contacts, companies, deals, tickets)."
+    },
+    "fromObjectId": {
+      "type": "string",
+      "description": "Object ID of the source record."
+    },
+    "toObjectType": {
+      "type": "string",
+      "description": "Object type of the associated records to list (e.g. companies, contacts, deals, tickets, notes, tasks)."
+    },
+    "after": {
+      "type": "string",
+      "description": "Paging cursor token."
+    },
+    "limit": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 500,
+      "description": "Max results per page."
+    }
+  },
+  "required": ["fromObjectType", "fromObjectId", "toObjectType"],
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/get_company.json

@@ -0,0 +1,27 @@
+{
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "title": "Company ID",
+      "description": "HubSpot company object ID."
+    },
+    "properties": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Specific property names to return (e.g. name, domain, industry)."
+    },
+    "associations": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Associated object types to include (e.g. contacts, deals, tickets)."
+    },
+    "archived": {
+      "type": "boolean",
+      "description": "Whether to return archived records."
+    }
+  },
+  "required": ["id"],
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/get_contact.json

@@ -0,0 +1,27 @@
+{
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "title": "Contact ID",
+      "description": "HubSpot contact object ID."
+    },
+    "properties": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Specific property names to return (e.g. firstname, lastname, email, phone)."
+    },
+    "associations": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Associated object types to include (e.g. companies, deals, tickets)."
+    },
+    "archived": {
+      "type": "boolean",
+      "description": "Whether to return archived records."
+    }
+  },
+  "required": ["id"],
+  "additionalProperties": false
+}
+

package/integrations/hubspot/schemas/get_deal.json

@@ -0,0 +1,20 @@
+{
+  "type": "object",
+  "properties": {
+    "id": { "type": "string", "description": "HubSpot deal object ID." },
+    "properties": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Specific property names to return (e.g. dealname, amount, pipeline, dealstage, closedate)."
+    },
+    "associations": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Associated object types to include (e.g. contacts, companies, tickets)."
+    },
+    "archived": { "type": "boolean" }
+  },
+  "required": ["id"],
+  "additionalProperties": false
+}
+