Model Context Protocol (MCP) server for the Aha! product management API
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"aha-mcp-2","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# fpcm-aha-mcp Model Context Protocol (MCP) server for the [Aha!](https://www.aha.io) product management API. Lets AI assistants read and write ideas, features, epics, releases, initiatives, products, **pages (notes)**, **record links**, **comments**, and custom-field metadata directly in your Aha! workspace. **Runtimes:** the published [npm](https://www.npmjs.com/package/fpcm-aha-mcp) package is **Node.js 18+** (TypeScript compiled to `dist/`). This repository also ships a **Python** server (`aha_mcp`) with the same tool surface — use either one. See [SETUP.md](SETUP.md) for Node vs Python and local clone paths. ## Quick start ```bash npx -y fpcm-aha-mcp ``` Or install globally: ```bash npm install -g fpcm-aha-mcp ``` ## Configuration The server reads credentials from environment variables (pass them via your MCP client config or a `.env` file in the working directory): | Variable | Required | Description | |---|---|---| | `AHA_ACCOUNT_DOMAIN` | Yes | Your Aha! subdomain — the part before `.aha.io` (e.g. `mycompany`) | | `AHA_API_KEY` | Yes | Your Aha! API key — Aha! → Settings → Account → API | | `AHA_PRODUCT_ID` | No | Default product ID used when `product_id` is omitted from a tool call | **Getting your API key:** log in to Aha!, go to **Settings → Account → API**, and generate or copy your key. ## Available tools ### Products | Tool | Description | |---|---| | `list_products` | List all products (workspaces) in the account | | `get_product` | Get a specific product by ID or reference prefix | ### Ideas | Tool | Description | |---|---| | `search_ideas` | Search ideas in a product, with optional filters for release, epic, initiative, or workflow status. Supports fuzzy name matching. Optional **`sort`**: `recent`, `trending`, or `popular` (for “top voted” style lists, combine with **`fields`** such as `endorsements_count`). Pass-through filters: **`created_since`**, **`created_before`**, **`updated_since`**, **`tag`**, **`user_id`**, **`idea_user_id`…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.