evergreen-mcp-server
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| EVERGREEN_USER | No | Username for API key authentication | |
| SENTRY_ENABLED | No | Enable/disable Sentry telemetry | true |
| WORKSPACE_PATH | No | Workspace directory for project auto-detection | |
| EVERGREEN_API_KEY | No | API key for authentication | |
| EVERGREEN_PROJECT | No | Default project identifier | |
| EVERGREEN_MCP_HOST | No | HTTP host binding for SSE/HTTP transports | 127.0.0.1 |
| EVERGREEN_MCP_PORT | No | HTTP port for SSE/HTTP transports | 8000 |
| EVERGREEN_API_SERVER | No | API server URL (advanced) | |
| EVERGREEN_MCP_TRANSPORT | No | Transport protocol (stdio, sse, streamable-http) | stdio |
| EVERGREEN_OIDC_REST_URL | No | Override REST base URL for OIDC auth | |
| EVERGREEN_API_KEY_REST_URL | No | Override REST base URL for API key auth | |
| EVERGREEN_OIDC_GRAPHQL_URL | No | Override GraphQL endpoint URL for OIDC auth | |
| EVERGREEN_API_KEY_GRAPHQL_URL | No | Override GraphQL endpoint URL for API key auth |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_user_recent_patches_evergreenA | Retrieve the authenticated user's recent Evergreen patches/commits with their CI/CD status. Use this to see your recent code changes, check patch status (success/failed/running), and identify patches that need attention. Returns patch IDs needed for other tools. If project_id is not specified, will automatically detect it from your workspace directory and recent patch activity.This tool may return a list of available project_ids if it cannot determine the project_id automatically.You should ask the user which project they want to use, then call this tool again with the project_id parameter set to their choice. |
| get_patch_failed_jobs_evergreenA | Analyze failed CI/CD jobs for a specific patch to understand why builds are failing. Shows detailed failure information including failed tasks, build variants, timeout issues, log links, and test failure counts. Essential for debugging patch failures. If project_id is not specified, will automatically detect it from your workspace directory and recent patch activity.This tool may return a list of available project_ids if it cannot determine the project_id automatically.You should ask the user which project they want to use, then call this tool again with the project_id parameter set to their choice. |
| get_task_log_summaryA | Get a truncated view of task logs via GraphQL. Returns log metadata and filtered error/failure messages, but only captures a limited portion of the full log (mostly test log ingestion messages). For complete raw task logs including timeout output, process dumps, and full execution logs, use get_task_log_detailed instead. Use task_id from get_patch_failed_jobs results. |
| get_test_results_summaryA | Get test result metadata via GraphQL. Returns test names, pass/fail statuses, durations, and Parsley log viewer URLs — but not the actual error messages from test output. For the raw test log content with error pattern analysis, use get_test_results_detailed instead. Use task_id from get_patch_failed_jobs results. |
| get_inferred_project_ids_evergreenA | Get a list of unique project identifiers inferred from the user's recent patches. This helps discover which Evergreen projects the user has been working on, sorted by activity (patch count and recency). Useful for understanding project context and filtering other queries. |
| get_task_log_detailedA | Get the complete raw task logs via REST API. Returns the full untruncated task execution log including timeout handler output, process dumps, and stdout/stderr — content that the GraphQL get_task_log_summary tool cannot access. Automatically scans for error patterns and returns a structured summary with top error terms and example lines when errors are found. Best for debugging non-test failures (setup errors, timeouts, compilation failures). Use task_id from get_patch_failed_jobs results. |
| get_test_results_detailedA | Get raw test log content via REST API. Fetches actual test output (stored in S3, not accessible via GraphQL). Automatically scans for error patterns and returns a structured summary with top error terms and example lines when errors are found. Use this to understand WHY a test failed, not just that it failed. Requires task_id and test_name from get_patch_failed_jobs results. |
| download_task_artifacts_evergreenA | Download artifacts from a specific Evergreen task. Use this to retrieve build outputs, test results, logs, or other files generated by a task. Artifacts are downloaded to a local directory structure organized by version. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| intelligent-project-detection | How to use intelligent project ID auto-detection in Evergreen tools |
| debug-failed-patch | Step-by-step guide to investigate a failing CI patch. Use when the user says 'why is my patch failing?' or 'debug my CI'. |
| check-ci-status | Quick CI health check. Use when the user asks 'how is my CI?' or 'check my builds'. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| list_projects_resource | List all Evergreen projects as a resource. |
| evergreen-concepts/SKILL.md | Essential Evergreen CI/CD domain knowledge — hierarchy, terminology, statuses, and how the system works. Read this to understand the data returned by Evergreen tools. |
| evergreen-concepts/_manifest | File listing for evergreen-concepts |
| tool-guide/SKILL.md | Complete reference for every Evergreen MCP tool — what it does, when to use it, parameters, return values, and how results chain into other tools. |
| tool-guide/_manifest | File listing for tool-guide |
| debugging-workflow/SKILL.md | Step-by-step workflows for debugging CI/CD failures in Evergreen — from identifying a failing patch to diagnosing root cause. |
| debugging-workflow/_manifest | File listing for debugging-workflow |
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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/evergreen-ci/evergreen-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server