Canny

Deletes a changelog entry.

Deletes a group, its sub-groups, and views scoped to those groups. Ideas in those groups are kept and ungrouped by default; pass `moveIdeasToGroupID` to move them to another group instead. Set `preserveIdeas` to false to delete the contained ideas too. Use `list_groups` to find valid group IDs.

Deletes an idea. The idea, along with all of its descendants, insights, and related data will be deleted. Use the `list_ideas` tool to discover valid idea IDs.

Deletes an insight.

Deletes a portal comment and its replies. Discover valid IDs via the `list_portal_comments` tool. These are portal comments, distinct from the idea comments managed by the `list_comments` tool.

Deletes a view. Default views and the last remaining view in a group cannot be deleted.

Links a Salesforce opportunity or HubSpot deal to an idea. Provide exactly one of `salesforceOpportunityID` or `hubspotDealID`. To also capture customer feedback, call the `create_insight` tool separately.

Read-only: Returns all admin teammates, including each admin name so callers can identify users. By default, admin IDs are omitted. To include IDs for use with other tools (for example, `author` or `owner` filters in `list_ideas`), pass `include: ["ids"]`. This tool is not idempotent: underlying data can change between calls, so avoid relying on cached results during longer conversations.

Read-only: Returns categories that belong to the provided board. Categories may be nested via `parentID`.

Read-only: Returns tags that belong to the provided board sorted by newest first.

Read-only: Returns all boards. This tool is not idempotent: underlying data can change between calls, so avoid relying on cached results during longer conversations.

Read-only: Returns changelog entries, filtered and sorted by the given parameters.

Read-only: Returns all changelog labels. Labels are used to categorize changelog entries.

Read-only: Returns comments for a specific idea. Mentions in comment text are converted to readable plaintext names. By default, user-related identifiers are omitted. Pass `include: ["users"]` to include them.

Read-only: Returns a list of all companies associated with your company, ordered by created date, optionally filtered by search query or scoped to a segment.

Read-only: Returns all groups used to organize ideas. Groups are organizational units that group ideas together. Each idea belongs to one or no group. Groups can be nested to create a hierarchy of groups. This tool is not idempotent: underlying data can change between calls, so avoid relying on cached results during longer conversations.

Read-only: Returns all fields that can be used when filtering ideas, including default fields and company-specific custom, score, and formula fields. Each field includes its ID, type, label, whether it has predefined options, and whether it is a default or custom field. For default fields with predefined options, use `list_groups` for the `group` field, `list_idea_statuses` for the `status` field, and `list_idea_themes` for the `themes` field to discover valid option IDs. Use this together with `list_idea_filtering_operations` when constructing the `filtering` parameter for `list_ideas`. This tool is not idempotent: underlying data can change between calls, so avoid relying on cached results during longer conversations.

Read-only: Returns all the filtering options that can be used in idea filters, including the input type they expect and which idea field types they apply to. Use this together with `list_idea_fields` to construct valid `filtering.filters` entries for the `list_ideas` tool. This tool is not idempotent: underlying data can change between calls, so avoid relying on cached results during longer conversations.

Read-only: Returns a paginated list of opportunities linked to an idea. An opportunity represents a potential customer, synced in from Salesforce or Hubspot. Opportunities linked to descendant ideas are included and deduplicated. To link or unlink opportunities, use the `link_opportunity` and `unlink_opportunity` tools respectively.

Read-only: Returns all idea statuses. Use this to filter ideas by status when calling the `list_ideas` tool. This tool is not idempotent: underlying data can change between calls, so avoid relying on cached results during longer conversations.

Read-only: Returns all idea themes. Themes are used to categorize ideas into more general topics. Each idea can be assigned to one or no theme. Use these to filter ideas by theme when calling the `list_ideas` tool. This tool is not idempotent: underlying data can change between calls, so avoid relying on cached results during longer conversations.

Read-only: Returns a list of ideas, filtered and sorted by the given parameters. Use the `list_idea_fields` and `list_idea_filtering_operations` tools to discover which fields you can filter and sort by using this tool. By default, user-related identifiers are omitted, and user-typed fields (default and custom) are excluded from `fields`. Pass `include: ["users"]` to include user-related identifiers and user-typed fields. Pass `segmentID` to scope segmentable metrics to a company segment. Note this tool lists *Canny Ideas*, not to be confused with *Canny Posts*. This tool is not idempotent: underlying data can change between calls, so avoid relying on cached results during longer conversations. If you already know the idea ID or urlName (for example, parsed from a Canny URL), prefer the `retrieve_idea` tool — it is faster and more accurate than searching with this tool.

Read-only: Returns a paginated list of insights linked to a specific idea, including priority, source, and linked comment/vote IDs. By default, user-related identifiers are omitted — pass `include: ["users"]` to include them.

Read-only: Returns a paginated list of comments left on the portal. By default, it returns portal comments across all published ideas in the company. Mentions in comment text are converted to readable plaintext names. By default, user-related identifiers are omitted. Pass `include: ["users"]` to include them. These are portal comments, distinct from the idea comments returned by the `list_comments` tool.

Read-only: Returns all portal statuses (the public-facing statuses shown on the portal/roadmap). Use this to discover valid values for the `portalStatusID` or `portalStatusName` parameters of `update_portal_status`.

Read-only: Returns the end-users who voted on a specific idea, each with the vote's priority, the voter's company, and when they voted. By default, user identifiers and emails are omitted — pass `include: ["emails"]` for each voter's email and `include: ["ids"]` for their user ID.

Read-only: Returns all fields that can be used to define user segments, including both standard and custom fields. Each field includes its ID, source (`standard` or `custom`), fieldType (`boolean`, `number`, `date`, or `string`), objectType (`company` or `user`), and human-readable name. Use this before creating or updating segments to understand available attributes. This tool is not idempotent: underlying data can change between calls, so avoid relying on cached results during longer conversations.

Read-only: Returns all operations that can be applied to segment attributes, with a short human-readable description of each. Use this to understand how to define attribute filters when creating or editing segments. This tool is not idempotent: underlying data can change between calls, so avoid relying on cached results during longer conversations.

Read-only: Returns all user segments, ordered by name. Use this to understand how users are segmented. Attribute `id`s are field identifiers: use the `list_segment_fields` tool to resolve them to human-readable fields and `list_segment_operations` to interpret each `op`. This tool is not idempotent: underlying data can change between calls, so avoid relying on cached results during longer conversations.

Read-only: Returns end-users in this workspace, optionally filtered by name or email. To fetch a specific set of users by their IDs, use `retrieve_users` instead.

Read-only: Returns saved idea views, including their filters, grouping, and sort configuration. Use this to discover view IDs and settings you can reference when calling the `list_ideas` tool (for example via the `viewID` parameter) or when constructing custom filters. This tool is not idempotent: underlying data can change between calls, so avoid relying on cached results during longer conversations.

Merges two ideas together. The source idea (fromIdeaID) will be merged into the target idea (intoIdeaID). All descendants, insights, and related data from the source idea will be moved to the target idea, and the source idea will be marked as deleted. Use the `list_ideas` tool to discover valid idea IDs.

Moves an idea to a different group and/or reparents it under another idea. At least one of `groupID` or `parentID` must be provided. A sub-idea must belong to the same group as its parent.

Moves an insight to a different idea. Insights linked to a vote or comment cannot be moved.

Removes a user's membership from the given company.

Read-only: Returns a single company looked up by its ID.

Read-only: Returns a single group looked up by its ID or its urlName. Groups are organizational units that group ideas together. Exactly one of `id` or `urlName` must be provided. Discover valid IDs via the `list_groups` tool.

Read-only: Returns a single idea looked up by its ID, by its urlName, or by a portal URL. Exactly one of `id`, `urlName`, or `portalURL` must be provided.

Read-only: Returns a single end-user looked up by `id` or `email`.

Read-only: Bulk-fetches end-users in this workspace by their IDs (max 50). Only IDs that resolve to a user in this workspace are returned; unknown IDs are silently skipped. Discover valid IDs via `list_users` with `include: ["ids"]`.