Skip to main content
Glama

Aha! MCP Server

by aakashrshah

Aha! MCP Server - Python FastMCP Implementation

A Python-based MCP server for interacting with Aha! API using FastMCP with HTTP streaming capabilities.

Features

  • HTTP Streaming: Built with FastMCP for efficient HTTP streaming
  • GraphQL Integration: Uses GraphQL to query Aha! API
  • Three Main Tools:
    • get_record: Get features or requirements by reference number
    • get_page: Get pages with optional parent relationships
    • search_documents: Search for Aha! documents

Environment Variables

  • AHA_API_TOKEN: Your Aha! API token (required)
  • AHA_DOMAIN: Your Aha! domain name (required)
  • PORT: Server port (default: 9004)

Installation

pip install -r requirements.txt

Running

Local Development

# Set environment variables export AHA_API_TOKEN="your_token_here" export AHA_DOMAIN="your_domain_here" # Run with HTTP streaming (default) python main.py # Or run with stdio transport python main.py --transport stdio

Docker

# Build the image docker build -t aha-mcp . # Run the container docker run -e AHA_API_TOKEN="your_token_here" -e AHA_DOMAIN="your_domain_here" -p 9004:9004 aha-mcp

Tools

get_record

Get an Aha! feature or requirement by reference number.

  • Input: reference (string) - e.g., "DEVELOP-123" or "ADT-123-1"
  • Output: JSON with name and description

get_page

Get an Aha! page by reference number with optional relationships.

  • Input:
    • reference (string) - e.g., "ABC-N-213"
    • include_parent (boolean, optional) - Include parent page
  • Output: JSON with page details, children, and optional parent

search_documents

Search for Aha! documents.

  • Input:
    • query (string) - Search query
    • searchable_type (string, optional) - Document type (default: "Page")
  • Output: JSON with search results and pagination info

Architecture

  • server.py: Main FastMCP server with tool definitions
  • handlers.py: Business logic for handling each tool
  • queries.py: GraphQL queries for Aha! API
  • types.py: Python dataclasses for type safety
  • main.py: Entry point for running the server

Inspired from https://github.com/aha-develop/aha-mcp

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables interaction with Aha! product management platform through GraphQL API. Supports retrieving features, requirements, and pages by reference number, as well as searching documents across Aha! workspaces.

  1. Features
    1. Environment Variables
      1. Installation
        1. Running
          1. Local Development
          2. Docker
        2. Tools
          1. get_record
          2. get_page
          3. search_documents
        3. Architecture

          Related MCP Servers

          • A
            security
            A
            license
            A
            quality
            Enables interaction with Shopify store data using the GraphQL API, supporting product, customer, and order management with comprehensive error handling.
            Last updated -
            15
            761
            11
            TypeScript
            MIT License
          • A
            security
            A
            license
            A
            quality
            Enables interaction with Shopify store data via GraphQL API, providing tools for managing products, customers, orders, discounts, and more with robust error handling.
            Last updated -
            15
            761
            30
            TypeScript
            MIT License
          • -
            security
            A
            license
            -
            quality
            Enables interaction with Shopify stores through GraphQL API, providing tools for managing products, customers, orders, and more.
            Last updated -
            761
            8
            TypeScript
            MIT License
          • A
            security
            A
            license
            A
            quality
            Enables interaction with Shopify store data through GraphQL API, providing tools for managing products, customers, orders, blogs, and articles.
            Last updated -
            15
            115
            2
            TypeScript
            MIT License
            • Apple

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/aakashrshah/aha-mcpy'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server