Knit MCP Server - Getting Started

curl --location --request GET 'https://api.getknit.dev/v1.0/tools.find' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {YOUR_API_KEY}' \
--data '{
    "filters": {
        "app_id": "hubspot",
        "usecase": "get leads"
    }
}'

{
  "success": true,
  "data": [
    {
      "tool_id": "hubspot__get_lead_details_by_id",
      "entities": [
        "lead",
        "association",
        "property"
      ],
      "operation": "read",
      "title": "Get Lead Details by ID",
      "description": "This API endpoint retrieves details of a lead identified by the {leadsId}. The {leadsId} can be the internal object ID or any unique property value specified by the idProperty query parameter. The API allows filtering of returned properties using the properties query parameter and can include property history with propertiesWithHistory. It also supports retrieving associated object IDs with the associations parameter and can filter archived results using the archived parameter. The response includes lead details such as associations, creation and update timestamps, properties, and archived status.",
      "is_unified_tool": false
    },
    {
      "tool_id": "hubspot__post_create_a_lead",
      "entities": [
        "lead",
        "association",
        "property"
      ],
      "operation": "write",
      "title": "Create a Lead",
      "description": "This API endpoint allows you to create a lead with specified properties and associations in HubSpot. The request requires an authorization header with a Bearer token and a content-type header set to application/json. The body of the request includes an array of associations and a properties object, which now includes 'hs_lead_name', 'hs_lead_type', and 'hs_lead_label'. The response returns a copy of the created lead object, including its ID, creation and update timestamps, and properties with history. If there is an error, a detailed error message is provided.",
      "is_unified_tool": false
    },
    // Additional tools omitted for brevity
  ]
}

curl --location --request GET 'https://api.getknit.dev/v1.0/tools.find' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {YOUR_API_KEY}' \
--data '{
    "filters": {
        "category_id": "CALENDAR",
        "include_unified_tools": true
    }
}'

{
  "success": true,
  "data": [
    {
      "tool_id": "unifiedcalendar__update-event",
      "entities": null,
      "operation": "write",
      "title": "Update Calendar Event",
      "description": "The Update Calendar Event API allows users to update an existing calendar event by providing the calendarId and eventId. Users can update details such as the event title, description, start and end times, attendees, and conferencing details. The API supports both all-day and recurring events. The response indicates whether the update was successful or provides an error message if it failed.",
      "is_unified_tool": true
    },
    {
      "tool_id": "unifiedcalendar__get-availability",
      "entities": null,
      "operation": "read",
      "title": "Retrieve Available Common Time Slots for Multiple Attendees",
      "description": "This API is used to retrieve available common time slots for multiple attendees within a specified time range. The request requires the start and end times in ISO 8601 UTC format, a list of attendee email addresses, and optionally the slot duration in minutes. The response includes a list of free time slots available for all attendees. Supported applications include Outlook Calendar and Google Calendar, with a restriction that the gap between start and end should be less than 62 days.",
      "is_unified_tool": true
    },
    {
      "tool_id": "unifiedcalendar__list-calendars",
      "entities": null,
      "operation": "read",
      "title": "List Calendars API",
      "description": "The List Calendars API retrieves all calendars associated with a user, including those they own and those shared with them. It supports apps like Outlook Calendar and Google Calendar. The API requires a 'pageSize' query parameter to control the size of results and an optional 'pageToken' to fetch additional records. The response includes details of each calendar such as id, name, description, timezone, owner information, colors, visibility, reminders, and more.",
      "is_unified_tool": true
    },
    // Additional tools omitted for brevity
  ]
}

curl --location --request POST 'https://api.getknit.dev/v1.0/tools.pkg.create' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {YOUR_API_KEY}' \
--data '{
    "name": "Sales test tools",
    "description": "Sales test tools",
    "tools": [
      "hubspot__get_lead_details_by_id",
      "hubspot__get_read_a_page_of_leads",
      "hubspot__get_read_a_page_of_tasks",
      "hubspot__post_read_batch_tasks",
      "hubspot__get_task_details_by_task_id",
      "hubspot__post_search_crm_tasks",
      "unifiedcalendar__list-events",
      "unifiedcalendar__delete-event",
      "unifiedcalendar__get-event",
      "unifiedcalendar__move-event",
      "unifiedcalendar__update-event",
      "unifiedcalendar__create-event",
      "unifiedcalendar__respond-event"
    ]
}'

{
  "success": true,
  "data": {
    "orgID": "o_bdVS8xxx3TzqG9xxxXyN9",
    "pkgID": "tp_l9oUkEqEBz7wcEswIJXGh2",
    "tools": [
      "unifiedcalendar__get-event",
      "unifiedcalendar__update-event",
      "hubspot__get_lead_details_by_id",
      "unifiedcalendar__create-event",
      "hubspot__get_task_details_by_task_id",
      "hubspot__get_read_a_page_of_tasks",
      "unifiedcalendar__move-event",
      "unifiedcalendar__delete-event",
      "hubspot__get_read_a_page_of_leads",
      "hubspot__post_search_crm_tasks",
      "unifiedcalendar__respond-event",
      "hubspot__post_read_batch_tasks",
      "unifiedcalendar__list-events"
    ],
    "name": "Sales test tools",
    "description": "Sales test tools",
    "apps": [
      "calendar",
      "hubspot"
    ],
    "updateAt": 1745660614190
  }
}

curl --location --request POST 'https://api.getknit.dev/v1.0/mcp.server.create' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {YOUR_API_KEY}' \
--data '{
  "pkgID": "tp_MixTYxbEsnll...",
  "integrationIDs": [
    {
      "appOrCategoryID": "hubspot",
      "integrationID": "mg_MneXkY6pGG..."
    },
    {
      "appOrCategoryID": "CALENDAR",
      "integrationID": "mg_clntx8ZENs..."
    }
  ]
}'

{
  "success": true,
  "data": {
    "mcpServerID": "dtp_irjiGaQFJbuWbodetB7MFz",
    "serverURL": "https://mcp.getknit.dev/sse"
  }
}

{
  "mcpServers": {
    "knit-mcp": {
      "command": "C:\\nvm4w\\nodejs\\node.exe",
      "args": [
        "C:\\nvm4w\\nodejs\\node_modules\\npm\\bin\\npx-cli.js",
        "-y",
        "mcp-remote",
        "https://mcp.getknit.dev/sse",
        "--header",
        "Authorization:Bearer {YOUR_API_KEY}.{KNIT_MCP_SERVER_ID}"
      ]
    }
  }
}