Agile Luminary MCP Server

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 at https://agileluminary.com.

What is MCP?

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.

Architecture

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

Features

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

📋 getCurrentWork

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

🔍 getPastWork

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

Installation & Setup

Prerequisites

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

Install Dependencies

npm install @modelcontextprotocol/sdk zod

Environment Variables

Set your API key as an environment variable:

export LUMINARY_API_KEY=your_api_key_here

Run the Server

node server.js

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

Configuration

For Cursor IDE

Add this to your MCP configuration:

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

For Claude Desktop

Add this to your claude_desktop_config.json:

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

Usage Examples

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?"

API Endpoints

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

Benefits

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

Authentication

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

Error Handling

The server includes comprehensive error handling for:

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

Contributing

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 from https://agileluminary.com before using this MCP server. Set the LUMINARY_API_KEY environment variable with your API key.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

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.

A Model Context Protocol server that connects AI clients to the Agile Luminary project management system, allowing users to retrieve project details, work assignments, and product information within AI conversations.

Related MCP Servers

Illumio MCP Server
alexgoller
A
security
F
license
A
quality
A Model Context Protocol server that enables conversational AI interaction with Illumio PCE for security policy management, workload operations, traffic flow analysis, and compliance assessment.
Last updated -
23
1
Python
Linear MCP Server
vinayak-mehta
A
security
A
license
A
quality
A Model Context Protocol server that integrates with Linear, enabling AI assistants to create, update, search, and comment on issues for project management and issue tracking.
Last updated -
5
6
Python
Apache 2.0
MCP Linear App
zalab-inc
-
security
F
license
-
quality
A server that enables AI assistants to interact with Linear's project management tools through the Model Context Protocol, supporting features like searching, creating, and updating issues, adding comments, and retrieving user profiles and team information.
Last updated -
TypeScript
Linear MCP Server
emmett-deen
-
security
-
license
-
quality
A Model Context Protocol server implementation that enables AI assistants to interact with Linear project management systems, allowing them to create, retrieve, and modify data related to issues, projects, teams, and users.
Last updated -
20
2
TypeScript

View all related MCP servers

Agile Luminary MCP Server