Aha! MCP server

Overview

Use this MCP server to search and retrieve data from your Aha! product-management workspace. Your AI agent can search epics, features, and ideas by status, tag, assignee, or date, giving you instant visibility into what is in progress, what is shipping, and what customers are asking for. This server is read-only; it does not create or modify Aha! records.

Note: A single user prompt can trigger one or more tools in sequence. Ensure all tools are imported and available in your project space for prompts to work as expected.

For setup instructions, see SnapLogic MCP Server quickstart.

Example Prompts

What epics are in progress?
Show me the epics on the Platform product assigned to [email protected]
Find epics tagged Q3 in our mobile product
Which epics changed in the last week?
Search our Platform epics for anything about onboarding
What features are shipping in the next release?
List everything in "Under consideration" across all our products
Show me features assigned to me in the Platform product
Find features tagged API in our mobile product
Which features on release REL-42 were updated since Monday?

Tools


Tool Name	Functions
Aha Search Epics	Search Aha! epics by name, status, tag, assignee or recent activity.
Aha Search Features	Search Aha! features by release, product, status, tag, assignee or name.
Aha Search Ideas	Search Aha! ideas by text, status, tag, popularity or submission date.
Aha Search Products	List Aha! products and resolve a product name to the ID the other tools need.

Set up the MCP Server tools

Download aha_tools.zip.
In SnapLogic Designer, open the target project space (or create one), then choose Import Project / Import Pipelines and select the downloaded aha_tools.zip. Designer unpacks each pipeline into the project.
Attach the required account to the connectivity snaps (see Connection Setup).
Expose the project as an MCP server — each pipeline becomes a tool named after its label. New to this? Start with the MCP quickstart, then use the MCP Server Pipeline Builder to generate the server from the imported pipelines.

Configure account

Attach an API Suite account (OAuth 2.0 or Bearer token) to the HTTP Client snap in Designer after import.

These pipelines ship without credentials by design — attach a valid account in Designer before the tools will execute.

See the SnapLogic account documentation for this connector: API Suite Account Configuration.

Important: These pipelines ship without credentials by design — attach a valid account in Designer before the tools will execute. Credentials live in the SnapLogic account store, never in the pipeline JSON.

Aha Search Epics

Search Aha! epics within a product or across your entire organization. Filter by status, tag, assignee, or last-updated date to find active initiatives, track ownership, and see what has changed recently.


Parameter	Type	Default	Description
aha_subdomain*	string	`mycompany`	Your Aha! subdomain, e.g. "mycompany".
product_id	string	—	Aha! product to search within. Required unless workflow_status is set, which searches across all products instead.
q	string	—	Text searched against the epic name.
workflow_status	string	—	Status name such as "In progress". Supplying it switches the search to the organisation-wide /epics endpoint.
tag	string	—	Return only epics carrying this tag.
assigned_to_user	string	—	Assignee to filter by, given as an Aha! user ID or email address.
updated_since	string	—	ISO8601 UTC timestamp; only epics updated at or after this time are returned.
page	integer	`1`	Page number, 1-indexed (default 1).
per_page	integer	`30`	Results per page, max 200 (default 30).

* Required parameter.

Try asking:

What epics are in progress?
Show me the epics on the Platform product assigned to [email protected]
Find epics tagged Q3 in our mobile product
Which epics changed in the last week?
Search our Platform epics for anything about onboarding

Aha Search Features

Search Aha! features by product, release, status, tag, or assignee. Use this tool to find out what is shipping, track the state of work in a release, or identify who is responsible for specific features.


Parameter	Type	Default	Description
aha_subdomain*	string	`mycompany`	Your Aha! subdomain, e.g. "mycompany".
product_id	string	—	Aha! product to search within. Needed unless release_id or workflow_status is supplied.
release_id	string	—	Aha! release to search within. Takes priority over product_id when both are given.
q	string	—	Text searched against the feature name.
workflow_status	string	—	Status name such as "Shipped". Supplying it switches the search to the organisation-wide /features endpoint.
tag	string	—	Return only features carrying this tag.
assigned_to_user	string	—	Assignee to filter by, given as an Aha! user ID or email address.
updated_since	string	—	ISO8601 UTC timestamp; only features updated at or after this time are returned.
page	integer	`1`	Page number, 1-indexed (default 1).
per_page	integer	`30`	Results per page, max 200 (default 30).

* Required parameter.

Try asking:

What features are shipping in the next release?
List everything in "Under consideration" across all our products
Show me features assigned to me in the Platform product
Find features tagged API in our mobile product
Which features on release REL-42 were updated since Monday?
Search the Platform product for features about SSO integration

Aha Search Ideas

Search Aha! ideas by text, status, tag, assignee, or submission date. Sort results by recent, trending, or popular to surface customer demand signals and identify the ideas gaining the most traction.


Parameter	Type	Default	Description
aha_subdomain*	string	`mycompany`	Your Aha! subdomain, e.g. "mycompany".
product_id	string	—	Aha! product to search within. Omit to search ideas across the whole account.
q	string	—	Search text. Matched against the idea name, or against name and description when use_related_search is on.
use_related_search	boolean	`false`	Use the /ideas/related endpoint for deeper full-text search across name and description (default false).
workflow_status	string	—	Status name such as "Under consideration".
tag	string	—	Return only ideas carrying this tag.
assigned_to_user	string	—	Assignee to filter by, given as an Aha! user ID or email address.
sort	string	—	Result ordering: recent, trending or popular.
created_since	string	—	ISO8601 UTC timestamp; only ideas created at or after this time.
created_before	string	—	ISO8601 UTC timestamp; only ideas created before this time.
updated_since	string	—	ISO8601 UTC timestamp; only ideas updated at or after this time.
page	integer	`1`	Page number, 1-indexed (default 1).
per_page	integer	`30`	Results per page, max 200 (default 30).

* Required parameter.

Try asking:

What are the most popular ideas in our Platform product?
Show me ideas submitted this month that are still under review
Do a full-text search of our ideas for anything mentioning single sign-on
What ideas are trending right now?
Find ideas tagged integrations that were created before July
Which ideas have been updated since last Friday, most recent first?

Aha Search Products

List all Aha! products available to your account and look up product IDs. Use this tool first to find the product ID required by the other tools in this server.


Parameter	Type	Default	Description
aha_subdomain*	string	`mycompany`	Your Aha! subdomain, e.g. "mycompany" for mycompany.aha.io.
q	string	—	Text matched case-insensitively against the product name. Applied client-side — every product is still returned, each flagged with matches_query.
updated_since	string	—	ISO8601 UTC timestamp; only products updated at or after this time are returned.
page	integer	`1`	Page number, 1-indexed (default 1).
per_page	integer	`200`	Results per page, max 200 (default 200).

* Required parameter.

Try asking:

What products do we have in Aha?
Find the Aha product for our mobile app
What's the product ID for Platform?
Which Aha products have been updated since the start of the quarter?
List all products and tell me which product line each one belongs to