Skip to main content
Glama
evergreen-ci

evergreen-mcp-server

Official
by evergreen-ci

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
EVERGREEN_USERNoUsername for API key authentication
SENTRY_ENABLEDNoEnable/disable Sentry telemetrytrue
WORKSPACE_PATHNoWorkspace directory for project auto-detection
EVERGREEN_API_KEYNoAPI key for authentication
EVERGREEN_PROJECTNoDefault project identifier
EVERGREEN_MCP_HOSTNoHTTP host binding for SSE/HTTP transports127.0.0.1
EVERGREEN_MCP_PORTNoHTTP port for SSE/HTTP transports8000
EVERGREEN_API_SERVERNoAPI server URL (advanced)
EVERGREEN_MCP_TRANSPORTNoTransport protocol (stdio, sse, streamable-http)stdio
EVERGREEN_OIDC_REST_URLNoOverride REST base URL for OIDC auth
EVERGREEN_API_KEY_REST_URLNoOverride REST base URL for API key auth
EVERGREEN_OIDC_GRAPHQL_URLNoOverride GraphQL endpoint URL for OIDC auth
EVERGREEN_API_KEY_GRAPHQL_URLNoOverride GraphQL endpoint URL for API key auth

Capabilities

Features and capabilities supported by this server

CapabilityDetails
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

NameDescription
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

NameDescription
intelligent-project-detectionHow to use intelligent project ID auto-detection in Evergreen tools
debug-failed-patchStep-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-statusQuick 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

NameDescription
list_projects_resourceList all Evergreen projects as a resource.
evergreen-concepts/SKILL.mdEssential 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/_manifestFile listing for evergreen-concepts
tool-guide/SKILL.mdComplete 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/_manifestFile listing for tool-guide
debugging-workflow/SKILL.mdStep-by-step workflows for debugging CI/CD failures in Evergreen — from identifying a failing patch to diagnosing root cause.
debugging-workflow/_manifestFile listing for debugging-workflow

Latest Blog Posts

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