Agile Luminary

by agileluminary

341 downloads
Not rated
GitHub

About

Simpler Project Management - send [Agile Luminary](https://agileluminary.com) stories straight to your IDE

Details

Author
agileluminary
Downloads
341
Categories
Productivity, Project Management, API, Developer Tools, Other

- Retrieves related documents using a text search string
- Fetches currently assigned work items without parameters
- Returns completed work based on search criteria
- Integrates with AI coding assistants like Cursor, Claude, and Windsurf

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Agile Luminary
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Configure the MCP server in your AI IDE (Cursor, Claude, Windsurf) to call its three tools—getRelatedDocuments, getCurrentWork, and getPastWork—which accept a searchString parameter where required and return relevant project data.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "agile luminary": {
            "agile-luminary": {
                "command": "node",
                "args": [
                    "path/to/your/server.js"
                ],
                "env": {
                    "LUMINARY_API_KEY": "your_api_key_here"
                }
            }
        }
    }
}

McpServers

{
    "agile-luminary": {
        "command": "node",
        "args": [
            "path/to/your/server.js"
        ],
        "env": {
            "LUMINARY_API_KEY": "your_api_key_here"
        }
    }
}

Connects AI clients to the Agile Luminary project management system via its REST API.

This is a Model Context Protocol (MCP) server that connects AI clients (like Cursor or Claude Desktop) to the Agile Luminary project management system hosted athttps://agileluminary.com.

The Model Context Protocol (MCP) is a standardized way for AI applications to connect to external data sources and services. This server acts as a bridge between your AI client and the Agile Luminary REST API, allowing you to retrieve project details, work assignments, and documentation directly within your AI conversations.

AI Client (Cursor/Claude) → Local MCP Server → Agile Luminary API (localhost:5006)

This MCP server provides three main tools that fetch data from the Agile Luminary API:

- Purpose: Retrieve related documents based on a search string
- Parameters:searchString(required) - The text to search for in documents
- Use Case: Find relevant documentation and specifications related to your current work

- Purpose: Fetches work currently assigned to the user
- Parameters: None
- Use Case: See what tasks and user stories are actively assigned to you

- Purpose: Retrieves completed work related to user stories based on search criteria
- Parameters:searchString(required) - Search term to find relevant past work
- Use Case: Review historical context and completed tasks for better decision-making

- Node.js (v16 or higher)
- An AI client that supports MCP (Cursor IDE, Claude Desktop, etc.)

npm install @modelcontextprotocol/sdk zod

Set your API key as an environment variable:

export LUMINARY_API_KEY=your_api_key_here

The server will start and listen for connections from your AI client via stdio transport.

{ "mcpServers": { "agile-luminary": { "command": "node", "args": ["path/to/your/server.js"], "env": { "LUMINARY_API_KEY": "your_api_key_here" } } } }

Add this to yourclaude_desktop_config.json:

{ "mcpServers": { "agile-luminary": { "command": "node", "args": ["path/to/your/server.js"], "env": { "LUMINARY_API_KEY": "your_api_key_here" } } } }

Once connected, you can use natural language in your AI client:

- "Search for documents about authentication"
- "Show me my current work assignments"
- "Find past work related to user login functionality"
- "What documentation exists about the payment system?"
- "Based on my current work, what similar tasks were completed before?"

The server connects to the following Agile Luminary API endpoints:

- POST http://localhost:5006/bend/mcp/documents/search- Search documents
- GET http://localhost:5006/bend/mcp/userstories/current- Get current work
- POST http://localhost:5006/bend/mcp/userstories/search- Search past work

- Real-time Data: Always get the latest project information from your deployed system
- Context-Aware AI: Your AI assistant has full context of your project status and documentation
- Seamless Integration: Works directly within your development environment
- Secure: Server handles authentication and API communication locally
- Search Capabilities: Find relevant documents and past work through intelligent search

The server uses theLUMINARY_API_KEYenvironment variable for authentication. This key is passed in theAuthorizationheader for all API requests. Make sure to set this environment variable before running the server.

The server includes comprehensive error handling for:

- Network connectivity issues
- API authentication failures
- Malformed responses
- Service unavailability
- Missing API keys

This MCP server is designed to work specifically with the Agile Luminary project management system. For modifications or enhancements, ensure compatibility with the existing API endpoints.

Note: Make sure your Agile Luminary account is created and you have your API key fromhttps://agileluminary.combefore using this MCP server. Set theLUMINARY_API_KEYenvironment variable with your API key.

Integrates with the Backlog API to manage projects and issues.

Interact with the Backlog API to manage projects, issues, wikis, git repositories, and more.

An MCP server for interacting with the Backlog API, a project management and collaboration tool.

Integrate with the Goodday project management platform to manage projects, tasks, and users via its API.

Manage time tracking, projects, clients, and tasks using the Harvest API.

Provides comprehensive project management context to AI agents using the Helios-9 API.

Integrates with Jira's REST API to manage issues programmatically.

An API integration for the Zentao project management system, supporting task management and bug tracking.

Access the Miro REST API v2 for managing boards, creating content, and collaborating.

Integrates with the Productboard API, offering 49 specialized tools to manage all major Productboard functionalities.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.