The Freshrelease MCP Server enables AI models to interact with Freshrelease for comprehensive project, task, and test case management through its API.
Project and Task Management: Create, retrieve, and list projects and tasks with support for descriptions, assignees, due dates, and issue types using tools like
fr_create_project,fr_get_project,fr_create_task,fr_get_task, andfr_get_all_tasks.Smart Name Resolution: Automatically convert human-readable names (user emails, issue types, statuses, sprints, releases, project keys) to their corresponding Freshrelease IDs, with custom field detection and prefixing.
Test Case Management: List, retrieve, filter, and link test cases to issues with hierarchical section support and bulk operations using
fr_list_testcases,fr_get_testcase, andfr_link_testcase_issues.Advanced Filtering: Filter tasks and test cases using various criteria including standard and custom fields, with automatic name-to-ID resolution via
fr_filter_tasksandfr_filter_testcases.User and Entity Lookups: Search for users by name or email, resolve issue types, and retrieve IDs for sprints, releases, tags, and subprojects within projects.
Filter Persistence: Save and reuse custom filters using
fr_save_filterwith query hashes from filtering operations.Cache Management: Clear internal caches for custom fields, lookup data, name-to-ID resolution, and test case forms to refresh data without server restart.
Performance Monitoring: Track and reset performance statistics for monitored functions with
fr_get_performance_statsandfr_clear_performance_stats.HTTP Client Management: Properly close HTTP connections with
fr_close_http_clientfor cleanup.
Mentioned as the distribution platform where the MCP server package can be fetched and run using uvx
Freshrelease MCP Server
An MCP server that enables AI models to interact with Freshrelease through powerful tools for complete project and test management.
🚀 Key Features
🤖 AI-Native: Built specifically for AI model integration via MCP protocol
🔧 Complete Management: Projects, tasks, test cases, test runs, and user management
🧠 Smart Resolution: Automatically converts names to IDs (users, sprints, projects, etc.)
📋 Native Filtering: Full support for Freshrelease's native query_hash format
🌲 Hierarchical Navigation: Navigate through 7-level deep section hierarchies
⚡ Performance Optimized: Built-in caching, connection pooling, and batch processing
🎯 Label-Based Filtering: Use intuitive field names like "Owner" instead of "owner_id"
📊 Tools Overview
Category | Key Features |
Core Management | Projects, tasks, users, and issue types |
Test Management | Test cases, test runs, and execution tracking |
Smart Filtering | Advanced task and test case filtering |
Lookup & Utilities | Name-to-ID resolution and cache management |
🛠️ Available Tools
Core Management
Tool | Purpose | Key Parameters |
| Get project details |
|
| Create new tasks/issues |
,
,
,
|
| Get task by ID/key |
,
|
| List all project tasks |
|
| Resolve issue type names |
|
| Get form fields for issue types |
|
| Find users by name/email |
|
Test Management
Tool | Purpose | Key Parameters |
| List all test cases |
|
| Get specific test case |
|
| Get tests by section |
|
| Link tests to issues |
,
|
| Advanced test filtering |
|
| Add tests to run |
,
|
| Get test run insights |
|
Smart Filtering
Tool | Purpose | Key Parameters |
| Advanced task filtering with native query_hash |
,
,
, pagination |
| Save reusable filters |
,
|
| Get issue form schema |
|
| Get test form schema | - |
| Get all form schemas | - |
Lookup & Utilities
Tool | Purpose | Key Parameters |
| Find sprint by name |
|
| Find release by name |
|
| Find tag by name |
|
| Get active sub-project sprint |
|
| Resolve sub-project names |
|
| Clear filter cache | - |
| Clear all caches | - |
✨ Smart Features
🧠 Name-to-ID Resolution: Converts user names, sprint names, issue types, etc. to IDs automatically
📋 Native Query Format: Full support for Freshrelease's
query_hashformat with all operators🌲 Hierarchical Sections: Navigate up to 7 levels deep section hierarchies (e.g.,
"Level1 > Level2 > Level3")🔄 API Compatibility: Handles both nested
{"users": [...]}and direct array response formats⚡ Performance Optimized: Multi-level caching, connection pooling, optimized batch processing
🔗 Flexible Project IDs: Accept both project keys (
"FS") and numeric IDs (123)🎯 Custom Field Support: Auto-detects and handles custom fields with "cf_" prefixing
📊 Multiple Query Formats: Native query_hash, comma-separated strings, or JSON objects
🚀 Quick Start
1. Install
2. Get Credentials
API Key: Freshrelease → Profile → API Key
Domain:
company.freshrelease.com(your domain)Project Key: e.g.,
"FS","PROJ"(optional)
3. Configure Cursor
Add to ~/.cursor/mcp.json:
4. Restart Cursor
✅ You'll see Freshrelease tools available!
💡 Usage Examples
🎯 Create & Manage Tasks
Ask AI to create a bug report:
"Create a bug ticket titled 'Fix login issue' in the FS project, assign it to john@example.com, and set the status to In Progress"
The AI will automatically:
Find your FS project
Convert "john@example.com" to the correct user ID
Set the issue type as "Bug"
Resolve "In Progress" to the proper status ID
Get project overview:
"Show me all tasks in the FS project"
📋 Advanced Task Filtering
Use natural language filtering:
"Find all high priority tasks owned by John Doe that are currently in progress"
The AI understands both:
Friendly labels: "Owner", "Status", "Priority"
Technical names: "owner_id", "status_id", "priority_id"
Native Freshrelease filtering:
"Filter tasks using saved filter ID 102776 with custom fields and date ranges"
Sprint and date-based filtering:
"Show me all bugs in Sprint 1 created between Dec 2024 and Aug 2025"
🧪 Test Case Management
Filter test cases naturally:
"Find all high and medium severity functional tests in the Authentication section"
Navigate hierarchical sections:
"Get all test cases from Authentication > Login Tests > Positive Cases section"
The AI can navigate up to 7 levels deep in section hierarchies automatically.
Get test run insights:
"How is test run 150183 performing?"
Response example: "Test run has 8 total tests, all 8 passed successfully. Great job!"
🆕 Latest Updates
v1.7.6 - Enhanced Filtering & Navigation
✅ Native Query Support: Full
query_hashformat support with all Freshrelease operators✅ Optimized Performance: 42% code reduction with improved section hierarchy navigation
✅ Enhanced API Compatibility: Handles both nested
{"users": [...]}and direct array responses✅ Advanced Pagination: Support for
filter_id,include,page,per_page, and sorting✅ 7-Level Hierarchies: Navigate deep section structures like
"ESM > Account Clone > Sub-section"
v1.7.5 - Documentation & UX
✅ Human-Readable Examples: Conversational prompts instead of technical function calls
✅ Streamlined README: Removed counts, improved organization and clarity
🔧 Troubleshooting
Not seeing tools in Cursor?
Check
~/.cursor/mcp.jsonis valid JSONRestart Cursor completely
Verify credentials:
uvx freshrelease-mcp --help
Environment Variables:
📄 License
MIT License - see LICENSE file for details.
⭐ Like this project? Give it a star on GitHub!
🐛 Found a bug? Open an issue
💡 Have ideas? Start a discussion
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.
Tools
Enables AI models to interact with Freshrelease project management platform through API integration. Supports creating and retrieving projects and tasks, managing status categories, and automating project operations through natural language.