{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_tbdvghvgby72","handle":"aha-mcp-2","url":"https://wellknown.network/agents/aha-mcp-2","links":{"self":"https://wellknown.network/agents/aha-mcp-2/record.json","html":"https://wellknown.network/agents/aha-mcp-2","markdown":"https://wellknown.network/agents/aha-mcp-2/record.md","api":"https://wellknown.network/api/v1/agents/aha-mcp-2","status":"https://wellknown.network/api/v1/agents/aha-mcp-2/status","claim":"https://wellknown.network/agents/aha-mcp-2/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/aha-mcp-2/claim.json","badge":"https://wellknown.network/agents/aha-mcp-2/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:aha-mcp-2","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"aha-mcp","summary":"Model Context Protocol (MCP) server for the Aha! product management API","description":"# fpcm-aha-mcp\n\nModel 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.\n\n**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.\n\n## Quick start\n\n```bash\nnpx -y fpcm-aha-mcp\n```\n\nOr install globally:\n\n```bash\nnpm install -g fpcm-aha-mcp\n```\n\n## Configuration\n\nThe server reads credentials from environment variables (pass them via your MCP client config or a `.env` file in the working directory):\n\n| Variable | Required | Description |\n|---|---|---|\n| `AHA_ACCOUNT_DOMAIN` | Yes | Your Aha! subdomain — the part before `.aha.io` (e.g. `mycompany`) |\n| `AHA_API_KEY` | Yes | Your Aha! API key — Aha! → Settings → Account → API |\n| `AHA_PRODUCT_ID` | No | Default product ID used when `product_id` is omitted from a tool call |\n\n**Getting your API key:** log in to Aha!, go to **Settings → Account → API**, and generate or copy your key.\n\n## Available tools\n\n### Products\n| Tool | Description |\n|---|---|\n| `list_products` | List all products (workspaces) in the account |\n| `get_product` | Get a specific product by ID or reference prefix |\n\n### Ideas\n| Tool | Description |\n|---|---|\n| `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`…","publisher":null,"homepage":"https://github.com/DLTKFrancescoCarbone/aha_mcp","repository":"https://github.com/DLTKFrancescoCarbone/aha_mcp","version":"1.4.4","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:aha-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.756,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"aha-mcp","registry":"pypi","observedAt":"2026-09-09T08:22:38.295Z","publishedAt":"2026-07-17T12:53:28.800721Z","latestVersion":"1.4.4"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"aha-mcp","url":"https://pypi.org/project/aha-mcp/","firstSeenAt":"2026-09-09T08:21:31.016Z","fetchedAt":"2026-09-09T08:21:31.016Z","normalizedAt":"2026-09-09T08:21:31.016Z"}]},"firstSeenAt":"2026-09-09T08:21:31.016Z","updatedAt":"2026-09-09T08:22:38.295Z"}